Lesson 03 · 10 dk okuma

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.