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

Claude 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 agent 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 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.

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.