How Do Skills Work?

Skill’ler, Claude Code’un context’e göre otomatik olarak uyguladığı yeniden kullanılabilir alan uzmanlığı paketleridir. Güvenlik pattern’ları, kodlama standartları, mimari prensipler gibi özelleşmiş bilgileri kodlar — Claude bunları istemeden tanır ve uygular.

Skill vs Slash Command vs Prompt:

• Skill : context’e göre otomatik uygulama, istemeden çalışır
• Slash Command :açık çağrı, zamanlamayı siz kontrol edersiniz
• Prompt : Claude’un takip edip etmeyeceği bir rehber

Karar ağacı için bkz. 03-Decision-Framework.md

Skill Types

Skill Structure

Skill’ler .claude/skills/ dizininde Markdown dosyaları olarak yaşar. YAML frontmatter ile metadata ve davranış tanımlanır:

.claude/skills/
├── security-audit.md
├── performance-analysis.md
├── react-patterns.md
└── custom-domain-rules.md

Temel skill yapısı:

---
name: performance-analysis
description: Darboğazları tespit et ve optimizasyon öner
type: analysis
tags: [performance, optimization]
---

Performans analizi yaparken şunları değerlendir:
- Algoritma karmaşıklığı (Big O analizi)
- Bellek kullanım pattern'ları
- Gereksiz re-render'lar (React)
- Veritabanı query N+1 problemleri
- Bundle size etkisi

Değişiklik önermeden önce her zaman uygun tool'larla ölç.

Frontmatter alanları:

Skill with Embedded Hooks

Skill’ler doğrudan hook tanımlayabilir skill aktifken otomatik çalışır:

---
name: secure-deployment
description: Guvenlik dogrulamali deployment skill
type: refactoring
hooks:
  PreToolUse:
    - matcher: Bash
      command: ".claude/hooks/validate-deploy.sh"
  PostToolUse:
    - matcher: "Edit|Write"
      command: "npm run security-check"
  Stop:
    - command: ".claude/hooks/cleanup.sh"
      once: true
---

Deployment checklist:
1. Tüm testlerin geçtiğini doğrula
2. Güvenlik taraması çalıştır
3. Environment variable'ları kontrol et
4. SSL sertifikalarını doğrula

once seçeneği hook’un session başına yalnızca bir kez çalışmasını sağlar.

Skill Discovery & Progressive Disclosure

Tüm skill’leri önceden yüklemek context bloat yaratır. Progressive disclosure ile Claude, skill’leri context’e göre keşfeder:

1. Session başlangıcında skill’ler taranır
2. Sadece description’lar system context’e eklenir
3. Tam skill içeriği, Claude ilgili olduğuna karar verdiğinde yüklenir
4. MCP Tool Search’e benzer: açıklamalar önce, tam içerik talep üzerine

Yapılandırma:

{
  "skillDiscoveryAutoEnable": "auto:10"
}

Seçenekler: true (her zaman), false (tümünü önceden yükle), auto:N (skill’ler context’in N%’ini aştığında etkinleştir).

Environment Variables

Permissions & Scope

Skill’ler aynı permission sistemine tabidir:

• Proje kapsamlı: .claude/skills/ (git ile paylaşılır)
• Kişisel: ~/.claude/skills/ (tüm projeler)
• Edit/Bash izinlerini atlayamaz.
• MCP erişimi gerektiren skill’ler permission rule’larına ihtiyaç duyar.

Practical Examples

Güvenlik analizi skill:

---
name: security-patterns
description: OWASP ve CWE guvenlik pattern'larini uygula
type: analysis
tags: [security, owasp]
---

Kontrol et:
- SQL injection açıkları
- XSS saldırı vektörleri
- Güvensiz doğrudan nesne referansları
- Eksik input validation
- Hardcoded credential'lar

React best practices skill:

---
name: react-patterns
description: React component ve hook best practices
type: domain
tags: [react, frontend]
---

Bu pattern'ları uygula:
- Functional component + hook kullan
- Pahalı hesaplamaları memoize et
- Mantık tekrarı için custom hook çıkar
- Prop drilling yerine context kullan
- Event handler'lar için useCallback kullan

TypeScript strict mode skill (hook’lu):

