Skills ekosistemi
Skill anatomisi, on-demand yükleme, allowed-tools, skill collection'lar.
Skill belirli bir konuda uzmanlaşmış, on-demand yüklenen prosedürel rehberdir. Command’dan farkı: command kullanıcı çağırır; skill, modeldescription eşleşmesi sonucu kendi kendine yüklenir.
Anatomi
~/.claude/skills/<skill-name>/
SKILL.md # zorunlu
reference.md # opsiyonel uzun spec
examples/ # opsiyonel
SKILL.md frontmatter:
---
name: my-skill
description: Use when [SYMPTOM/TASK] — covers [SCOPE]
---
description → injected to system prompt → Claude bu skill’in ne zaman uygulanacağına karar verir. Net tetikleyici şart.
On-demand yükleme
Tüm skill’ler oturum başlangıcında listelenir ama içerikler yüklenmez. Claude görevi alınca uygun skill’i çağırır (Skill tool). Sadece o anda içeriği context’e girer. 50 skill’in olsa bile, oturum başına sadece 0-3 yüklenir.
Allowed tools
Skill içinde tool kullanımını sınırlamak için frontmatter’a:
---
name: postgres-helper
description: Use when querying or migrating Postgres
allowed-tools: Bash, Read
---
Skill collection’lar
GitHub’da paylaşılan skill kütüphaneleri var (örn. obra/superpowers, anthropic/skills). Bunlardan kurulum:
# Örnek: bir collection'ı kullanıcı dizinine clone'la
git clone https://github.com/USER/collection ~/.claude/skills/_collection
Her bir alt-skill kendi klasöründedir, otomatik bulunur.
Iyi description’ın kuralı
1 paragrafta: ne zaman tetiklenir + hangi semptomlar + skip case’leri.
description: Use when async tests fail intermittently or have flaky timing.
Covers race conditions, polling, and condition-based waiting.
Skip if test only uses synchronous code.
Sıradaki
Settings.json — undocumented alanlar dahil.