Claude Skills nasıl çalışır
Skill kavramını hiç duymamış biri için, baştan sona.
Skill nedir?
Bir skill, Claude'a belirli bir iş için nasıl davranacağını öğreten talimat paketidir. En basit hâliyle bir SKILL.md dosyasıdır: üstte kısa bir tanıtım (frontmatter), altında Markdown ile yazılmış süreç.
Prompt ile farkı kalıcılıktır. Prompt tek konuşmalıktır; skill dosyada durur, ilgili iş geldiğinde devreye girer ve her seferinde aynı standardı uygular.
Üç adımda özet: 01 Tanımla — skill'in amacı, süreci ve yasakları yazılır. 02 Etkinleş — Claude, gelen isteği skill'in açıklamasıyla eşleştirir ve dosyayı okur. 03 Yürüt — skill, Claude'un o görevdeki yaklaşımını ve adım sırasını yönlendirir.
Dosya yapısı
master-blog/ SKILL.md references/
| Öğe | Zorunlu | Ne işe yarar |
|---|---|---|
| SKILL.md | Evet | Frontmatter + sürecin kendisi |
| name | Evet | kebab-case; dizin adıyla aynı olmalı |
| description | Evet | En kritik alan: ne yaptığı ve ne zaman kullanılacağı |
| argument-hint | Hayır | Slash komutu olarak çağrıldığında beklenen argüman |
| references/ | Hayır | Yalnızca gerektiğinde okunan derin referanslar |
| scripts/ | Hayır | Çalıştırılabilir yardımcılar (ör. kelime sayacı) |
Nasıl yükleniyor?
Skill'in tamamı her zaman bellekte durmaz. Kademeli açılım şöyle işler:
- Her zaman yüklü: yalnızca
namevedescription. Birkaç yüz token. - Eşleşince yüklenir: iş, açıklamayla örtüştüğünde
SKILL.mdgövdesi okunur. - Gerektiğinde açılır:
references/altındaki dosyalar ancak o adımda okunur.
Bu yüzden iyi skill tasarımı "her şeyi ana dosyaya yaz" değil, "hangi bilginin ne zaman gerektiğini tasarla"dır.
İyi bir skill neye benzer?
- Açıklaması tetikleyicidir. "Blog yazar" değil; hangi cümlelerde devreye gireceğini ve hangi durumda devreye girmeyeceğini söyler.
- Eşikleri sayıdır. "Çok benzerse" değil, "örtüşme %50 ve üzeriyse".
- Kapıları vardır. Atlanamaz adımlar açıkça işaretlenir.
- Yasakları yazılıdır. Ne yapmayacağı, ne yapacağı kadar nettir.
- Örnek verir. Üslup kuralla değil, zayıf/güçlü karşılaştırmasıyla aktarılır.
- Bölünmüştür. Uzun listeler referans dosyalarına taşınır.
Sınırlar
Skill sihir değildir. Model yine model olarak kalır: bilgi kesim tarihi vardır, halüsinasyon üretebilir, araç çıktısını yanlış okuyabilir. Skill'in yaptığı şey, hata yapma olasılığı yüksek yerlere kontrol koymaktır — doğrulama adımı, sayısal eşik, insan onayı.
Bu yüzden bu skill "sıralama garantisi" gibi ölçülemeyen bir vaat vermez; yalnızca sürecin tekrarlanabilir ve denetlenebilir olmasını sağlar.