Skill
Claude'a belirli bir iş için nasıl davranacağını öğreten, isteğe bağlı olarak yüklenen talimat paketidir. En basit hâliyle bir `SKILL.md` dosyasıdır.
Bir skill, Claude'a verilmiş "iş başı eğitimi"dir.
Normalde Claude'dan blog yazmasını istediğinde genel bilgisiyle yazar. Bir blog skill'i yüklediğinde ise senin süreçlerini bilir: önce hangi veriye bakacağını, hangi kontrolü atlamayacağını, hangi formatta yazacağını, neyi asla yapmayacağını.
Fark şu: promptta her seferinde 40 maddelik talimatı tekrar yazmazsın. Skill dosyada durur, ilgili iş geldiğinde devreye girer.
Skill, YAML frontmatter + Markdown gövdeden oluşan bir dizin paketidir.
master-blog/ SKILL.md ← zorunlu: frontmatter + talimatlar references/*.md ← isteğe bağlı: derin referanslar scripts/*.py ← isteğe bağlı: çalıştırılabilir yardımcılar
Frontmatter alanları:
name— kebab-case, dizin adıyla aynı olmalı.description— en kritik alan. Claude bir skill'i yükleyip yüklemeyeceğine buna bakarak karar verir. Ne yaptığını VE ne zaman kullanılacağını içermeli; ayrıca ne zaman kullanılmayacağını yazmak yanlış tetiklenmeyi azaltır.argument-hint— slash komutu olarak çağrıldığında beklenen argüman.allowed-tools/disallowed-tools— araç kısıtı (ör. denetim skill'indeWritekapatılır).
Yükleme mekaniği (progressive disclosure): Başlangıçta yalnızca isim ve açıklama bağlama girer. İş açıklamayla eşleşince tam SKILL.md okunur. Referans dosyaları ise ancak gerektiğinde açılır. Bu yüzden ana dosyayı şişirmek yerine referanslara bölmek doğru tasarımdır.
Kurulum yerleri (Claude Code):
~/.claude/skills/<ad>/SKILL.md— kişisel, tüm projelerde geçerli.<proje>/.claude/skills/<ad>/SKILL.md— projeye özel, ekiple paylaşılır.
Skill'ler, tek seferlik prompt ile tekrarlanabilir süreç arasındaki farktır. İyi bir prompt bir kez iyi sonuç verir; iyi bir skill her seferinde aynı standardı üretir. Kalite kontrolü, yasaklar ve eşik değerleri promptta unutulur, skill'de kalıcıdır.
Kötü açıklama: description: "Blog yazar." → Claude ne zaman kullanacağını bilemez, ya hiç tetiklenmez ya da her yazma isteğinde tetiklenir.
İyi açıklama: description: "Web projeleri için SEO/GEO uyumlu blog yazısı üretir; yazmadan önce kanibalizasyon denetimi yapar... Şu isteklerde kullan: 'blog yazalım', 'yeni içerik ekle'. Sadece denetim istendiğinde bunu değil seo-denetim skill'ini kullan."
"Skill = prompt." Değil. Prompt tek konuşmalık girdi, skill kalıcı ve koşullu yüklenen bir yetenektir. "Ne kadar uzunsa o kadar iyi." Değil — bağlam maliyeti gerçektir; ana dosya odaklı olmalı, derinlik referanslara taşınmalıdır.