Claude Code skills

Claude Code, Agent Skills'in ortaya çıktığı yerdir ve hâlâ onlardan en iyi şekilde yararlanan araçtır: buradaki skill'ler tam ağ erişimiyle betik çalıştırabilir, argüman alabilir, kendi subagent'ında çalışabilir ve hâlihazırda sahip olabileceğiniz özel slash komutlarının yerini alabilir. Bu kılavuz özellikle Claude Code tarafını ele alır. Formatın geneli ve skill'lerin nereden geldiği hakkında bilgi için Claude skills and agent skills sayfasına bakın.

Claude Code'un dokümantasyonunu ve komut referansını 14 Kasım 2026'da okuduk. Bu kılavuzun üstündeki liste, HostedMCP kataloğundaki her skill'i Claude Code'da kurmak için gereken komutla birlikte gösterir.

Claude Code'un baktığı yerler

Kapsam	Klasör	Kimler erişir
Kişisel	~/.claude/skills/<name>/SKILL.md	Siz, her projede
Proje	.claude/skills/<name>/SKILL.md	Depoyu klonlayan herkes
İç içe	<subfolder>/.claude/skills/<name>/SKILL.md	Monorepo'nun o bölümünde çalışanlar
Eklenti	<plugin>/skills/<name>/SKILL.md	Eklentiye sahip herkes, /plugin:name olarak
Kuruluş	Yönetilen ayarlar klasörü	O politikaya tabi herkes

İki skill aynı adı paylaşırsa kuruluşun skill'i sizinkini, sizinki de projeninkini geçersiz kılar. claude.ai üzerinde etkinleştirdiğiniz skill'ler ~/.claude/skills/synced/ dizinine senkronize edilir.

Bir tane oluşturun

mkdir -p .claude/skills/release-notes

Ardından .claude/skills/release-notes/SKILL.md dosyasını yazın:

---
name: release-notes
description: Write release notes from merged pull requests. Use when the user asks for release notes, a changelog entry or a summary of what shipped.
---

1. List pull requests merged since the last tag with `gh pr list --state merged`.
2. Group them under Added, Changed and Fixed.
3. Write one plain sentence per change, for users rather than developers.

Bu, çalışan bir skill'dir. Claude Code yeniden başlatmaya gerek kalmadan bunu algılar. Release notes isteyin, kullanır; ya da /release-notes yazın.

SKILL.md dosyasını 500 satırın altında tutun ve uzun içerikleri, talimatların işaret ettiği yanındaki dosyalara taşıyın. Anthropic'in skill-creator eklentisi, /plugin install skill-creator@claude-plugins-official, bir skill'i yüklü ve yüklü değilken test edip açıklamasını ayarlayabilir.

Çağırma

Frontmatter	/name yazabilirsiniz	Claude kendi kendine kullanır	Bağlamdaki açıklama
Varsayılan	Evet	Evet	Her zaman
disable-model-invocation: true	Evet	Hayır	Hayır
user-invocable: false	Hayır	Evet	Her zaman

/name yalnızca bir mesajın başında çalışır ve en fazla altı tanesi zincirlenebilir. Skill'ler argüman kabul eder: gövdedeki $ARGUMENTS, adın ardından yazdığınız her şeye dönüşür ve argument-hint menüde bir ipucu gösterir.

Claude Code'un standarda eklediği bazı diğer alanlar: ayrı bir tetikleme açıklaması için when_to_use, bir skill'i farklı bir modelde veya çaba düzeyinde çalıştırmak için model ve effort, allowed-tools ve disallowed-tools ile skill'i bir alt ajan içinde çalıştırıp işinin ana konuşmanızı doldurmamasını sağlayan context: fork.

Özel slash komutları skill'lere katıldı. .claude/commands/deploy.md ve .claude/skills/deploy/SKILL.md dosyalarının ikisi de /deploy oluşturur ve eski komut dosyaları çalışmaya devam eder.

Claude Code ile birlikte gelen yetenekler

Claude Code'un komut referansı 20 komutu yetenek olarak işaretler. En sık karşılaşacaklarınız şunlar:

Yetenek	Ne yapar
/code-review	Bir diff, branch veya pull request'i seçtiğiniz efor seviyesinde hata açısından inceler; düzeltebilir veya yorum bırakabilir
/simplify	Dört inceleme ajanı yeniden kullanım, sadeleştirme, verimlilik ve soyutlama sorunlarını arar, ardından düzeltmeleri uygular
/batch	Büyük bir değişikliği 5 ila 30 birime böler ve her birim için bir arka plan ajanı çalıştırır
/debug	Oturum için hata ayıklama günlüğünü açar ve günlüğü okur
/loop	Bir istemi belirli aralıkla yeniden çalıştırır veya kendi hızını ayarlar
/run ve /verify	Uygulamayı başlatır ve bir değişikliğin gerçekten çalıştığını doğrular
/doctor	Kurulumu, ayarları, uzantıları ve CLAUDE.md dosyasını denetler
/fewer-permission-prompts	Sık onayladığınız salt okunur komutları bir izin listesine dönüştürür
/update-config	settings.json dosyasını düz bir açıklamadan düzenler
/claude-api	Güncel Claude API ve SDK referansını yükler
/dataviz	Palet doğrulayıcıyla birlikte grafik ve gösterge paneli rehberliği