---
name: typescript-strict-mode
description: TypeScript strict mode linting ve type safety
type: refactoring
version: 2.1.0
tags: [typescript, quality, linting]
hooks:
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "npx tsc --noEmit"
---

TypeScript ile çalışırken:
1. Strict mode etkinleştir: "strict": true (tsconfig.json)
2. Fonksiyonlarda açık return type kullan
3. any tipinden kaçın; generic kullan
4. noImplicitAny ve strictNullChecks etkinleştir
5. Karmaşık tipler için discriminated union kullan
6. Type guard ve type predicate kullan

Her dosya düzenlemesi tsc --noEmit'i hatasız geçmeli.

Skill Management Commands

claude skill list                    # Tüm mevcut skill'leri listele
claude skill create my-skill         # İnteraktif skill oluşturma sihirbazı
claude skill remove security-audit   # Skill sil
claude skill test react-patterns     # Skill aktivasyonu ve kalitesini test et

Best Practices

When to Create a Skill

Skill oluştur:

• Alan uzmanlığı otomatik aktifleşmeli
• Birden fazla takım üyesi aynı bilgiye ihtiyaç duyuyor
• Aynı pattern’ları veya kuralları tekrar tekrar açıklıyorsun
• Context, açık çağrı olmadan enjekte edilmeli
• Bilgi birden fazla dosyayı kapsıyor ve organizasyon gerekiyor

Skill oluşturma:

• Çağrı zamanlamasını kontrol etmek istiyorsan (slash command kullan)
• Görev ayrı context gerektiriyorsa (subagent kullan)
• Tek seferlik bir prompt’sa (direkt yaz)
• “Skill” aslında tek bir template’se (slash command kullan)

Expert tip: Kendinizi auth kodu üzerinde çalışırken her seferinde /security-review yazarken buluyorsanız, bunu skill’e dönüştürün. Uzmanlığı ambient yapın, açıkça çağrılır değil. Açık çağrı istiyorsanız command olarak tutun.

Team Sharing Strategies

Git ile paylaşım (proje skill’leri için önerilen):

# Skill'i projeye ekle
mkdir -p .claude/skills/team-standard
# SKILL.md ve destekleyici dosyaları oluştur

# Commit'le
git add .claude/skills/
git commit -m "Add team coding standards skill"
git push

# Takım arkadaşları otomatik alır
git pull
claude  # Skill artık kullanılabilir

Symlink ile projeler arası paylaşım:

# Merkezi skill konumu oluştur
mkdir -p ~/shared-skills/security-reviewer
# SKILL.md oluştur

# Projelere symlink'le
ln -s ~/shared-skills/security-reviewer ~/.claude/skills/security-reviewer
# Artık tüm projelerinizde kullanılabilir

Plugin olarak dağıtım: Daha geniş dağıtım için skill’leri plugin’e paketle:

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── my-skill/
        └── SKILL.md

Plugin vs Skill

Bu iki kavram sık karıştırılır:

Kısacası: Skill tek bir bilgi kartıdır, Plugin ise birden fazla skill’i, hook’u ve MCP server’ı bir arada sunan kurulabilir pakettir.

Örnek: chrome-devtools-mcp bir plugin‘dir, içinde MCP server (Chrome bağlantısı), skill’ler (debugging rehberi) ve hook’lar (otomatik screenshot) barındırır. effective-go ise bir skill‘dir sadece Go best practices içeren tek bir markdown dosyası.

Sık Kullandığım Skill’ler

Popüler Community Skill & Plugin’ler

Superpowers

Superpowers, Claude Code session’larına yapılandırılmış bir geliştirme lifecycle’ı ekler. Tek bir plugin ile birden fazla faz kapsar:

Ne zaman kullanmalı: Karmaşık, çok adımlı görevlerde Claude’un yapılandırılmış bir süreç izlemesini istediğinizde. Özellikle yeni bir feature’ın sıfırdan tasarlanıp geliştirilmesinde faydalı.

Ne zaman gereksiz: Basit bug fix, tek dosya düzenleme veya hızlı soru-cevap. Bu durumda overhead yaratır.

Kaynaklar:

• TurboDocx — Best Plugins 2026
• Composio — Top 10 Skills
• Firecrawl — Top 10 Plugins

Awesome Claude Code-GitHub Koleksiyonları