Claude Code, genel amaçlı bir yapay zeka asistanıyla birlikte gelir. Yetenekler (Skills), onu özelleştirmenize olanak tanır. Bir yetenek, Claude Code'a belirli bir görev türünü nasıl ele alacağını öğreten bir markdown dosyasıdır: Kubernetes'e dağıtım yapmak, veritabanı migrasyonları yazmak, pull request'leri incelemek veya ekibinizin kodlama kurallarını takip etmek.
"Bana bir React bileşeni yaz" ile "Tasarım sistemimizi takip eden, özel hook'larımızı kullanan, uygun hata sınırlarına (error boundaries) ve erişilebilirlik niteliklerine sahip bir React bileşeni yaz" arasındaki fark bir yetenektir.
Resmi Claude Code dokümanları artık bir şeyi açıkça belirtiyor: özel komutlar (custom commands) yeteneklerle birleştirildi. .claude/commands/ içindeki mevcut dosyalar hala çalışıyor, ancak yetenekler daha zengin metadata, destekleyici dosyalar ve otomatik yüklemeyi desteklediği için önerilen soyutlamadır. Bugün bir ekip iş akışını standartlaştırıyorsanız, bunu önce bir yetenek olarak oluşturun ve eski komutları bir uyumluluk yolu olarak görün.
Yetenekler Gerçekte Nedir?
Bir yetenek, SKILL.md giriş noktasına sahip bir dizinde bulunur. Claude, açıklama mevcut görevle eşleştiğinde bunu otomatik olarak yükleyebilir veya doğrudan /skill-name ile çağırabilirsiniz.
.claude/
skills/
deploy/
SKILL.md # /deploy
review-pr/
SKILL.md # /review-pr
write-test/
SKILL.md # /write-test
Claude hala .claude/commands/deploy.md dosyasını desteklemektedir ve slash komutu çalışmaya devam edecektir. Ancak modern versiyon .claude/skills/deploy/SKILL.md şeklindedir.
Bu küçük bir isimlendirme değişikliği gibi görünebilir. Ancak önemlidir çünkü yetenekler destekleyici dosyalar, frontmatter, çağırma kontrolleri ve subagent ipuçları taşıyabilir. İnce bir komut dosyası Claude'a ne yapacağını söyleyebilir. Bir yetenek ise Claude'a ekibinizin işin nasıl yapılmasını beklediğini söyleyebilir.
İlk Yeteneğinizi Yazma
İşte pratik bir örnek: ekibinizin commit mesajı kurallarını uygulayan bir yetenek.
.claude/skills/commit/SKILL.md dosyasını oluşturun:
---
name: commit
description: Generate and validate conventional commits for this repo.
---
# Commit Workflow
## Steps
1. Run `git diff --staged` to see what's being committed
2. Analyze the changes and categorize: feat, fix, refactor, docs, test, chore
3. Write a commit message following our convention:
- Format: `type(scope): description`
- Scope is the package or module name
- Description is imperative mood, lowercase, no period
- Body explains WHY, not WHAT
4. If changes touch multiple scopes, create separate commits
5. Run `git commit -m "message"` with the generated message
## Rules
- Never use `--no-verify` to skip hooks
- Never amend published commits
- If tests fail in pre-commit, fix the issue first
## Examples
- `feat(billing): add stripe webhook handler`
- `fix(auth): handle expired refresh tokens`
- `refactor(api): extract rate limiter to shared package`
Artık /commit komutu, Claude Code'a belirsiz bir "değişikliklerimi commit'le" talimatı yerine yapılandırılmış bir iş akışı sağlar.
Eğer halihazırda eski komut dosyalarınız varsa, geçiş yaparken onları çalışır durumda tutun ancak eski düzene yatırım yapmaya devam etmeyin. Resmi dokümanlar, yeteneklerin gelecekteki yol olduğu konusunda nettir.
Yetenekler Artık Nerede Bulunuyor?
Claude Code şu anda yetenekleri dört yerden keşfediyor:
- kişisel yetenekler:
~/.claude/skills/<skill-name>/SKILL.md - proje yetenekleri:
.claude/skills/<skill-name>/SKILL.md - monorepo'lardaki iç içe geçmiş proje yetenekleri
- plugin tarafından sağlanan yetenekler
Bu size temiz bir ayrım sağlar:
- kendi çalışma tarzınız için kişisel yetenekler
- repo kuralları için proje yetenekleri
- yeniden kullanılabilir paketlenmiş iş akışları için plugin yetenekleri
Ekipçe benimseme için proje yeteneklerini repoya commit edin. Bu, "dizüstü bilgisayarımda güzel bir prompt var" ile "ekibin artık tekrarlanabilir bir iş akışı var" arasındaki farktır.
Yetenek Tasarım Desenleri
Checklist Deseni
Birden fazla doğrulama adımı içeren görevler için en iyisidir.
# Pre-Deploy Checklist
Before deploying, verify each item:
- [ ] `pnpm typecheck` passes
- [ ] `pnpm test` passes
- [ ] No console.log statements in production code
- [ ] Environment variables documented in .env.example
- [ ] Database migrations are reversible
- [ ] API changes are backward compatible
If any check fails, stop and report the issue. Do not proceed with deployment.
Karar Ağacı Deseni
Yaklaşımın bağlama bağlı olduğu görevler için en iyisidir.
# Bug Fix Workflow
1. Reproduce the bug (find or write a failing test)
2. Identify the root cause:
- If it's a type error → fix the type definition at the source
- If it's a race condition → add proper locking/sequencing
- If it's a missing validation → add schema validation at the boundary
- If it's a logic error → fix and add regression test
3. Verify the fix doesn't break existing tests
4. Write a test that would have caught this bug
Şablon Deseni
Tutarlı çıktılar üretmek için en iyisidir.
# New API Endpoint
Create a new API endpoint following our conventions:
## File Structure
- Route handler: `apps/api/src/routes/{resource}/{action}.ts`
- Schema: `apps/api/src/schemas/{resource}.ts`
- Test: `apps/api/src/routes/{resource}/__tests__/{action}.test.ts`
## Required Elements
- Zod schema for request validation
- Authentication middleware
- Rate limiting
- Structured error responses using errorResponse()
- Success responses using successResponse()
- OpenAPI documentation comments
Topluluk Yeteneklerini Yükleme
Claude Code ekosistemi, büyüyen bir topluluk yetenekleri kütüphanesine sahiptir. Bunları şununla yükleyin:
npx add-skill username/repo-name -y
Popüler yetenek koleksiyonları:
coreyhaines31/marketingskills(29 pazarlama/SEO yeteneği)hedging8563/lemondata-api-skill(LemonData API entegrasyonu)
Yüklenen yetenekler ~/.claude/commands/ içinde görünür ve tüm projelerde çalışır.
Yüklenen yetenek paketleri, yalnızca slash-command markdown dosyaları yerine giderek daha fazla gerçek yetenekler sunmaktadır. Kendi reponuzu yönetiyorsanız, OpenCode + LemonData makalesindeki desen burada da geçerlidir: yeteneği geçici prompt dosyalarında saklamak yerine iş akışına yakın tutun.
Proje ve Global Yetenekler
| Konum | Kapsam | Kullanım Durumu |
|---|---|---|
.claude/skills/ |
Yalnızca bu proje | Proje kuralları, deploy iş akışları |
~/.claude/skills/ |
Tüm projeler | Kişisel tercihler, yeniden kullanılabilir alışkanlıklar |
.claude/commands/ |
Eski uyumluluk | Hala çalışan eski slash-command dosyaları |
Proje yetenekleri, tüm ekibin faydalanabilmesi için reponuza commit edilmelidir. Global yetenekler ise kişisel iş akışı tercihleri içindir.
Gelişmiş: Hook İçeren Yetenekler
Yetenekler, otomatik uygulama için hook'lara (belirli olaylarda çalışan shell komutları) referans verebilir:
# Pre-Commit Check
Before any commit, the following hooks run automatically:
- `pre-commit`: runs typecheck + lint
- `post-commit`: updates changelog
If a hook fails, investigate the error output and fix the issue.
Do not use --no-verify to bypass hooks.
Hook'ların kendileri .claude/settings.json içinde yapılandırılır:
{
"hooks": {
"pre-commit": "pnpm typecheck && pnpm lint-staged"
}
}
Burası, yeteneklerin prompt parçacıklarından daha fazlası haline geldiği yerdir. Faydalı bir ekip kurulumu genellikle üç katmana sahiptir:
- Claude'a iş akışını anlatan bir yetenek
- İş akışını zorunlu kılan hook'lar
- İş akışını insanlara açıklayan repo dokümanları
Bu katmanlardan biri eksik olduğunda sistem kırılganlaşır. Hook'suz bir yetenek sadece tavsiye niteliğinde kalır. Yeteneksiz hook'lar anlaşılmaz hale gelir. Her ikisi de olmadan hazırlanan dokümanlar ise kimsenin takip etmediği bayat politikalara dönüşür.
Destekleyici Dosyalar Gerçek Bir Yükseltmedir
Eski komut markdown dosyaları yerine yetenekleri tercih etmenin en önemli nedeni destekleyici dosyalardır.
Bir komut dosyasıyla her şey tek bir blokta yaşamak zorundadır. Bir yetenek dizini ile şunları tutabilirsiniz:
- şablonlar
- örnekler
- shell yardımcıları
- uzun referans notları
- doğrulayıcı (validator) script'ler
Bu, SKILL.md dosyasını kısa ve yüksek sinyalli tutmanıza olanak tanırken, Claude'a gerektiğinde çekebileceği yapılandırılmış materyaller sunar.
Bu özellikle şunlar için kullanışlıdır:
- deployment iş akışları
- schema migrasyon kontrol listeleri
- çok adımlı kod inceleme süreçleri
- ürüne özel entegrasyon kılavuzları
Ekibiniz birden fazla model veya kodlama aracı kullanıyorsa, bu sayfayı kodlama için en iyi yapay zeka modelleri karşılaştırması ve Cursor / Cline / Windsurf kurulum kılavuzu ile eşleştirin. Temel model veya editör değiştiğinde iyi yetenekler daha fazla önem kazanır.
Etkili Yetenekler İçin İpuçları
Dosya yolları ve isimlendirme kuralları konusunda spesifik olun. "Bir bileşen oluştur" belirsizdir. "PascalCase isimlendirme kullanarak
src/components/ui/içinde bir bileşen oluştur" eyleme dönüştürülebilirdir.Doğru çıktı örnekleri ekleyin. Claude Code, soyut kurallardan ziyade örneklerden daha iyi öğrenir.
Ne YAPILMAYACAĞINI tanımlayın. "Asla
anytipini kullanma", "uygun tipleri kullan"dan daha kolay uygulanabilir bir kuraldır.Yetenekleri odaklı tutun. Her iş akışı için bir yetenek. Her şeyi kapsayan 200 satırlık bir yetenek, her biri bir görevi iyi halleden beş adet 40 satırlık yetenekten daha az kullanışlıdır.
Yeteneklerinizi versiyonlayın. Kurallarınız geliştikçe yetenekleri güncelleyin. Güncelliğini yitirmiş yetenekler, eski desenleri zorunlu kıldıkları için hiç yetenek olmamasından daha kötüdür.
Yeteneklerin otomatik mi yükleneceğine yoksa sadece manuel mi çalışacağına karar verin. Birçok ekip bunu unutur ve sonra Claude'un alakasız konuşmalarda neden bir deployment yeteneğini çağırdığını merak eder.
Gerçek Dünyadaki Etkisi
Yetenekleri benimseyen ekipler tutarlı iyileşmeler bildiriyor:
- Kod inceleme döngüleri kısalıyor çünkü kurallar incelemeden önce uygulanıyor
- Yeni geliştiriciler kıdemlilerle aynı rehberliği aldığı için işe alıştırma (onboarding) süresi azalıyor
- Yapay zeka tarafından üretilen kod kalitesi artıyor çünkü yapay zeka proje standartları hakkında açık bir bağlama sahip oluyor
Yatırım küçüktür (ilk birkaç yeteneğinizi yazmak 30 dakika sürer) ve getirisi her etkileşimde katlanarak artar.
En faydalı zihinsel model şudur: Bir yetenek Claude için bir kısayol değildir. Ekibiniz için versiyonlanmış bir iş akışı yapıtıdır.
Sadece bir yetenek yazacaksanız, kod tabanınızdaki en yüksek maliyetli ve tekrarlanan kararı kodlayan yeteneği yazın.
Kendi kurallarınızın rehberliğinde yapay zeka ile inşa edin. LemonData, farklı sağlayıcılardaki kodlama modelleri için size tek bir API anahtarı sunar; böylece iş akışlarınız yetenek olarak kodlandığında, tüm araç zincirini yeniden oluşturmadan modeller arasında geçiş yapabilirsiniz.