
Claude Skills Eğitimi: İlk SKILL.md Dosyanızı 10 Dakikada Oluşturun (2026)
Skill'ler, muhtemelen henüz kullanmadığınız en önemli Claude Code özelliği. Bir Claude skill'i, promptunuz açıklamasıyla eşleştiği anda Claude'un otomatik olarak yüklediği bir SKILL.md dosyası içeren bir klasördür — prompt kopyalayıp yapıştırmak yok, şişirilmiş CLAUDE.md yok, hangi şablonu açacağınızı hatırlamak yok. Bu repodaki .claude/skills/agent/ klasöründe 4 skill yayınladık; Skills 2.0 ve Anthropic Marketplace'in 2026 başında hayata geçmesiyle birlikte format artık gerçek olgunluğuna erişiyor. İşte tuzaklardan sonra işe yarayan desen.
Önemli çıkarımlar
- Claude skill'i, Claude'un ilgili olduğunda otomatik yüklediği YAML frontmatter'lı bir
SKILL.mddosyası içeren klasördür.- Skill'ler
~/.claude/skills/(kişisel) veya.claude/skills/(proje) dizinine yerleştirilir — Claude başlangıçta her ikisini de tarar.- Tekrar eden iş akışları için Skill'leri, canlı dış veriler için MCP'yi, çok adımlı planlama için alt ajanları, deterministik olaylar için ise hook'ları kullanın.
- İlk skill'e ulaşmanın en hızlı yolu: Claude'dan kendi
skill-creatorskill'ini çağırmasını istemek — SKILL.md dosyasını sizin için yazar.
Claude Skill'i Nedir?
Claude skill'i, Claude Code'un promptunuz açıklamayla eşleştiğinde otomatik olarak bağlama yüklediği YAML frontmatter'lı (name, description, isteğe bağlı allowed-tools) bir SKILL.md dosyası içeren klasördür. Skill'ler, sistem promptunu şişirmeden /commit veya /explain-code gibi tekrar eden iş akışlarını paketler.
Anthropic'in resmi belgelerine göre her skill klasöründe üç şey bulunur: zorunlu bir SKILL.md, isteğe bağlı paketlenmiş betikler (Python yardımcısından JSON yapılandırmasına kadar her şey) ve gövdeyle birlikte yüklenen isteğe bağlı referans belgeleri. Hepsi bu. Derleme adımı yok, kurulum yok, manifest yok.
Zekice olan kısım aşamalı açılım. Başlangıçta Claude yalnızca her skill'in description alanını tarar. Gövde — talimatlar, örnekler, araç çağrısı desenleri — promptunuz gerçekten eşleşene kadar diskte kalır. Yani 50 skill kurulu olabilir ve biri tetiklenene kadar sıfır token maliyeti ödersiniz.
Skill'leri, promptunuzdaki malzemeleri görünce Claude'un açtığı yemek kitabı tarifleri gibi düşünün. Skill, Claude'un talep üzerine okuduğu bir klasördür — hatırlamanız gereken bir prompt değil. Tüm mesele bu.
Minimal bir SKILL.md şöyle görünür:
---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---
Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.On satır. Gerçek bir skill. Tetiklenmeye hazır.
Hızlı Başlangıç: İlk Skill'inizi 10 Dakikada Oluşturun
İlk Claude skill'inizi 10 dakikada oluşturmak için: (1) ~/.claude/skills/explain-code/ oluşturun, (2) name, description ve iş akışı gövdesini içeren bir SKILL.md dosyası ekleyin, (3) yeni dizini taraması için Claude Code'u yeniden başlatın, (4) açıklamayla eşleşen bir promptla tetikleyin.
İşte tam akış.
Adım 1: Dizini oluşturun
mkdir -p ~/.claude/skills/explain-codeKişisel skill'ler (yalnızca sizin için) ~/.claude/skills/ altına gider. Proje skill'leri (git aracılığıyla ekibinizle paylaşılan) repo kökünizdeki .claude/skills/ altına gider. Günlük kullanım iş akışları için kişiseli; repodaki her katkıcının bunu devralmasını istiyorsanız projeyi seçin.
Adım 2: SKILL.md'yi yazın
Bu dosyayı ~/.claude/skills/explain-code/SKILL.md konumuna ekleyin:
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---
You are explaining code to a developer who is new to this codebase.
1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.Skill'in tamamı bu. Frontmatter sözleşmedir; gövde ise oyun kitabı.
Adım 3: Claude Code'u yeniden başlatın
Canlı keşif bir Skills 2.0 özelliğidir — eski Claude Code sürümleri yeni dizini alabilmek için yeni bir başlangıca ihtiyaç duyar. Hangi sürümde olduğunuzdan emin değilseniz, bir kez yeniden başlatmak hiçbir şeye mal olmaz.
Adım 4: Tetikleyin
Bir proje açın ve şunu yazın:
walk me through what auth/middleware.ts doesClaude promptunuzu description alanıyla karşılaştırır, explain-code'u bulur ve SKILL.md gövdesini sessizce bağlama yükler. Araç günlüğünde "Using skill: explain-code" mesajını göreceksiniz. Tamam.
İpucu: Dosyayı kendiniz yazmakla uğraşmak istemiyor musunuz? Claude Code'u açın ve şunu söyleyin:
Use the skill-creator skill to scaffold an explain-code skill for me.Anthropic'in paketlenmişskill-creator'ı sizi sorgulayan, makulallowed-toolsseçen ve SKILL.md'yi doğru klasöre yazan bir meta-skill'dir. İlk skill'e ulaşmanın kesinlikle en hızlı yolu.
10 dakikalık söz bu kadar — beş dakika yazmak, bir yeniden başlatma, bir test promptu.

