Techsy
Bize Ulaşın
Başla
Bloga Dön
ai-machine-learning

Claude Skills Eğitimi: İlk SKILL.md Dosyanızı 10 Dakikada Oluşturun (2026)

Yazan Techsy Editorial Team
May 1, 2026
13 okuma
İçindekiler
Claude Skills Eğitimi: İlk SKILL.md Dosyanızı 10 Dakikada Oluşturun (2026)

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.md dosyası 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-creator skill'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:

markdown
---
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

bash
mkdir -p ~/.claude/skills/explain-code

Kiş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:

markdown
---
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:

text
walk me through what auth/middleware.ts does

Claude 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, makul allowed-tools seç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.

Claude Code'un başlangıçta ~/.claude/skills/ ve .claude/skills/ dizinlerini tarayarak her SKILL.md'yi mevcut skill tepsisine yükleme şeklini gösteren diyagram.

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:

AlanZorunlu mu?TürNe zaman kullanılır
nameevet≤64 karakter stringher zaman — slash-komut adı olur
descriptionevet≤1024 karakter stringher zaman — Claude skill'in eşleşip eşleşmediğine bunu tarayarak karar verir
allowed-toolshayıraraç desenleri dizisiskill'i belirli araçlarla kilitlemek için (örn. Bash(git *), Read, Grep)
disable-model-invocationhayırbooleanskill'i yalnızca kullanıcı tarafından çağrılabilir yapmak için (slash-komut, hiçbir zaman otomatik tetiklenmez)
user-invocablehayırbooleanslash-komut paletinde /skill-name olarak görünmesi gereken bir skill'i işaretlemek için
argument-hinthayırstringkullanıcıya $ARGUMENTS'ın ne içermesi gerektiğine dair ipucu vermek için
modelhayırstringskill'i belirli bir modele sabitlemek için (örn. claude-opus-4-7)
contexthayırdefault veya fork(Skills 2.0) ana iş parçacığını kirletmemesi için skill'i çatallanmış bir bağlam penceresinde çalıştırır
globshayırglob desenleri dizisiglob'larla eşleşen dosyalar kapsama girdiğinde skill'i otomatik önermek için
referenceshayırdosya yolları dizisiskill gövdesiyle birlikte yüklenen referans belgelerini paketlemek için
bundled-fileshayırdosya yolları dizisiskill'in çalıştırabileceği betikleri paketlemek için
tagshayırstring dizisimarketplace 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:

yaml
---
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)

markdown
---
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)

markdown
---
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 description alanı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.

SoruSkill'lerMCPAlt AjanlarHook'lar
Tetikleyenprompt eşleşmesi veya /slashcmdmodel bir araç çağırmaya karar verirmodel bir görevi devederClaude 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ğutekrar 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ğlamlarher zaman tetiklenmesi gereken deterministik olaylar
Determinizmolasılıksal (Claude seçer)olasılıksal (Claude seçer)olasılıksal (Claude seçer)deterministik (her zaman tetiklenir)
Token maliyetidüşü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 KULLANMAYINcanlı veri, deterministik olaylarstatik iş akışları, prompt mantığıtek seferlik deterministik eylemlerdallanma 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.

KapsamYolPaylaşımEn uygun olduğu
Kişisel~/.claude/skills/paylaşılmazkendi 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 kurulurAnthropic Marketplace veya URLrepo arası yeniden kullanım, topluma dağıtım
Kurumsalorg yöneticisi tarafından zorlanır (yönetilen ayarlar)org genelinde uygulanıruyum zorunlu iş akışları, güvenlik kilitli araçlar
Paketlenmiş (yerleşik)Claude Code ile geliryokdoc 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.

Claude Code mimarisini gösteren diyagram: Dört katman: Skill'ler (iş akışı şablonları), MCP (veri düzlemi), Alt Ajanlar (devir), Hook'lar (olaylar). Oklar çalışma zamanında nasıl birleştiklerini gösterir.

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

yaml
---
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

yaml
---
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)

yaml
---
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.

Etiketler

claude skillsclaude codeSKILL.mdagent skills standardıMCPclaude eğitimi

Bu makaleyi paylaş

İlgili Makaleler

Daha fazla ai-machine-learning

ai-machine-learning
Aug 8, 2026

LLM Gözlemlenebilirlikte Sessions, Traces ve Spans: Bunlardan Biri Yapısal Seviye Değil

LLM gözlemlenebilirlikte session'lar, trace'ler ve span'ler iç içe geçer; ancak OpenTelemetry GenAI şartnamesi bunlardan yalnızca ikisini yapısal seviye olarak tanımlar. Her kavramın gerçekte nerede durduğunu haritalamak için beş sağlayıcının dokümanını ve şartnamenin kendisini okuduk.

