Claude · Gelişmiş · 202 Genişlet · Konu 1 / 5
4.1 Skills
Aynı talimatı her seferinde yapıştırma, bir kez yaz.
Bu sayfada ne öğreneceksin
- Skill'in ne olduğunu,
SKILL.mddosyasının nasıl yazıldığını ve nereye konduğunu - Skill'in ne zaman çalıştığını ve çalışmadığında nereye bakacağını
- Skill ile CLAUDE.md, slash komutu, subagent ve hook arasındaki farkı
Kısaca
Her toplantı özetinde, her commit mesajında, her kod incelemesinde aynı talimatı yeniden yazıyorsan skill tam bunun için var. Skill, Claude Code'a bir işi nasıl yapacağını bir kez anlatan Markdown dosyasıdır. Dokümana göre içinde SKILL.md bulunan bir klasör açarsın, Claude onu araç setine ekler. Claude ilgili gördüğünde kendisi kullanır ya da sen /skill-adi yazarak doğrudan çağırırsın.
Kurs ile doküman aynı ayrımı yapıyor: CLAUDE.md her oturumda yüklenir, skill ise yalnızca gerektiğinde. Claude başta sadece skill'in adını ve açıklamasını (description) bilir. İşin skill'e uyduğuna karar verince dosyanın tamamını okur. Böylece uzun bir kontrol listesi, sen onu istemeden bağlamını doldurmaz.
Basit kural: Claude'a aynı şeyi tekrar tekrar anlatıyorsan, ya da CLAUDE.md'nin bir bölümü olgudan çok bir prosedüre dönmüşse, onu skill yap.
Adım adım
- Tekrar eden talimatı seç. Son günlerde Claude'a kaç kez aynı şeyi yazdığına bak (toplantı özeti biçimi, commit mesajı düzeni, inceleme listesi). Bu sayfadaki örnek kurgusal bir toplantı özeti skill'idir.
- Nereye kaydedeceğine karar ver. Kişisel skill
~/.claude/skills/<skill-adi>/SKILL.mdyoluna gider ve bu bilgisayardaki tüm projelerinde geçerlidir. Proje skill'i.claude/skills/<skill-adi>/SKILL.mdyoluna gider; commit edersen depoyu alan herkes onu da alır. - Klasörü aç. Aşağıdaki "Hazır komutlar" bölümündeki
mkdirkomutunu terminalde çalıştır. Beklenen sonuç:~/.claude/skills/toplanti-ozetiklasörü. SKILL.mddosyasını yaz. Dosyanın adı tam olarakSKILL.mdolmalı ve klasörün içinde durmalı. İlk satır---olmalı; arasına YAML alanlarını, altına talimatı yaz. Örnek dosya aşağıda.- Description'ı iyi yaz. Kurs iki soruya cevap vermesini istiyor: skill ne yapar, Claude ne zaman kullanmalı. Kullanıcının gerçekten yazacağı kelimeleri koy; Claude eşleşmeyi bu metne bakarak yapar.
- Yüklendi mi bak. Çalışan Claude Code oturumuna "What skills are available?" diye sor ya da
/skillsyaz. Dokümana göre Claude Code skill klasörlerini izler; var olan bir klasördeki değişikliği oturumu yeniden başlatmadan alır. Oturum başladığında olmayan en üst düzey skills klasörünü sonradan oluşturduysan/reload-skillsçalıştır. - İki yoldan dene. Önce Claude'un kendisi bulsun: açıklamaya uyan bir istek yaz. Sonra doğrudan çağır:
/toplanti-ozeti. Mesajın başında yazdığın/skill-adiskill'i doğrudan çalıştırır. - Gerekirse sertleştir. Skill'i yalnızca sen çağırmak istiyorsan frontmatter'a
disable-model-invocation: trueekle. Skill içindeki her şeyin sürekli uygulanmasını istiyorsan "Sık yapılan hata" bölümüne bak.
SKILL.md nasıl görünür
Dosya iki parçadır: --- işaretleri arasında YAML alanları (frontmatter), altında Claude'a verilen talimat. Dokümana göre tüm alanlar isteğe bağlıdır, yalnızca description önerilir. Alan adı tablodakiyle birebir aynı olmalı: Claude Code tanımadığı alanı hata vermeden yok sayar.
| Alan | Ne işe yarar |
|---|---|
name | Komut adı; verilmezse klasör adı kullanılır |
description | Skill ne yapar ve ne zaman kullanılır; Claude eşleşmeyi buna bakarak yapar |
when_to_use | Tetikleyici cümleler gibi ek bilgi; description'a eklenir |
disable-model-invocation | true ise Claude skill'i kendiliğinden yüklemez; yalnızca sen /ad ile çağırırsın |
user-invocable | false ise yalnızca Claude çağırabilir; / menüsünde görünmez |
allowed-tools | Skill'i çağıran turda, listelenen araçlar izin sorulmadan kullanılır |
model | Skill etkinken kullanılacak model |
context | fork yazılırsa skill ayrı bir subagent bağlamında çalışır |
paths | Skill'in yalnızca belirli dosya kalıplarıyla çalışırken otomatik yüklenmesini sınırlar |
Alanların tam listesi (arguments, hooks, effort ve diğerleri) dokümanın skills sayfasındaki "Frontmatter reference" bölümündedir. Kurgusal toplantı özeti skill'i aşağıda.
Skill ne zaman çalışır
Varsayılan olarak hem sen hem Claude skill'i çağırabilir. Description her zaman bağlamdadır; tam içerik skill çağrıldığında yüklenir. Üç durum:
| Frontmatter | Sen çağırabilir misin | Claude kendiliğinden çağırabilir mi |
|---|---|---|
| (varsayılan) | Evet | Evet |
disable-model-invocation: true | Evet | Hayır |
user-invocable: false | Hayır | Evet |
Dokümanın önerisi: yan etkisi olan ya da zamanlamasını senin seçmek istediğin işler (commit atmak, deploy etmek, mesaj göndermek) için disable-model-invocation: true kullan. Kodun hazır görünüyor diye Claude'un kendi kararıyla deploy etmesini istemezsin.
Bir skill çağrılınca içeriği konuşmaya tek mesaj olarak girer ve sonraki turlarda da orada kalır. Doküman bu yüzden kalıcı olması gereken yönergeyi "her düzenlemeden sonra testleri çalıştır" gibi tüm işe uygulanacak biçimde yazmanı söylüyor. Konuşma sıkıştırılırsa skill'in yalnızca baş kısmı korunabilir; en önemli talimatları dosyanın başına koy.
Çok dosyalı skill
Skill bir klasördür; yanında başka dosyalar durabilir. Böylece SKILL.md özet ve yönlendirme olarak kısa kalır, ayrıntılı kaynak yalnızca gerektiğinde okunur. Dokümandaki yapı:
my-skill/
├── SKILL.md (required - overview and navigation)
├── reference.md (detailed API docs - loaded when needed)
├── examples.md (usage examples - loaded when needed)
└── scripts/
└── helper.py (utility script - executed, not loaded)
Destek dosyalarını SKILL.md içinden anlat ki Claude hangisini ne zaman açacağını bilsin. Kurs betikler için bir ayrıntı veriyor: betik çalıştırılır, içeriği bağlama yüklenmez; yalnızca çıktısı yer kaplar. Bu yüzden SKILL.md'ye betiği okuma, çalıştır diye yaz. SKILL.md'yi kısa tut; dokümandaki sınırı kendi sayfasından oku.
Skill ile diğer özellikler
| Özellik | Ne zaman yüklenir, ne yapar | Ne için kullan |
|---|---|---|
| CLAUDE.md | Her konuşmada yüklenir | Her zaman geçerli proje kuralları |
| Skill | İstek eşleşince yüklenir, bilgiyi mevcut konuşmaya katar | Göreve özgü uzmanlık ve prosedür |
| Slash komutu | Yazarak çağırırsın | Tam zamanını senin seçtiğin iş |
| Subagent | Ayrı bağlamda çalışır, sonuç döner | Devredilen iş, ayrı araç erişimi, ana bağlamdan yalıtım |
| Hook | Bir olay olunca çalışır | Her seferinde olması gereken doğrulama ve yan etkiler |
| MCP sunucusu | Dış araç ve entegrasyon sağlar | Skill'den ayrı bir kategori |
Slash komutu konusunda dokümanda bir güncelleme var: özel komutlar skill'lerle birleştirilmiş. .claude/commands/deploy.md dosyası ile .claude/skills/deploy/SKILL.md aynı /deploy komutunu oluşturur ve aynı çalışır; eski .claude/commands/ dosyaları çalışmaya devam eder. Kurs ise slash komutlarını "yazman gereken" şey, skill'leri "otomatik" şey diye ayırıyor. Aslında bir skill'i hem otomatik hem elle çağırabilirsin, ikisini disable-model-invocation ile sen ayarlarsın.
Subagent'larla ilişki iki yönlüdür. Skill'e context: fork koyarsan skill ayrı bir subagent'ta çalışır; subagent konuşma geçmişini görmez, bu yüzden talimat tek başına anlaşılır olmalı. Tersine, özel bir subagent dosyasındaki skills alanıyla başlangıçta skill'leri yükleyebilir. Kursa göre subagent, senin önceden çağırdığın skill'leri görmez; yerleşik Explore ve Plan ajanları skill yüklemez. Ayrıntısı bir sonraki sayfada (4.2).
Paylaşma
- Depo:
.claude/skills/klasörünü commit et. Depoyu klonlayan herkes skill'leri otomatik alır. - Plugin: Plugin içinde
skills/klasörü açılır; plugin başka kişilerin kurabileceği bir pazar yerine (marketplace) konabilir. Plugin skill'leri/plugin-adi:skill-adibiçiminde adlanır. Plugin'leri 4.9'da işleyeceğiz. - Yönetilen ayarlar (managed settings): Yöneticiler skill'i kurum genelinde dağıtabilir. Aynı ad olursa kurum skill'i kişisel ve proje skill'inin önüne geçer.
Aynı ada sahip iki skill varsa dokümana göre sıra şöyle: kurum skill'i kişiselin, kişisel de projenin önündedir. İsim çakışmasından kaçınmak için kurs "review" yerine "frontend-review" gibi açıklayıcı adlar öneriyor.
Çalışmıyorsa
- Doğrulayıcıyı çalıştır. Terminalde
claude plugin validate ~/.claude/skills(kişisel) ya daclaude plugin validate .claude/skills(proje). Frontmatter'ı çözümlenmeyenSKILL.mddosyalarını bulur. Bunun için Claude Code'un yeterince yeni bir sürümü gerekir; sürüm koşulu için dokümana bak. - Tetiklenmiyorsa: Description'a insanların gerçekten yazdığı kelimeleri ekle. Skill'in listede göründüğünü kontrol et, isteği açıklamaya yaklaştırarak yeniden yaz, olmazsa
/skill-adiile doğrudan çağır. - Yüklenmiyorsa:
SKILL.mdadlandırılmış bir klasörün içinde mi, dosya adı tam olarakSKILL.mdmi (büyük harfle SKILL, küçük harfle md) kontrol et. Yükleme hatalarını görmek içinclaude --debugile başlat. - Gereğinden sık tetikleniyorsa: Description'ı daha özel yap ya da
disable-model-invocation: trueekle. - Yanlış skill kullanılıyorsa: Description'lar birbirine fazla benziyor; birbirinden ayır.
- Çalışma hatası varsa: Kurs bağımlılıkları, betiklerin çalıştırma izni olup olmadığını (
chmod +x) ve yol ayracını kontrol etmeni söylüyor; yol ayracı olarak her yerde düz eğik çizgi (/) kullan.
Hazır komutlar
Klasörü aç (terminalde):
mkdir -p ~/.claude/skills/toplanti-ozeti
Bu içeriği ~/.claude/skills/toplanti-ozeti/SKILL.md dosyası olarak kaydet (kurgusal örnek, kendi işine göre değiştir):
---
name: toplanti-ozeti
description: Toplantı notlarını kısa bir özete çevirir. Kullanıcı toplantı notu yapıştırıp özet, karar listesi ya da yapılacaklar istediğinde kullan.
---
Verilen toplantı notlarını şu biçimde özetle:
## Kararlar
- Her karar tek cümle olsun.
## Yapılacaklar
- Kim, ne yapacak, ne zamana kadar. Notta tarih yoksa tarih uydurma, "tarih belirtilmedi" yaz.
## Açık sorular
- Notta cevaplanmamış kalan sorular.
Notta olmayan bilgiyi ekleme. Emin olmadığın yeri "belirsiz" diye işaretle.
Claude Code'u aç ve skill'in yüklendiğini sor:
What skills are available?
Doğrudan çağır:
/toplanti-ozeti
Doğrulayıcıyı çalıştır (terminalde):
claude plugin validate ~/.claude/skills
Hazır prompt
Skill'in kendiliğinden devreye girmesini denemek için (kurgusal notlarla; kendi notunu yapıştır):
Bu toplantı notlarını özetle:
- Cuma gününe kadar afiş taslağı hazırlanacak (Elif).
- Web sayfası için renk seçimi henüz yapılmadı.
- Bütçeyi kimin onaylayacağı belli değil.
Kendi skill fikrini bulmak için:
Son çalışmalarımızda sana aynı talimatı birkaç kez verdim. Bunların hangilerini bir skill'e çevirmeliyim? Her aday için skill adını ve tek cümlelik bir description öner.
Sık yapılan hata
- Belirsiz description yazmak. "Dokümanlara yardım eder" gibi bir açıklamayı Claude eşleştiremez. Ne yaptığını ve hangi cümlelerde kullanılacağını yaz.
- Dosyayı yanlış yere koymak.
SKILL.md'yi skills klasörünün köküne atarsan yüklenmez; adlandırılmış bir klasörün içinde olmalı. - Her kuralın skill'le garanti olduğunu sanmak. Skill talimattır; Claude bazen atlayabilir. Dokümanın çözümü: her seferinde olması gereken kuralı bir hook'a taşı (konu 4.4). Hook'u skill'in
hooksalanında da tanımlayabilirsin. allowed-toolsalanına gevşek izin vermek. Doküman, bir skill'in kendine geniş araç izni verebileceği konusunda uyarıyor. Depodan gelen skill'inallowed-toolsalanını, o depoda Claude Code'u çalıştırmadan önce oku. Tek başınaBashyazmak kabuk komutlarını genel olarak önceden onaylar; kurs bunu yalnızca güvendiğin skill'lerde yapmanı, ya daBash(git status *)gibi bir kalıpla daraltmanı söylüyor.- Sır koymak. Proje skill'i commit edilir ve ekiple paylaşılır; parola, anahtar yazma.
- Çok skill, eksik description. Skill çoksa Claude Code bazı açıklamaları listeden kırpabilir. Dokümana göre
/doctorlistenin bağlam maliyetini tahmin eder; bu durumda en önemli kullanım örneğini description'ın başına koy.
Video
Video: yakında.
Kaynak
- Anthropic Academy, Introduction to agent skills: What are skills?, Creating your first skill, Configuration and multi-file skills, Skills vs. other Claude Code features, Sharing skills, Troubleshooting skills
- Anthropic Academy, Claude Code 101: Skills
- Claude Code dokümanı: Extend Claude with skills (konumlar, frontmatter alanları, çağırma kontrolü, destek dosyaları,
context: fork, paylaşma, sorun giderme)
Son doğrulama: 2026-10-21