Claude Code skill sistemi, Claude'un yeteneklerini genisleten; talimat, script ve kaynak dosyalarindan olusan moduler yapi taslaridir. Anthropic'in resmi verilerine gore, 115.000'den fazla gelistirici Claude Code kullaniyor ve haftalik 195 milyon satir kod isleniyor (PPC Land, 2025). Bu rehberde skill sistemi mimarisini, SKILL.md yapisini, hooks ve MCP entegrasyonunu detayli olarak inceleyecegiz.
Skill Sistemi Tam Olarak Ne Ise Yariyor?
Skill sistemi, Claude Code'un varsayilan davranislarini ozellestirmenizi saglayan bir framework'tur. Her skill, kendi klasorunde yasayan bagimsiz bir moduldur. Anthropic'in muhendislik bloguna gore, skill sistemi acik kaynakli Agent Skills standardini takip eder ve bu sayede farkli AI araclari arasinda tasinabilirlik saglar (Anthropic Engineering, 2025).
Skill'lerin temel calisma prensibi su adimlari izler:
Skill Calisma Prensipleri
| Asama | Aciklama | Token Maliyeti |
|---|---|---|
| Tarama | Claude, mevcut skill'lerin metadata'sini okur | ~100 token/skill |
| Eslestirme | Kullanici istegiyle uyumlu skill secilir | Otomatik |
| Yukleme | Secilen skill'in tam icerigi yuklenir | <5.000 token |
| Yurutme | Skill talimatlari adim adim uygulanir | Degisken |
Bu sistem sayesinde Claude Code'u proje bazli, takim bazli veya kisisel ihtiyaclariniza gore yapilandirabilirsiniz. Ornegin bir "deploy" skill'i olusturup tek komutla production ortamina cikis surecinizi otomatize edebilirsiniz.
SKILL.md Dosyasi Nasil Olusturulur?
Her skill'in kalbi SKILL.md dosyasidir. Bu dosya iki temel bilesenden olusur: YAML frontmatter (metadata) ve Markdown icerik (talimatlar). Mikhail Shilkov'un detayli analizine gore, iyi yapilandirilmis bir SKILL.md dosyasi Claude'un skill'i dogru zamanda ve dogru sekilde kullanmasini saglar (Shilkov, 2025).
SKILL.md Temel Yapisi Nasil Gorunuyor?
SKILL.md dosyasi YAML frontmatter ile baslar. Ornek bir explain-code skill'i: name alani skill adini, description alani ne zaman kullanilacagini tanimlar. Ardindan Markdown icerikte adim adim talimatlar yer alir: analoji ile baslama, diyagram cizme, adim adim yurutme ve tuzaklari belirtme.
Frontmatter Alanlari Nelerdir?
Frontmatter, skill'in davranisini kontrol eden metadata alanlarini icerir. Claude Code resmi dokumantasyonuna gore 10'dan fazla yapilandirma alani mevcuttur (Claude Code Docs, 2026):
SKILL.md Frontmatter Alanlari
| Alan | Zorunlu mu? | Aciklama | Ornek |
|---|---|---|---|
| name | Hayir | Skill tanimlayici (kucuk harf, tire, maks 64 karakter) | deploy-prod |
| description | Onerilen | Ne yaptigini ve ne zaman kullanilacagini aciklar | "Production'a deploy eder" |
| argument-hint | Hayir | Otomatik tamamlama ipucu | [issue-number] |
| disable-model-invocation | Hayir | true ise Claude otomatik tetikleyemez | true |
| user-invocable | Hayir | false ise / menusunde gizlenir | false |
| allowed-tools | Hayir | Izin istenmeden kullanilacak araclar | Read, Grep, Glob |
| model | Hayir | Kullanilacak Claude modeli | claude-opus-4-5-20251101 |
| context | Hayir | fork ile izole subagent baglami | fork |
| agent | Hayir | context: fork ile subagent tipi | Explore, Plan |
| hooks | Hayir | Skill yasam dongusune bagli hook'lar | Asagida detaylandirilmistir |
Skill Dizin Yapisi Nasil Organize Edilmeli?
Bir skill sadece SKILL.md'den ibaret degildir. Karmasik skill'ler script, referans ve sablon dosyalari icerebilir. Lee Han Chung'in first-principles analizine gore, iyi organize edilmis bir dizin yapisi skill'in bakimini ve genisletilmesini kolaylastirir (Chung, 2025).
Tipik bir skill dizin yapisi: skill-name/ klasoru altinda SKILL.md (zorunlu ana talimat dosyasi), references/ (opsiyonel detayli dokumantasyon), scripts/ (opsiyonel calistiriabilir scriptler) ve assets/ (opsiyonel sablon, ikon vb.) yer alir.
Skill'ler Nereye Kaydedilir?
Claude Code skill'leri dort farkli konumda arar ve oncelik sirasi soyledir:
Skill Konum Oncelikleri
| Oncelik | Konum | Kapsam | Kullanim Senaryosu |
|---|---|---|---|
| 1 (En yuksek) | Enterprise managed settings | Organizasyon geneli | Kurumsal standartlar |
| 2 | ~/.claude/skills/<name>/ | Kisisel — tum projeler | Kisisel is akislari |
| 3 | .claude/skills/<name>/ | Proje bazli | Proje standartlari |
| 4 (En dusuk) | <plugin>/skills/<name>/ | Plugin kaynakli | Ucuncu parti araclar |
Ayni isimli skill'lerde yuksek oncelikli konum dusuk olani ezer. Plugin skill'leri plugin-name:skill-name formatiyla cakismayi onler.
Simyacidan Not
Kisisel skill'lerinizi ~/.claude/skills/ altina, proje bazli olanlari .claude/skills/ altina koyun. Bu sayede takim arkadaslariniz projeye ozgu skill'leri Git ile paylasabilir, kisisel tercihleriniz de her projede gecerliligini korur.
Skill Cagirma Mekanizmalari Nelerdir?
Skill'ler iki farkli sekilde tetiklenir: kullanici tarafindan (slash command) veya Claude tarafindan (otomatik eslestirme). Bu iki mod, frontmatter ayarlariyla kontrol edilir.
Kullanici Tetiklemesi (Slash Command) Nasil Calisir?
Kullanici Claude Code'da /skill-adi yazarak dogrudan bir skill cagirir. Argueman gecisi de desteklenir: /deploy, /fix-issue 123, /review src/auth.ts detailed gibi.
Dinamik string substitution ile argumanlara skill icinden erisilir:
Argueman Degiskenleri
| Degisken | Aciklama |
|---|---|
| $ARGUMENTS | Tum argumanlar |
| $ARGUMENTS[0] veya $0 | Ilk argueman (0-indexed) |
| $ARGUMENTS[1] veya $1 | Ikinci argueman |
| ${CLAUDE_SESSION_ID} | Aktif oturum ID'si |
Otomatik Tetikleme Nasil Kontrol Edilir?
Claude, description alanini analiz ederek kullanici istegiyle eslesen skill'i otomatik yukler. Iki kritik senaryo mevcuttur:
Sadece kullanici tetikleyebilir (yan etkili islemler icin): disable-model-invocation: true ayari kullanilir. Ornegin production'a deploy eden skill'ler icin bu guvenlik katmani onemlidir.
Sadece Claude tetikler (arka plan bilgi kaynagi): user-invocable: false ayari kullanilir. Ornegin legacy sistem mimarisini aciklayan bir bilgi kaynagi skill'i bu sekilde yapilandirilir.
Hooks Sistemi Nasil Calisir?
Hook'lar, Claude Code'un yasam dongusunde belirli anlarda otomatik calisan komutlardir. DataCamp'in pratik rehberine gore, hook sistemi deterministik kontrol saglayarak is akisini kesintisiz otomatize eder (DataCamp, 2025).
Hook Yasam Dongusu Nelerden Olusur?
Claude Code 11 farkli hook olayini destekler:
Hook Olaylari
| Hook Olayi | Ne Zaman Tetiklenir? | Kullanim Ornegi |
|---|---|---|
| SessionStart | Oturum baslarken | Ortam dogrulama |
| UserPromptSubmit | Kullanici prompt gonderdiginde | Input validation |
| PreToolUse | Arac calismadan once | Guvenlik kontrolu |
| PermissionRequest | Izin dialogu acildiginda | Otomatik onay |
| PostToolUse | Arac basariyla calistiktan sonra | Kod formatlama |
| PostToolUseFailure | Arac basarisiz oldugunda | Hata loglama |
| SubagentStart | Subagent baslatildiginda | Kaynak izleme |
| SubagentStop | Subagent tamamlandiginda | Sonuc dogrulama |
| Stop | Claude yanit bitirdiginde | Test calistirma |
| PreCompact | Context sikistirilmadan once | Veri yedekleme |
| SessionEnd | Oturum sonlandiginda | Cleanup islemleri |
Hook Yapilandirmasi Nasil Yapilir?
Hook'lar settings dosyalarinda (~/.claude/settings.json, .claude/settings.json veya .claude/settings.local.json) tanimlanir. PostToolUse olayinda Write veya Edit araclari kullanildiginda prettier --write $file komutu otomatik calistirilabilir.
Matcher pattern'leri: Basit string (Write), regex (Edit|Write), wildcard (*) desteklenir. Matcher yalnizca PreToolUse, PermissionRequest ve PostToolUse olaylarinda gecerlidir.
Skill Icinde Hook Tanimlama Nasil Yapilir?
Claude Code 2.1.0 ile birlikte hook'lar dogrudan skill frontmatter'ina eklenebilir. VentureBeat'in analizine gore bu ozellik, skill'lerin kendi yasam donglerini yonetmesini saglar (VentureBeat, 2026).
Ornegin secure-deploy skill'inde PreToolUse olayinda Bash araci kullanildiginda guvenlik kontrolu scripti calistiribilir. Stop olayinda ise takim bildirim scripti tetiklenebilir.
MCP Entegrasyonu Nedir ve Nasil Kurulur?
Model Context Protocol (MCP), Claude Code'u yuzlerce harici arac ve veri kaynagina baglayan acik kaynakli bir standarttir. Codecademy'nin rehberine gore, MCP sayesinde Claude Code dogrudan issue tracker, veritabani, tasarim araci ve daha fazlasiyla etkilesime gecebilir (Codecademy, 2025).
MCP Server Kurulumu Nasil Yapilir?
Uc farkli transport yontemi desteklenir:
MCP Transport Yontemleri
| Transport | Komut Ornegi | Kullanim Senaryosu |
|---|---|---|
| HTTP (Onerilen) | claude mcp add --transport http notion https://mcp.notion.com/mcp | Remote servisler |
| SSE (Deprecated) | claude mcp add --transport sse asana https://mcp.asana.com/sse | Eski sistemler |
| Stdio | claude mcp add --transport stdio myserver -- npx -y server-pkg | Lokal araclar |
MCP Kurulum Kapsamlari Nelerdir?
MCP Kurulum Kapsamlari
| Kapsam | Depolama Yeri | Paylasim | Kullanim |
|---|---|---|---|
| Local (varsayilan) | ~/.claude.json (proje yolu altinda) | Ozel | Kisisel, projeye ozel |
| Project | .mcp.json (proje koku) | Git ile takim | Takim araclari |
| User | ~/.claude.json | Tum projeler | Kisisel, evrensel |
Pratik ornekler: Kisisel Stripe entegrasyonu (local scope), takim ile paylasilan GitHub (project scope), her projede kullanilan HubSpot (user scope) seklinde yapilandirabilirsiniz.
Tool Search Optimizasyonu Nasil Calisir?
MCP arac tanimlamalari context window'un %10'unu astiginda Claude Code otomatik olarak Tool Search moduna gecer. Araclar tumu birden yuklenmek yerine ihtiyac aninda dinamik olarak cagrilir. ENABLE_TOOL_SEARCH=auto:5 ile %5 esikle Tool Search aktif edilebilir veya ENABLE_TOOL_SEARCH=false ile devre disi birakilabilir.
Claude Code 2.1.0 ile Gelen Yenilikler Neler?
Ocak 2026'da yayimlanan Claude Code 2.1.0, 1.096 commit iceren kapsamli bir guncellemedir. VentureBeat'in raporuna gore bu surum, skill sisteminde onemli iyilestirmeler getirdi (VentureBeat, 2026):
Claude Code 2.1.0 Yenilikleri
| Ozellik | Aciklama | Etki |
|---|---|---|
| Skill Hot Reload | Skill degisiklikleri oturum yeniden baslatmadan yuklenir | Iterasyon suresi ~2 dk -> ~5 sn (24x hizlanma) |
| Skill Ici Hooks | Hook'lar dogrudan skill frontmatter'ina eklenebilir | Moduler yasam dongusu yonetimi |
| Forked Context | context: fork ile izole subagent calistirma | Yan etki onleme |
| Wildcard Permissions | Pattern matching: Bash(*-h*) | Granuler arac erisimi |
| Session Teleportation | /teleport ile lokal-web arasi gecis | Kesintisiz is akisi |
| Shift+Enter | Cok satirli prompt girisi | Kurulum gerektirmez |
VentureBeat
"Claude Code 2.1.0 arrives with smoother workflows and smarter agents, marking the biggest single release in the tool's history." - VentureBeat Editoryal Ekibi (Ocak 2026)
Topluluk Ekosistemi ve Skill Marketplace Nedir?
Skill sisteminin gucu, topluluk tarafindan gelistirilen hazir skill'lerle katlanarak artiyor. Anthropic'in resmi skills deposu ve awesome-claude-skills listesi ile 2025 sonundan itibaren birden fazla topluluk platformu ve dizin olustu.
One Cikan Skill Kaynaklari Hangileri?
Skill Kaynaklari
| Platform | Aciklama | Icerik |
|---|---|---|
| anthropics/skills (GitHub) | Anthropic'in resmi skill deposu | Dokuman, tasarim, gelistirme, iletisim skill'leri |
| travisvn/awesome-claude-skills (GitHub) | Topluluk kuratorlu liste | Filtreleme, kategorileme, kaynak listesi |
| SkillsMP (skillsmp.com) | Skill marketplace | Claude, Codex ve ChatGPT icin skill arama |
| awesome-claude-code-subagents (GitHub) | VoltAgent tarafindan | 100+ uzmanlasmis subagent |
Resmi Skill Kategorileri Nelerdir?
Anthropic'in resmi deposunda su kategoriler yer aliyor:
Resmi Skill Kategorileri
| Kategori | Skill Sayisi | Ornekler |
|---|---|---|
| Dokuman | 4 | DOCX, PDF, PPTX, XLSX olusturma/duzenleme |
| Tasarim & Kreatif | 3 | algorithmic-art, canvas-design, slack-gif-creator |
| Gelistirme | 4 | frontend-design, artifacts-builder, mcp-builder, webapp-testing |
| Iletisim | 2 | brand-guidelines, internal-comms |
| Skill Olusturma | 1 | skill-creator (interaktif skill builder) |
Skill Kurulumu Nasil Yapilir?
SkillsMP marketplace'den kurulum: /plugin marketplace add anthropics/skills komutu ile yapilir. Lokal dizinden kurulum: /plugin add /path/to/skill-directory komutu ile yapilir.
Claude Code vs Cursor vs GitHub Copilot: Ozellestirme Karsilastirmasi Nasil?
Builder.io'nun karsilastirma analizine gore, uc buyuk AI kod asistani farkli ozellestirme yaklasimlari benimsiyor (Builder.io, 2025). Hangi aracin skill/kural sistemi ihtiyanciniza daha uygun?
AI Kod Asistanlari Karsilastirmasi
| Ozellik | Claude Code | Cursor | GitHub Copilot |
|---|---|---|---|
| Mimari | Terminal-native CLI | VS Code fork'u | IDE uzantisi |
| Ozellestirme | Skill + Hooks + CLAUDE.md | Rules + Commands | Minimal |
| Hot Reload | Var (v2.1.0+) | Yok | Yok |
| Hook Sistemi | 11 olay | Yok | Yok |
| MCP Entegrasyonu | Yuzlerce arac | Sinirli | Sinirli |
| Subagent Destegi | Var (ozel delegasyon) | Yok | Yok |
| Marketplace | SkillsMP + GitHub | Yok | Yok |
| Context Window | 200.000 token | Standart | Sinirli |
| Baglam Mirasi | Ic ice dizin destegi | Glob tabanli | Yok |
Cursor Rules dosya tabanli .cursor/rules (MDX formati) kullanir, glob pattern ile auto-attach destekler. GitHub Copilot ise minimal ozellestirme sunar ve kural/hook sistemi icermez.
Simyacidan Not
Claude Code "agentic workflow" senaryolarinda (otomasyon, coklu arac entegrasyonu, karmasik refactoring) one cikarken, Cursor gunluk kodlama ve IDE-native deneyimde gucludur. Ikisini birlikte kullanmak da yaygin bir pratiktir.
Pratik Bir Custom Skill Nasil Olusturulur?
Adim adim bir "code-review" skill'i olusturalim. Bu skill, bir dosyayi OWASP Top 10 guvenlik aciklarina karsi tarayacak.
Adim 1: Dizin Yapisini Olusturun
mkdir -p ~/.claude/skills/security-review komutu ile skill dizinini olusturun.
Adim 2: SKILL.md Dosyasini Yazin
security-review skill'i icin SKILL.md dosyasinda: name, description (OWASP Top 10 guvenlik aciklarina karsi tarar), argument-hint ([dosya-yolu]) ve allowed-tools (Read, Grep, Glob) alanlari tanimlanir.
Talimat bolumunde $ARGUMENTS dosyasini su OWASP Top 10 (2025) kategorilerine gore tarama adimlari yer alir:
1. Injection: SQL, NoSQL, OS, LDAP injection kontrol
2. Broken Authentication: Hardcoded credentials, zayif session yonetimi
3. Sensitive Data Exposure: Sifrelenmemis veri, API key sizintisi
4. XSS: Input sanitization eksikligi
5. CSRF: Token kontrolu eksikligi
Her bulgu icin cikti formati: Dosya (tam yol), Satir (satir numarasi), Kategori (OWASP kategorisi), Ciddiyet (Kritik/Yuksek/Orta/Dusuk), Aciklama ve Oneri alanlari yer alir.
Adim 3: Kullanin
Claude Code'da /security-review src/auth/login.ts komutu ile dogrudan cagirin. Bu skill, Claude Code 2.1.0'in hot reload ozelligi sayesinde kaydettikten sonra oturum yeniden baslatmadan hemen kullanilabilir.
Benimseme Istatistikleri Ne Gosteriyor?
Claude Code'un benimsenmesi 2025'in ikinci yarisindan itibaren hizla artti. Anthropic'in resmi verilerine gore platform, AI kod asistanlari pazarinda onemli bir konuma ulasti:
Claude Code Benimseme Istatistikleri
| Metrik | Deger | Kaynak |
|---|---|---|
| Aktif gelistirici sayisi | 115.000+ | PPC Land, Temmuz 2025 |
| Haftalik islenen kod satiri | 195 milyon | PPC Land, Temmuz 2025 |
| Mayis 2025'ten bu yana buyume | %300 | Anthropic, 2025 |
| Gelir artisi | 5.5x | Anthropic, 2025 |
| Aylik API cagrisi | 25 milyar+ | Anthropic, 2025 |
| AI destekli yazilan kod orani (2025) | %41 | GitHub, 2025 |
Anthropic'in kendi ic kullaniminda da etkileyici sonuclar goruluyor: Gunluk islerin %59'u Claude ile yapiliyor ve ortalama %50 verimlilik artisi raporlaniyor (Anthropic, 2025).
Sik Sorulan Sorular
Claude Code skill sistemi ucretsiz mi?
Claude Code skill sistemi Pro, Max, Team ve Enterprise planlarinda kullanilabilir. Skill olusturma ve kullanma icin ek ucret yoktur; ancak Claude Code erisimi icin aktif bir Anthropic aboneligi gereklidir. Topluluk skill'leri acik kaynakli olarak ucretsiz paylasilir.
SKILL.md dosyasi maximum kac satir olmali?
Anthropic, SKILL.md dosyalarini 500 satirin altinda tutmayi onerir. Daha uzun icerikler icin references/ klasorune ek dosyalar ekleyin ve SKILL.md'den referans verin. Bu yaklasim token tuketimini optimize eder ve Claude'un talimatlari daha dogru uygulamasini saglar.
Skill hot reload nasil calisir?
Claude Code 2.1.0 ile gelen hot reload ozelligi, ~/.claude/skills veya .claude/skills dizinlerindeki degisiklikleri oturum yeniden baslatmadan algilar. Onceki surumlerde her degisiklik icin ~2 dakika gereken iterasyon dongusu, hot reload ile ~5 saniyeye dusmustur.
MCP server ile skill arasindaki fark nedir?
Skill'ler Claude'un davranisini ve talimatlarini ozellestirir; MCP server'lar ise harici arac ve veri kaynaklarina erisim saglar. Bir skill "ne yapilacagini" tanimlarken, MCP "hangi araclarla yapilacagini" belirler. Ikisi birlikte kullanildiginda cok guclu otomasyon senaryolari ortaya cikar.
Hook'lar skill disinda da kullanilabilir mi?
Evet, hook'lar skill'lerden bagimsiz olarak ~/.claude/settings.json, .claude/settings.json veya .claude/settings.local.json dosyalarinda tanimlanabilir. Bu durumda hook'lar tum Claude Code oturumlarinda gecerli olur. Skill icindeki hook'lar ise yalnizca o skill aktifken calisir.
Cursor rules ile Claude Code skill farki nedir?
Cursor .cursor/rules dizininde MDX formatinda kural dosyalari kullanir ve glob pattern ile auto-attach destekler. Claude Code skill'leri ise bagimsiz dizinlerde yasir, script/referans dosyalari icerebilir, hook entegrasyonu sunar ve marketplace destegine sahiptir. Skill sistemi daha moduler ve genisletilebilir bir mimari sunar.
Takim genelinde skill'ler nasil paylasilir?
Proje bazli skill'leri .claude/skills/ dizinine koyarak Git ile paylasabilirsiniz. Organizasyon genelinde Enterprise managed settings kullanilir. Toplulukla paylasmak icin GitHub'a yukleyip awesome-claude-skills listesine veya SkillsMP marketplace'e ekleyebilirsiniz.
Skill'de hangi programlama dilleri desteklenir?
Skill'lerin scripts/ dizininde Python, Bash, Node.js ve diger diller kullanilabilir. SKILL.md dosyasinin kendisi Markdown formatindadir. Claude Code, script'leri Bash araciyla calistirir; dolayisiyla sistemde kurulu olan herhangi bir dil ve arac skill script'lerinde kullanilabilir.
Sonuc
Claude Code skill sistemi, AI kod asistanlarini projeye ve ekibe ozel ihtiyaclara gore sekillendirmenin en kapsamli framework'udur. SKILL.md'nin basit yapisi, hook'larin deterministik kontrolu ve MCP'nin genis entegrasyon agi birlikte dusunuldugunde, gelistirici is akislarini kokten donusturme potansiyeli tasir. 115.000+ gelsitiricinin ve buyuyen topluluk ekosisteminin gosterdigi gibi, skill sistemi hizla standart bir gelistirici pratigi haline geliyor.
Ilk skill'inizi olusturarak baslayin — ~/.claude/skills/ dizinine basit bir SKILL.md dosyasi eklemek yeterli.
Son güncelleme: 28 Ocak 2026
Bilgini Sına
1.Claude Code 2.1.0 ile gelen Skill Hot Reload ozelligi iterasyon suresini ne kadar kisaltiyor?
2.Claude Code skill'leri icin en yuksek oncelikli konum hangisidir?