13 dk okuma okuma
Oku
ai-machine-learning
Aug 8, 2026

Serverless GPU'da LLM Dağıtımı: 5 Platform, Gerçek Fiyatlar, Dürüst Cold Start Verileri

Beş serverless GPU platformu $/GPU-saat cinsinden yan yana karşılaştırıldı: sağlayıcıların yayınlamadığı cold start rakamları ve kimsenin vermediği model depolama yanıtı.

12 dk okuma okuma
Oku
ai-machine-learning
Aug 7, 2026

AI Ajan İş Akışı Desenleri: 7 Desen ve Her Birinin Gerçekte Ne Zaman Kazandığı (2026)

Yedi AI ajan iş akışı deseni her satıcı sınıflandırmasında tekrar tekrar karşımıza çıkıyor, ama hiçbiri her yerde kazanmıyor. Bu yazıda desenleri Google Research ve Anthropic'in yayımlanmış 2026 benchmark verileriyle, aritmetiği göstererek, her yapı için çalıştırılabilir Python koduyla ve seçim yapmanızı sağlayan bir karar merdiveniyle sıralıyoruz.

13 dk okuma okuma
Oku
Tüm Yazıları Görüntüle
Projenize Başlayın

Harika bir şey inşa etmeye hazır mısınız?

Vizyonunuzu hayata geçirelim. Fark yaratan yazılımlar için ekibimiz hazır.

30 dakikalık keşif görüşmesi ayarlayınProjelerimiz

Kütüphaneden öne çıkanlar

Claude Skills

Tümünü gör
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

AI Otomasyonları

Tümünü gör
  • Güvenlik Denetçisi

    Önceliklendirilmiş düzeltme PR'larıyla haftalık SCA + IaC taraması.

  • Soğuk E-posta Yazarı

    Tek bir somut kamuya açık detaya dayalı ilk temas e-postaları üretir.

  • Lead Araştırma Agent'ı

    Bir e-postayı profile zenginleştirir, uygunluğu puanlar, Slack'te uyarır.

Kütüphaneden öne çıkanlar

Claude Skills

Tümünü gör
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

AI Otomasyonları

Tümünü gör
  • Güvenlik Denetçisi

    Önceliklendirilmiş düzeltme PR'larıyla haftalık SCA + IaC taraması.

  • Soğuk E-posta Yazarı

    Tek bir somut kamuya açık detaya dayalı ilk temas e-postaları üretir.

  • Lead Araştırma Agent'ı

    Bir e-postayı profile zenginleştirir, uygunluğu puanlar, Slack'te uyarır.

Hizmetler

  • Kurumsal Çözümler
  • Mobil Uygulamalar
  • Web Uygulamaları

Çözümler

  • CRM Sistemleri
  • Yapay Zeka Entegrasyonu
  • ERP Çözümleri
  • Sesli Asistanlar
  • Süreç Otomasyonu
  • Siber ve Veri Güvenliği

Kütüphane

  • Blog
  • Portfolyo

Topluluk

  • AI Otomasyonları
  • Claude Skills

Araçlar

  • Mobil Uygulama Maliyet Hesaplayıcı
  • OpenAI / LLM API Maliyet Hesaplayıcı
  • MVP Maliyet Hesaplayıcı
  • Sesli AI Ajan Maliyet Hesaplayıcı

Şirket

  • Hakkımızda
  • Partnerler
  • İletişim

Yasal

  • Gizlilik Politikası
  • Kullanım Şartları
  • Çerez Politikası

Hizmetler

  • Kurumsal Çözümler
  • Mobil Uygulamalar
  • Web Uygulamaları

Çözümler

  • CRM Sistemleri
  • Yapay Zeka Entegrasyonu
  • ERP Çözümleri
  • Sesli Asistanlar
  • Süreç Otomasyonu
  • Siber ve Veri Güvenliği

Kütüphane

  • Blog
  • Portfolyo

Topluluk

  • AI Otomasyonları
  • Claude Skills

Araçlar

  • Mobil Uygulama Maliyet Hesaplayıcı
  • OpenAI / LLM API Maliyet Hesaplayıcı
  • MVP Maliyet Hesaplayıcı
  • Sesli AI Ajan Maliyet Hesaplayıcı

Şirket

  • Hakkımızda
  • Partnerler
  • İletişim
YasalGizlilik PolitikasıKullanım ŞartlarıÇerez Politikası
TECHSY
© 2026 Techsy. Tüm hakları saklıdır.