Claude Code Skill Nasıl Oluşturulur (SKILL.md)

Claude Code skill nedir?

Claude skill'i, bir agent'a küçük bir klasör olarak verdiğin yeniden kullanılabilir bir yetenektir; klasör bir SKILL.md dosyası (ve isteğe bağlı script veya referans dosyaları) içerir. Claude, skill'in adını ve açıklamasını baştan görür; tam talimatları ise yalnızca mevcut görev eşleştiğinde yükler — böylece skill'ler context penceresini şişirmeden ölçeklenir.

Claude Skills, açık Agent Skills standardının Anthropic uygulamasıdır (aynı SKILL.md formatı Claude Code, Claude uygulamaları ve diğer agent'larda çalışır). Kavrama yeniyseniz önce claude skill nedir yazısıyla başlayın.

Claude skill vs command, subagent, plugin ve MCP

Bu yapılar birbirine benzer, doğru olanı seçin:

• Skill — yeniden kullanılabilir bilgi ("bir PR nasıl incelenir"). SKILL.md ile ihtiyaç anında yüklenir. Tekrarlayan iş akışları için idealdir.
• Slash command — açıkça çağırdığın manuel kısayol. Skill kendi tetiklenir; command tetiklenmez.
• Subagent — devredilen bir görev için kendi context penceresi olan ayrı bir agent. Skill'den daha ağırdır.
• Plugin — command, skill ve hook'ları dağıtım için bir arada paketler.
• MCP server — agent'ı dış araç ve verilere bağlar. MCP *araç* ekler; skill *talimat* ekler. Birbirlerini tamamlarlar.

SKILL.md dosyasının anatomisi

Her skill'in bir YAML frontmatter bloğu ve markdown gövdesi olan bir SKILL.md'ye ihtiyacı vardır:

• name — küçük harf, kebab-case ve klasör adıyla aynı olmalı (en fazla 64 karakter).
• description — skill'in ne yaptığını ve ne zaman tetiklenmesi gerektiğini belirten bir-iki cümle. En kritik alan budur: Claude skill'i yükleyip yüklemeyeceğine buna bakarak karar verir.
• Gövde — asıl talimatlar; net, emir kipinde adımlar. ~500 satırın altında tutun; uzun referansları skill'in işaret edebileceği ayrı dosyalara taşıyın.

Claude Code skill nasıl oluşturulur (adım adım)

Sıfırdan ilk skill'inizi oluşturmak için şu adımları izleyin.

Skill'inizi kurma: ~/.claude/skills klasörü

Claude Code kişisel skill'leri ~/.claude/skills/ klasöründe, proje skill'lerini ise repo içindeki .claude/skills/ klasöründe bulur. Skill adında bir klasör oluşturun ve SKILL.md'yi içine koyun:

mkdir -p ~/.claude/skills/code-reviewer
# ~/.claude/skills/code-reviewer/SKILL.md ekleyin

Claude Code'u yeniden başlatın (veya yeni bir oturum açın); skill kullanıma hazırdır — bir görev açıklamayla eşleştiğinde Claude onu otomatik çağırır. "Bu skill'i kullan" demenize gerek yok.

Kopyalayabileceğin tam bir SKILL.md

İşte çalışan minimal bir örnek. ~/.claude/skills/code-reviewer/SKILL.md içine kopyalayın:

---
name: code-reviewer
description: Bir diff veya pull request'i doğruluk hataları, güvenlik sorunları ve stil açısından inceler. Kullanıcı kod, diff veya PR incelemesi istediğinde kullan.
---

# Code Reviewer

Kod incelemesi istendiğinde:

1. Yorum yapmadan önce diff'in tamamını oku.
2. Önce doğruluk hatalarını, sonra güvenlik sorunlarını, sonra stili işaretle.
3. file:line referanslarıyla somut geri bildirim ver.
4. Kısa bir özet ve net bir onayla / değişiklik-iste kararıyla bitir.

Claude skill nasıl yüklenir / eklenir (~/.claude/skills)

Bir skill'i sıfırdan yazmak zorunda değilsin — mevcut bir Claude skill'ini yükleyebilir (klasöre ekleyebilir)sin. Kod gerektirmeyen üç yol:

1. Plugin marketplace (Anthropic'in resmi yöntemi). Claude Code içinden bir marketplace ekle, sonra bir plugin kur (plugin; skill, command ve hook'ları bir arada paketleyebilir):

/plugin marketplace add anthropics/skills
/plugin install <plugin-name>@anthropic-agent-skills

Resmi marketplace açılışta hazırdır, doğrudan da kurabilirsin — örn. /plugin install github@claude-plugins-official — sonra yeniden başlatmadan etkinleştirmek için /reload-plugins çalıştır.

2. skills CLI (topluluk aracı). Herhangi bir GitHub reposundan ham bir SKILL.md skill'ini yükle:

npx skills add owner/repo --skill <skill-name> -a claude-code -g

-g global olarak ~/.claude/skills'e kurar; mevcut projeye (.claude/skills) kurmak için kaldır. Bu, Anthropic komutu değil, üçüncü taraf skills.sh CLI'sidir.

3. Elle. Herhangi bir skill klasörünü (SKILL.md içeren) ~/.claude/skills/ içine kopyala — Claude Code sonraki oturumda alır.

Ya da ProfessorGPT kataloğundan herhangi bir skill'i tek komutla kur.

Claude'a yazdır: skill-creator

Anthropic, senin yerine skill yazan resmi bir skill-creator skill'i sunar — SKILL.md'yi taslaklar, test senaryoları eklemene yardım eder ve güvenilir tetikleme için description'ı ayarlar. Onu da herhangi bir skill gibi kur (yukarıdaki plugin marketplace ile), sonra Claude'a düz dille söyle: *"PR'larımı inceleyen bir skill oluştur."* Claude Code'da isteğinden otomatik tetiklenir — /skill-creator komutu yoktur. (OpenAI Codex'te aynı fikir yerleşik bir $skill-creator komutudur.)

YAML yazmadan Claude skill oluştur

Frontmatter'ı elle yazmak istemiyorsan, Skill Builder birkaç girdiden temiz, standarda uygun bir SKILL.md üretir — bir kategori seç, işi tanımla, sonucu indir ya da kur. Ayrıca hazır skill'lere göz atıp birini uyarlayabilirsin.