Yeni bir proje için CLAUDE.md yazan /init, bir yetenek değil yerleşik bir komuttur ve /review, /code-review komutunun diğer adıdır. Claude Code, Anthropic'in Word, PDF, PowerPoint ve Excel için belge yeteneklerini içermez; bunları anthropics/skills deposundan kurun.

Becerilerin maliyeti

Claude'un kendi başına çağırabildiği her beceri, açıklamasını her turda bağlama ekler. Claude Code bunu iki şekilde sınırlar:

• when_to_use ile birlikte her açıklama, listede 1.536 karakterde kesilir.
• Tüm açıklamalar birlikte, modelin bağlam penceresinin yaklaşık %1'i kadar bir bütçeyi paylaşır. Bu aşıldığında Claude Code, en az kullanılan becerilerden başlayarak açıklamaları kaldırır ve yalnızca adlarını tutar.

Bir kez kullanıldığında, bir becerinin içeriği konuşmada kalır. Otomatik bir sıkıştırmadan sonra, her becerinin en son kullanımı yeniden eklenir; beceri başına 5.000 token ve toplamda 25.000 token sınırına kadar.

/skills becerilerinizi listeler ve bunları token maliyetine göre sıralayabilir; /skill-doctor her becerinin bağlam maliyetini ve ne sıklıkla kullanıldığını bildirir. Yalnızca elle çağırdığınız bir beceride disable-model-invocation: true olmalıdır; bu, açıklamasını bağlamdan tamamen kaldırır.

Skill, hook, subagent, MCP veya plugin

İstediğiniz	Kullanın	Neden
Claude'un her oturumda ihtiyaç duyduğu bilgiler	CLAUDE.md	Her seferinde yüklenir; 200 satırın altında tutun
Bazı görevler için uzmanlık	Bir skill	Yalnızca ilgili olduğunda yüklenir
Her seferinde bir şeyin gerçekleşmesi	Bir hook	Deterministik, bağlam maliyeti yok; "korkulukları hook'lara koyun"
Bağlamınızın dışında tutulan ağır işler	Bir subagent	Ayrı bağlam, özet döndürür
Başka bir sistemden araçlar veya veriler	Bir MCP server	Bir skill, Claude'a bunu nasıl kullanacağını öğretebilir
Bir ekip için yukarıdakilerin tümü	Bir plugin	Bunları tek bir kurulum olarak paketler

Anthropic'in en çok belgelediği eşleşme bir skill ile bir MCP server'dır: server araçları sağlar, skill ise bu araçların ne zaman ve nasıl kullanılacağına dair muhakemeyi sağlar.

Güvenlik

Claude Code içindeki yetenekler (skills), kullanıcınızın haklarıyla ve tam ağ erişimiyle herhangi bir betiği çalıştırabilir. Kendi yazmadığınız bir yeteneğin betiklerini okuyun. allowed-tools, bir yeteneğin araçları size sormadan kullanmasını sağlar; hiçbir şeyi kısıtlamaz. Bir projede .claude/skills/ dizinini pull request'lerde tıpkı kod inceler gibi inceleyin. Kuruluşlar bunu yönetilen ayarlarla kilitleyebilir; buna yalnızca onaylı plugin marketlerinden gelen yeteneklere izin vermek de dahildir.

Çalışmadığı durumlar

Gördüğünüz	Nedeni	Çözümü
Claude beceriyi yok sayıyor	Açıklama sizin ifadenizle eşleşmiyor	Açıklamayı yeniden yazın; when_to_use ekleyin
/name bulunamıyor	Klasör adı ile name farklı ya da yeni bir üst düzey klasör var	İkisini eşleştirin; /reload-skills komutunu çalıştırın
Bir plugin becerisinin adı farklı	Plugin becerileri ad alanına (namespace) sahiptir	/plugin:name yazın
Bazı beceriler açıklamalarını kaybetti	Listeleme bütçesi aşıldı	Kullanılmayan becerileri kaldırın veya disable-model-invocation: true ayarlayın
Beceriniz gölgede kalıyor	Aynı ada sahip bir kuruluş veya kişisel beceri var	Kendi becerinizi yeniden adlandırın