SKILL.md İçinde: Frontmatter Referansı
SKILL.md frontmatter, --- sınırlayıcılarıyla sarılmış YAML'dır. İki alan zorunludur: name (≤64 karakter, slash-komut adı olarak kullanılır) ve description (Claude'un promptunuzla eşleştirdiği tetikleyici metin). İsteğe bağlı alanlar araç erişimini, model çağrısını, dosya glob'larını ve çalıştırma bağlamını kontrol eder.
İşte Anthropic'in skills belgelerinden alınan tam referans:
| Alan | Zorunlu mu? | Tür | Ne zaman kullanılır |
|---|---|---|---|
name | evet | ≤64 karakter string | her zaman — slash-komut adı olur |
description | evet | ≤1024 karakter string | her zaman — Claude skill'in eşleşip eşleşmediğine bunu tarayarak karar verir |
allowed-tools | hayır | araç desenleri dizisi | skill'i belirli araçlarla kilitlemek için (örn. Bash(git *), Read, Grep) |
disable-model-invocation | hayır | boolean | skill'i yalnızca kullanıcı tarafından çağrılabilir yapmak için (slash-komut, hiçbir zaman otomatik tetiklenmez) |
user-invocable | hayır | boolean | slash-komut paletinde /skill-name olarak görünmesi gereken bir skill'i işaretlemek için |
argument-hint | hayır | string | kullanıcıya $ARGUMENTS'ın ne içermesi gerektiğine dair ipucu vermek için |
model | hayır | string | skill'i belirli bir modele sabitlemek için (örn. claude-opus-4-7) |
context | hayır | default veya fork | (Skills 2.0) ana iş parçacığını kirletmemesi için skill'i çatallanmış bir bağlam penceresinde çalıştırır |
globs | hayır | glob desenleri dizisi | glob'larla eşleşen dosyalar kapsama girdiğinde skill'i otomatik önermek için |
references | hayır | dosya yolları dizisi | skill gövdesiyle birlikte yüklenen referans belgelerini paketlemek için |
bundled-files | hayır | dosya yolları dizisi | skill'in çalıştırabileceği betikleri paketlemek için |
tags | hayır | string dizisi | marketplace listelerinde skill'leri düzenlemek için |
context: fork satırı dikkat çekici. Bu, skill'i izole bir bağlam penceresinde çalıştıran bir Skills 2.0 primitif'idir — uzun süreli araştırma skill'leri veya ana iş parçacığınızı kirletmek istemediğiniz çok sayıda ara token üreten her şey için kullanışlıdır. Bu konuda yeniyseniz, context engineering rehberimiz değiş tokuşları kapsamaktadır.
Her alan doldurulmuş maksimalist bir SKILL.md frontmatter:
---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---İpucu:
description'daki en yaygın hata: onu insanlar için yazmak. Claude için yazın — somut tetikleyici ifadeler, pazarlama metni değil. Kötü: "Güçlü bir Git otomasyon skill'i." İyi: "Kullanıcı değişiklikleri commit'lemek, commit mesajı yazmak veya PR açmak istediğinde kullanın."
İki Gerçek Skill, Baştan Sona
İki skill deseni, gerçek dünya kullanımının %80'ini karşılar: (1) deterministik eylemler için disable-model-invocation: true ve allowed-tools: Bash(git *) içeren kullanıcı tarafından çağrılabilir /commit skill'i; (2) promptlar açıklamasıyla eşleştiğinde Claude'un tetiklediği varsayılan frontmatter'lı otomatik çağrılan /explain-code skill'i.
Çoğu eğitim snippet gösterir. İşte bugün ~/.claude/skills/ dizinine kopyalayabileceğiniz iki tam dosya.
/commit skill'i (kullanıcı tarafından çağrılabilir)
---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
- "Bash(git status:*)"
- "Bash(git diff:*)"
- "Bash(git add:*)"
- "Bash(git commit:*)"
---
1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.Test promptu: /commit
Ne olur: Claude git durumunu inceler, bir mesaj taslağı hazırlar, onaylamanızı ister ve yalnızca bundan sonra git commit çalıştırır. disable-model-invocation: true, "değişikliklerimi kaydet" gibi belirsiz bir promptta asla otomatik tetiklenmeyeceği anlamına gelir — yalnızca /commit yazdığınızda çalışır. allowed-tools beyaz listesi onu git alt komutlarıyla kilitler; fiziksel olarak rm -rf çalıştıramaz veya uzak sunucuya push yapamaz. Bu, kendi pipeline'ımızda canlı olarak yayınladığımız bir skill.
Deterministik commit sonrası eylemler için (lint çalıştırma, tip yeniden oluşturma, Slack webhook'u ping'leme) bunun yerine Claude Code hooks kullanın — skill'ler olasılıksal, hook'lar her seferinde tetiklenir.
/explain-code skill'i (model tarafından çağrılabilir)
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---
1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.Test promptu: walk me through what auth/middleware.ts does
Ne olur: kullanıcının /explain-code yazmadığına dikkat edin. Claude "walk me through" ifadesini description alanıyla eşleştirir, skill'i bulur ve otomatik olarak çağırır. İşte sihir bu — yönlendirmeyi description yapıyor. model: claude-opus-4-7 alanı, varsayılan modeliniz ne olursa olsun bu skill'i her zaman Opus'a sabitler; derin kod açıklamaları her zaman daha akıllı modeli kullanır. (Farklı modelleri Claude Code ile çalıştırmak hakkında daha fazla bilgi.)
Neden iki desen? Skill #1 kullanıcı tarafından çağrılabilir + belirli araçlarla kilitli — öngörülebilir, güvenli, git veya deployment için mükemmel. Skill #2 otomatik çağrılır + açık uçlu — skill'lerin sihrini taşır ama
descriptionalanınıza güvenin. Kullanıcı tarafından çağrılabilir skill'ler öngörülebilirlik; model tarafından çağrılabilir skill'ler sihir sunar. Repo başına değil, skill başına seçin.
Daha fazla gerçek skill örneği için resmi anthropics/skills reposuna ve topluluk tarafından tutulan awesome-claude-skills listesine bakın.
Skill'ler, MCP, Alt Ajanlar ve Hook'lar: Ne Zaman Ne Kullanılır?
Claude'un otomatik tetiklemesi veya slash-komut olarak çağırmanız gereken tekrar eden iş akışları için Skill'leri kullanın. Canlı harici veriler için (veritabanları, API'lar, çalışma dizininin ötesindeki dosya sistemleri) MCP sunucularını kullanın. Claude'un taze bir bağlama devretmesi gereken çok adımlı planlar için alt ajanları kullanın. Her zaman tetiklenmesi gereken — asla olasılıksal olmayan — deterministik olaylar için (pre-commit, post-tool-use) hook'ları kullanın.
Hızlı çerçeve: skill'ler iş akışları, Model Context Protocol veri, alt ajanlar planlar, hook'lar olaylar. Her biri Claude Code'un farklı bir katmanında yaşar ve yanlış katman yanlış araçtır. Anthropic'in kendi Skills explained yazısına göre bu, içselleştirmenizi istedikleri çerçeve.
| Soru | Skill'ler | MCP | Alt Ajanlar | Hook'lar |
|---|---|---|---|---|
| Tetikleyen | prompt eşleşmesi veya /slashcmd | model bir araç çağırmaya karar verir | model bir görevi deveder | Claude Code olayı (pre-tool-use, post-edit) |
| Bulunduğu yer | .claude/skills/ | harici sunucu (stdio veya SSE) | .claude/agents/ | settings.json hooks bloğu |
| En uygun olduğu | tekrar eden iş akışları, mantıklı prompt şablonları | canlı veri, üçüncü taraf API'lar, cwd dışındaki dosya sistemi erişimi | çok adımlı planlama, paralel çalışma, izole bağlamlar | her zaman tetiklenmesi gereken deterministik olaylar |
| Determinizm | olasılıksal (Claude seçer) | olasılıksal (Claude seçer) | olasılıksal (Claude seçer) | deterministik (her zaman tetiklenir) |
| Token maliyeti | düşük (yalnızca description taramada yüklenir) | orta-yüksek (araç tanımları + yanıtlar) | yüksek (her devir için taze bağlam) | hiçbiri (bant dışı shell yürütmesi) |
| Ne zaman KULLANMAYIN | canlı veri, deterministik olaylar | statik iş akışları, prompt mantığı | tek seferlik deterministik eylemler | dallanma mantığı, olasılıksal olan her şey |
Bunlar birleşir. Bir skill, allowed-tools aracılığıyla bir MCP aracı çağırabilir. Bir hook, bir skill tamamlandıktan sonra tetiklenebilir. Bir alt ajan, erişim verilmiş skill'leri kullanabilir. En net zihinsel model: önce doğru katmanı seçin, sonra birbirinin üzerine inşa edin. Skill'ler, Claude'un seçmesini istediğiniz bir iş akışı olduğunda ulaştığınız context-engineering primitif'idir; Claude'un atlayamayacağı bir şey istediğinizde hook'larla otomatize edersiniz.
Her birini kötüye kullanmanın en kötü yolu: canlı veri için Skill'ler (MCP kullanın); tek seferlik prompt şablonları için MCP (Skill kullanın); deterministik dosya düzenlemeleri için alt ajanlar (hook kullanın); dallanma mantığı için hook'lar (Skill kullanın). Skill'ler iş akışı, MCP veri, alt ajanlar plan, hook'lar olaydır. Buzzword'e göre değil, katmana göre seçin.
Skill'lerin Konumu: Kişisel, Proje, Eklenti, Kurumsal
Claude skill'leri dört kapsamda kurulur: kişisel (~/.claude/skills/, yalnızca siz), proje (repo kökündeki .claude/skills/, git aracılığıyla ekibiniz), eklenti (Anthropic Marketplace veya herhangi bir eklenti URL'si aracılığıyla dağıtılan) ve kurumsal (BT tarafından MDM/yönetici politikası aracılığıyla zorlanan). Claude başlangıçta dört kapsamı da tarar.
| Kapsam | Yol | Paylaşım | En uygun olduğu |
|---|---|---|---|
| Kişisel | ~/.claude/skills/ | paylaşılmaz | kendi günlük iş akışlarınız (commit, review, PR yazma) |
| Proje | .claude/skills/ (repo kökü) | git, repodaki her katkıcı | ekip kuralları, kod tabanına özgü desenler |
| Eklenti | /plugin install <url> aracılığıyla kurulur | Anthropic Marketplace veya URL | repo arası yeniden kullanım, topluma dağıtım |
| Kurumsal | org yöneticisi tarafından zorlanır (yönetilen ayarlar) | org genelinde uygulanır | uyum zorunlu iş akışları, güvenlik kilitli araçlar |
| Paketlenmiş (yerleşik) | Claude Code ile gelir | yok | doc skill'leri (pdf, docx, pptx, xlsx), /debug, /simplify |
Paketlenmiş doc skill'lerini unutmak kolay — Claude Code zaten kutudan çıktığı gibi pdf, docx, pptx ve xlsx skill'lerini, ayrıca küçük bir /debug, /simplify ve benzeri yerleşik kütüphanesi ile birlikte gelir. (Kardeş araç Claude Design, tasarım oluşturma için kendi paketlenmiş iş akışı skill'lerini sunar; aynı model, farklı alan.)
Proje yerine eklenti aracılığıyla ne zaman yayınlarsınız? Aynı iş akışı birden fazla repodan faydalandığında eklentiler kazanır — beş istemci kod tabanında kullandığınız bir /release skill'i her repodaki .claude/skills/ yerine eklentiye ait. Proje skill'leri, kod tabanına özgü kurallar (ekibinizin PR şablonu, özel test koşucunuz) için kazanır. Anthropic Marketplace artı herhangi bir URL'den /plugin install, repo arası yeniden kullanım için eklentileri doğru cevap haline getirir. Eklenti belgelerine göre keşif ve güncellemeler otomatik olarak gerçekleştirilir.

Gelişmiş Desenler: $ARGUMENTS, Dinamik Shell Enjeksiyonu, context: fork
En önemli üç gelişmiş skill deseni: $ARGUMENTS, kullanıcıların kullanıcı tarafından çağrılabilir skill'lere parametre geçirmesine izin verir (/translate $ARGUMENTS); dinamik shell enjeksiyonu (allowed-tools: Bash(...) ile) bir skill'in betikleri çalıştırmasına ve çıktıyı bağlama aktarmasına olanak tanır; context: fork (Skills 2.0) skill'i izole bir bağlam penceresinde çalıştırır. Anthropic'in Complete Guide teknik raporu, Mayıs 2026 itibarıyla context: fork için kanonik referans kaynağıdır.
Parametreli skill'ler için $ARGUMENTS
---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---
Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.Test promptu: /translate spanish. Claude çalışma zamanında spanish'i $ARGUMENTS ile değiştirir. Varyantlar yazmadan bir skill'i çok amaçlı yapmanın en temiz yolu.
allowed-tools aracılığıyla dinamik shell enjeksiyonu
---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---
Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.Skill shell'e çıkar, diff'i bağlama aktarır ve inceler. allowed-tools'u belirli komutlarla kilitleyin (Bash(git diff HEAD~1:*)), asla açık Bash kullanmayın — açık Bash izni bu desenin güvenlik açığıdır.
context: fork (Skills 2.0)
---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---
Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.Fork, skill'e kendi bağlam penceresini verir; böylece 50 bin token'lık ara araştırma notları ana oturumunuza sızmaz. Uzun araştırma, büyük yeniden yapılandırma planlaması veya çok sayıda tek kullanımlık token üreten her şey için kullanışlıdır. Yalnızca Skills 2.0 — eski Claude Code sürümleri alanı yok sayar.
Sorun Giderme: Skill'iniz Neden Tetiklenmiyor?
Skill'ler genellikle dört nedenden biriyle tetiklenemez: (1) description Claude'un promptunuzla eşleştiremeyeceği kadar genel, (2) dizin yanlış konumda (.claude/skills/ değil claude/skills/), (3) skill eklendikten sonra Claude Code yeniden başlatılmadı (yalnızca Skills 2.0 öncesi), veya (4) skill adı paketlenmiş veya daha yüksek öncelikli bir skill ile çakışıyor. Claude Code GitHub issue takipçisindeki en çok Googlelanan başarısızlık modlarına göre bu dört tanesi "neden çalışmıyor" raporlarının ~%95'ini kapsıyor.
Başarısızlık modu 1: "Skill'im hiç görünmüyor"
Birinci neden yanlış yol — .claude/skills/ (noktalı) ile claude/skills/ (noktasız) arasındaki yazım hatası, hepimizin gece 1'de yaptığı bir hatadır. ls -la ~/.claude/skills/ komutunu çalıştırarak dizinin noktayla mevcut olduğunu doğrulayın. Varsa ve Claude hâlâ görmüyorsa, Claude Code'u bir kez yeniden başlatın. Skills 2.0 öncesi sürümler yalnızca başlangıçta tarar.
Başarısızlık modu 2: "Claude skill'imi otomatik çağırmıyor"
description alanı çok belirsiz ya da Claude için değil insanlar için yazılmış. Kullanıcıların istekleri gerçekte nasıl ifade ettiğini yansıtan somut tetikleyici ifadelerle yeniden yazın. Bu repo için 4 skill oluşturduktan sonra karşılaştığım tuzak, "SEO için yardımcı bir skill" gibi açıklamalar bırakmaktı. İşe yaramaz. Şöyle yeniden yazın: "Kullanıcı bir Markdown yazısına JSON-LD şeması, meta etiketleri veya SEO frontmatter eklemek istediğinde kullanın." Tetikleme doğruluğu ~%30'dan ~%95'e çıktı. Tetikleme doğruluğu description alanında yaşar ya da ölür. Claude için yazın, özgeçmişiniz için değil.
Başarısızlık modu 3: "Açıklama slash-komut paletinde kesildi"
description 1024 karakterin üzerinde veya name 64 karakterin üzerinde. Her ikisinin de sınırı var. Düzeltme: skill'i iki daha dar skill'e bölün ya da uzun detayı SKILL.md gövdesine taşıyın. Frontmatter yönlendirme içindir, dokümantasyon için değil.
Başarısızlık modu 4: "Canlı değişiklik algılama çalışmıyor"
Skills 2.0 öncesi Claude Code, herhangi bir SKILL.md düzenlemesinden sonra tam yeniden başlatma gerektirir. Bir skill üzerinde iterasyon yapıyorsanız ve değişiklikleriniz alınmıyorsa, büyük olasılıkla eski bir yapıdasınızdır. Skills 2.0 ile gelen bir Claude Code sürümüne (canlı keşif) yükseltin ya da her kayıt sonrası yeniden başlatma alışkanlığı edinin. Can sıkıcı, ama bedeli yok.
Claude Ötesindeki Skill'ler: Açık Ajan Skills Standardı
Evet — skill'ler bir açık standarttır. agentskills.io'daki Ajan Skills standardı, SKILL.md formatını herhangi bir satıcıdan bağımsız olarak tanımlar. OpenAI'nin Codex CLI'si ve ChatGPT Desktop, standardı Aralık 2025'te benimsedi; Claude Code için yazdığınız aynı SKILL.md, küçük frontmatter değişiklikleriyle Codex'te çalışır.
Mayıs 2026 itibarıyla araç arası destek matrisi: Claude Code tam Ajan Skills desteğine sahip (referans uygulama). OpenAI'nin Codex CLI'si tam destek sunuyor. ChatGPT Desktop kısmi destek — name, description ve gövde çalışıyor, ancak allowed-tools paritesi henüz yok. Gemini CLI 2026 başında destek duyurdu ama bu yazı yazılırken henüz yayınlamamıştı. Cursor ise farklı — kendi Cursor rules formatını kullanıyor ve SKILL.md'yi yerel olarak okumasa da topluluk şimleri mevcut.
Skill'lerinizin yıl boyunca hayatta kalması için bugün ne yazmalısınız: name ve description'ı temiz ve araç-agnostik tutun. Çapraz araç kullanıyorsanız, satıcıya özgü frontmatter'ı bir ad alanının arkasına izole edin (claude: veya codex:). Taşınabilir yüzey — name, description, gövde, $ARGUMENTS — her yerde çalışır; context: fork gibi gelişmiş alanlar, diğer satıcılar eşdeğerlerini sunana kadar Claude'a özgüdür. Anthropic ayrıca sızdırılan Claude Code yol haritasına göre daha derin marketplace entegrasyonu için bastırıyor, dolayısıyla taşınabilirlik yalnızca kolaylaşacak.
Örnek skill aramak için üç yer: anthropics/skills (resmi), awesome-claude-skills (topluluk) ve agentskills.io (standardın özellik sayfası). Skill'ler artık yalnızca bir Claude özelliği değil. Anthropic'in öncülük ettiği açık bir standarttır.
Sıkça Sorulan Sorular
Claude skill'i ile MCP sunucusu arasındaki fark nedir?
Claude skill'i, promptunuz açıklamasıyla eşleştiğinde Claude'un yüklediği iş akışı talimatları içeren bir SKILL.md dosyasıdır. MCP sunucusu ise Claude'un canlı veri almak için çağırdığı ayrı bir işlemdir (veritabanları, API'lar, çalışma dizininin ötesindeki dosya sistemleri). İş akışları için Skill'leri; veriler için MCP kullanın. Bunlar birleşir — skill'ler MCP araçlarını çağırabilir.
Claude skill'leri ücretsiz mi?
Evet — Skill'ler yerleşik bir Claude Code özelliğidir, ekstra ücret yoktur. Yalnızca bir skill çalıştığında tüketilen model token'ları için ödeme yaparsınız. Anthropic Marketplace'ten kurduğunuz skill'ler ücretli olabilir (bugün nadir), ancak resmi anthropics/skills reposu ve topluluk awesome-listeleri kopyalanıp kullanılmak üzere tamamen ücretsizdir.
Claude skill'leri nereye kurulur?
Kişisel skill'ler ~/.claude/skills/{skill-adı}/ dizinine, proje skill'leri ise repo kökünüzdeki .claude/skills/{skill-adı}/ dizinine gider. Eklenti skill'leri /plugin install <url> aracılığıyla kurulur ve eklenti dizininizde bulunur. Kurumsal skill'ler, yönetilen ayarlar aracılığıyla BT ekibiniz tarafından zorlanır. Claude Code başlangıçta dört kapsamı da tarar.
Sıfırdan nasıl Claude skill oluştururum?
~/.claude/skills/ altında bir klasör oluşturun, YAML frontmatter'lı (name, description) bir SKILL.md dosyası ekleyin ve ardından iş akışı talimatlarını yazıp Claude Code'u yeniden başlatın. En hızlı yol: Claude Code'u açın ve paketlenmiş skill-creator skill'ini çağırmasını isteyin — SKILL.md'yi bir dakikadan kısa sürede sizin için iskeletler.
Claude skill'im neden tetiklenmiyor?
Dört yaygın neden: (1) description Claude'un promptunuzla eşleştiremeyeceği kadar belirsiz — somut tetikleyici ifadelerle yeniden yazın; (2) skill yanlış yolda (.claude/skills/ değil claude/skills/); (3) Skills 2.0 öncesi sürümlerde Claude Code yeniden başlatmaya ihtiyaç duyar; (4) skill adı paketlenmiş bir skill ile çakışıyor. ls -la ~/.claude/skills/ ile doğrulayın.
ChatGPT veya Cursor, Claude skill'lerini kullanabilir mi?
ChatGPT Desktop ve Codex CLI, Claude ile aynı Ajan Skills standardını destekler — aynı SKILL.md, küçük frontmatter değişiklikleriyle her ikisinde de çalışır. Cursor kendi Cursor rules formatını kullanır ve SKILL.md'yi yerel olarak okumaz. Gemini CLI 2026 başında destek duyurdu ancak Mayıs 2026 itibarıyla henüz yayınlamamıştı.
skill-creator skill'i ne yapar?
skill-creator, Claude'un sizin için yeni SKILL.md dosyaları yazmasına yardımcı olan anthropics/skills reposunda paketlenmiş bir meta-skill'dir. Claude'a skill'in ne yapmasını istediğinizi söyleyin; skill-creator description için sizi sorgular, makul allowed-tools seçer ve SKILL.md'yi doğru klasöre yazar. Mümkün olan en hızlı iskelet.
disable-model-invocation ne işe yarar?
Skill'inizin frontmatter'ına disable-model-invocation: true eklemek, Claude'un skill'i prompt eşleştirmesine göre otomatik tetiklemesini engeller. Skill yalnızca kullanıcı tarafından çağrılabilir hale gelir — slash-komut paletinde /skill-adı olarak görünür ve yalnızca açıkça çağrıldığında çalışır. /commit veya /deploy gibi yıkıcı veya deterministik eylemler için kullanın.
Birkaç skill oluşturun, bir projede yayınlayın, neyin tutunduğuna bakın. Ekibiniz birden fazla repoda "skill tetiklenmiyor" sorunlarıyla karşılaşıyorsa ve .claude/skills/ kurulumunuz için ikinci bir göze ihtiyaç duyuyorsanız, iletişime geçin — sevinçle birlikte inceleriz.