Anla Dene

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

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

  1. 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.
  2. Nereye kaydedeceğine karar ver. Kişisel skill ~/.claude/skills/<skill-adi>/SKILL.md yoluna gider ve bu bilgisayardaki tüm projelerinde geçerlidir. Proje skill'i .claude/skills/<skill-adi>/SKILL.md yoluna gider; commit edersen depoyu alan herkes onu da alır.
  3. Klasörü aç. Aşağıdaki "Hazır komutlar" bölümündeki mkdir komutunu terminalde çalıştır. Beklenen sonuç: ~/.claude/skills/toplanti-ozeti klasörü.
  4. SKILL.md dosyasını yaz. Dosyanın adı tam olarak SKILL.md olmalı 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.
  5. 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.
  6. Yüklendi mi bak. Çalışan Claude Code oturumuna "What skills are available?" diye sor ya da /skills yaz. 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.
  7. İ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-adi skill'i doğrudan çalıştırır.
  8. Gerekirse sertleştir. Skill'i yalnızca sen çağırmak istiyorsan frontmatter'a disable-model-invocation: true ekle. 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.

AlanNe işe yarar
nameKomut adı; verilmezse klasör adı kullanılır
descriptionSkill ne yapar ve ne zaman kullanılır; Claude eşleşmeyi buna bakarak yapar
when_to_useTetikleyici cümleler gibi ek bilgi; description'a eklenir
disable-model-invocationtrue ise Claude skill'i kendiliğinden yüklemez; yalnızca sen /ad ile çağırırsın
user-invocablefalse ise yalnızca Claude çağırabilir; / menüsünde görünmez
allowed-toolsSkill'i çağıran turda, listelenen araçlar izin sorulmadan kullanılır
modelSkill etkinken kullanılacak model
contextfork yazılırsa skill ayrı bir subagent bağlamında çalışır
pathsSkill'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:

FrontmatterSen çağırabilir misinClaude kendiliğinden çağırabilir mi
(varsayılan)EvetEvet
disable-model-invocation: trueEvetHayır
user-invocable: falseHayırEvet

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

ÖzellikNe zaman yüklenir, ne yaparNe için kullan
CLAUDE.mdHer konuşmada yüklenirHer zaman geçerli proje kuralları
Skillİstek eşleşince yüklenir, bilgiyi mevcut konuşmaya katarGöreve özgü uzmanlık ve prosedür
Slash komutuYazarak çağırırsınTam zamanını senin seçtiğin iş
SubagentAyrı bağlamda çalışır, sonuç dönerDevredilen iş, ayrı araç erişimi, ana bağlamdan yalıtım
HookBir olay olunca çalışırHer seferinde olması gereken doğrulama ve yan etkiler
MCP sunucusuDış araç ve entegrasyon sağlarSkill'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

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

  1. Doğrulayıcıyı çalıştır. Terminalde claude plugin validate ~/.claude/skills (kişisel) ya da claude plugin validate .claude/skills (proje). Frontmatter'ı çözümlenmeyen SKILL.md dosyaları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.
  2. 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-adi ile doğrudan çağır.
  3. Yüklenmiyorsa: SKILL.md adlandırılmış bir klasörün içinde mi, dosya adı tam olarak SKILL.md mi (büyük harfle SKILL, küçük harfle md) kontrol et. Yükleme hatalarını görmek için claude --debug ile başlat.
  4. Gereğinden sık tetikleniyorsa: Description'ı daha özel yap ya da disable-model-invocation: true ekle.
  5. Yanlış skill kullanılıyorsa: Description'lar birbirine fazla benziyor; birbirinden ayır.
  6. Ç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

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-10-21

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik