Claude Skills Rehberi

Kısa özet

Claude Skills, Claude Code'un belirli bir görev için davranışını değiştiren küçük talimat paketleridir. Bir skill aktive edildiğinde ("/caveman" gibi), Claude o görevin gerektirdiği rolü/üslubu/iş akışını uygulayarak konuşmaya devam eder. Tek dosya, tek satır komut, anında etki.

Bu rehber üç şeyi anlatıyor: hazır skill koleksiyonlarını kurma, en sık kullanılan skill'leri ne için tercih edileceğiyle birlikte tanıtma, kendi skill'ini yazıp dağıtma.

Hazır skill koleksiyonu kurma

Skill kurmanın en hızlı yolu skills CLI ile bir paketi indirmektir. Matt Pocock'un popüler koleksiyonu örnek olsun:

npx skills@latest add mattpocock/skills

Bu komut, paketteki skill'leri ~/.claude/skills/ altına kopyalar. Claude Code'u yeniden başlatınca slash komut listesinde görürsün — /<skill-name> ile çağırabilirsin.

Eklediğin skill'leri listelemek:

ls ~/.claude/skills/

Bir skill'in tam talimatını görmek için içindeki SKILL.md dosyasını oku — neyin nasıl değişeceğini anlamadan kullanma.

En sık kullanılan skill'ler

/caveman — kompakt yanıt modu

Yanıtların yaklaşık %75'ini sıkıştırır. Articles ("the", "a"), nezaket ifadeleri ("sure", "happy to"), hedge sözcükler ("just", "really") düşer; teknik öz korunur.

Ne zaman: uzun teknik konuşmalarda token tasarrufu, hızlı senaryo iterasyonu, debug oturumu. Ne zaman değil: ekibe sunum yapacağın final yazıyı üretirken — tonu fazla telgraf gibi olur.

/grill-me — plan sorgulama modu

Bir tasarım veya plan ortaya koyduğunda, Claude'u "agresif sorgulayıcı" rolüne sokar. Her ön kabulü, edge case'i, alternatifi sorar; sen cevaplar verdikçe bir karar ağacında ilerlersiniz.

Ne zaman: mimari karar, ürün spec, sistem tasarımı tartışırken. Ne zaman değil: zaten karara varılmış işin uygulamasında — sadece engel olur.

/init — yeni projeye CLAUDE.md kurma

Boş bir dizinde /init çağırdığında Claude proje yapısını tarar, dilini/çerçevesini tahmin eder, anlamlı bir CLAUDE.md taslağı önerir. Sen düzenler, projeye eklersin.

Ne zaman: Claude Code'u yeni bir repo'da ilk kullanıma alırken.

/review — yapılandırılmış kod incelemesi

PR veya branch için "Critical / Suggestion / Style" başlıklarına ayrılmış inceleme üretir. Ekipler arası tutarlı geri bildirim formatı.

Ne zaman: code review döngüsü, PR şablonu üretmek.

/security-review — güvenlik odaklı inceleme

Bekleyen değişiklikler için güvenlik bakış açısıyla tarama: SQL injection, XSS, kimlik doğrulama gevşeklikleri, env değişkeni sızıntıları, dependency güvenlik açıkları.

Ne zaman: canlıya çıkmadan önceki son geçit.

/simplify — kalite/tekrar/verimlilik gözden geçirme

Az önce yazılmış kodu üç açıdan kontrol eder: aynı işi yapan başka bir parça var mı, kalite sorunları neler, performans optimizasyonları yapılabilir mi.

Ne zaman: PR açmadan önce kendi kodunu temizlerken.

/find-skills — skill kataloğu arama

Mevcut skill'lerin koleksiyonunu tarar, ihtiyacına göre öneri üretir. "AI ile prototip yapmak istiyorum, hangi skill?" diye soru sorabilirsin.

Skill'ler nasıl çalışır?

Bir skill aslında bir markdown dosyasıdır:

~/.claude/skills/<skill-name>/
└── SKILL.md

SKILL.md üst kısmında YAML frontmatter, gövdesinde davranış kuralları yer alır. Claude bu içeriği prompt'a ekleyerek konuşmayı sürdürür.

Frontmatter örneği:

---
name: caveman
description: Ultra-compressed communication mode. Cuts token usage ~75%.
trigger: /caveman
---

Gövde özgürdür; markdown ile kuralları, örnekleri, kapsam sınırlarını yazarsın. Çoğu skill 30-100 satır arası — yeterince spesifik, yeterince kısa.

Kendi skill'ini yazmak

Diyelim takımında "PR açıklama yazma" işini standartlaştırmak istiyorsun. Skill kuralım:

mkdir -p ~/.claude/skills/pr-description
$EDITOR ~/.claude/skills/pr-description/SKILL.md

İçeriği:

---
name: pr-description
description: Standartlaştırılmış PR açıklaması üretir. Türkçe ve İngilizce iki dilli özet.
trigger: /pr-description
---

# PR açıklaması üret

Bekleyen değişiklikler için bir GitHub PR açıklaması üret.

## Bölümler

1. **Özet (1 cümle)** — değişikliğin amacı.
2. **Neden (2-3 cümle)** — bu değişiklik niye gerekli, hangi sorunu çözüyor.
3. **Yapılan değişiklikler (madde madde)** — somut neyi değiştirdiğin.
4. **Test (madde madde)** — değişikliğin nasıl test edileceği.

## Kurallar

- Türkçe ve İngilizce iki dilli yaz; İngilizce başa, Türkçe altta.
- "Ne yaptığını" değil, "neden yaptığını" anlat.
- 200 kelimeyi aşma.
- Konuyla ilgili issue numarası varsa "Closes #123" ekle.

## Örnek

> ### Summary (EN)
> Add Stripe webhook signature verification.
>
> ### Why
> Webhooks were trusted blindly — any attacker could POST a fake event.
>
> ### Changes
> - Add `verifyStripeSignature` middleware
> - Apply to `/webhooks/stripe` route
> - Throw 400 on signature mismatch
>
> ### Testing
> - [ ] Send valid event with curl, expect 200
> - [ ] Send tampered payload, expect 400
> - [ ] Replay attack → expect 400
>
> Closes #842
>
> ### Özet (TR)
> Stripe webhook imza doğrulaması eklendi.
>
> ...

Claude Code'u yeniden başlat, /pr-description artık skill listesinde. Kullanışlı bir kaç skill yazdıktan sonra ekibe git ile dağıtabilir, ortak bir ~/.claude/skills/ deposu ya da repo'ya bağlı bir claude/skills/ klasörü kurabilirsin.

Skill yazımında sık tuzaklar

Çelişen kurallar

caveman ile grill-me'yi birlikte aktive ettiğinde "kısa olsun" + "her şeyi sorgula" çelişir. Skill'lerin uyumlu olduğundan emin ol; gerekirse skill içinde "diğer skill'ler aktifse aldırma" kuralı ekle.

Çok uzun talimat

500 satırlık bir skill, prompt'un kalanına yer bırakmaz. Skill 100 satırın altında tutulur — daha karmaşık iş akışı için agent (subagent_type) düşün, skill değil.

Tehlikeli komut çalıştırma

Bir skill "şu shell komutunu çalıştır" diyebilir. Yabancı kaynaktan kurduğun skill'i kullanmadan önce SKILL.md'yi mutlaka oku. Sandbox güvencesi yoksa zararlı talimat sızabilir.

Versiyonlama yok

SKILL.md'yi her güncellediğinde Claude Code'u yeniden başlatmak gerekebilir. Skill'leri Git'te tutarsan değişiklik takibi mümkün; yan etkiyle ekip arasında paylaşmak kolay olur.

Gelişmiş örüntüler

Koşullu davranış

Skill'in farklı modları için trigger ekleyebilirsin:

## Aktivasyon

- `/pr-description` — varsayılan: iki dilli, geniş
- `/pr-description short` — sadece İngilizce, 5 satır
- `/pr-description tr` — sadece Türkçe

Claude bu argümanları yorumlar; davranışı buna göre ayarlar.

Şablon dosyası

Skill yalnızca SKILL.md değil, başka dosyalar da içerebilir. Örneğin bir kod şablonu, bir checklist, bir konfigürasyon örneği:

~/.claude/skills/new-react-component/
├── SKILL.md
├── template.tsx
└── README.md

SKILL.md içinde "template.tsx'i oku ve isim parametresine göre uyarla" diyebilirsin.

Hooks ile otomatik tetikleme

Bir skill'i her toplantı sonrası, her commit sonrası, her hata sonrası otomatik çalıştırmak istersen, Claude Code harness'ının hooks mekanizmasını kullan. Skill manuel; hook otomatik.

Sonraki adımlar

• Mevcut skill koleksiyonlarını incele: awesome-claude-skills GitHub repoları
• Ekip skill repo'su kur: ortak iş akışlarını tek yerden dağıt
• Skill + MCP server kombinasyonu kur: skill davranışı belirler, MCP server eylem yapar

Devamı için

• MCP Server Kataloğu — skill'lerle birlikte ekosistemi tamamlayan diğer mekanizma.
• System Prompt Rehberi — bir skill aslında özel bir system prompt; orada da on persona örneği var.
• MCP — skill davranışı belirler, MCP eylem yapar; ikisi nasıl birlikte çalışır.
• System Prompt — skill'lerin altındaki temel kavram.