Claude Code Skills Nedir? Tekrarlanan Geliştirme Görevlerini Becerilere Dönüştürme

Claude Code Skills Nedir?

Claude Code, Anthropic'in terminal tabanlı yapay zekâ kodlama asistanıdır. Skills ise bu asistanın belirli görevleri tekrar tekrar, tutarlı biçimde yapabilmesi için tanımladığınız yapılandırılmış talimat setleridir. Kısaca: bir kez tarif edersiniz, Claude Code o işi her seferinde aynı kurallara göre uygular.

Geleneksel yaklaşımda her yeni oturumda aynı komutu, aynı bağlamı ve aynı beklentiyi yeniden anlatırsınız. Skills ile bu bilgi kalıcı hale gelir; proje kökünde veya kullanıcı dizininde saklanan dosyalar aracılığıyla Claude Code ilgili görevi tanır ve uygular. Bu, özellikle commit mesajı yazma, kod inceleme, test üretme veya belirli bir stil rehberine göre refaktör gibi sık tekrarlanan işlerde ciddi zaman kazancı sağlar.

Skill'lerin Çalışma Mantığı

Claude Code, bir görevi yerine getirirken önce mevcut skill tanımlarına bakar. Eğer kullanıcının isteği bir skill ile eşleşiyorsa, o skill'in içeriğindeki adımları, kısıtları ve örnekleri kullanarak yanıt üretir. Bu sayede modelin genel bilgisine ek olarak projeye özgü kurallar devreye girer.

Skill dosyaları genellikle Markdown formatındadır ve şu unsurları içerir:

• Tetikleyici ifadeler: Hangi durumda bu skill'in kullanılacağını belirtir.
• Adımlar: İzlenecek sıralı işlemler.
• Kısıtlar: Yapılmaması gerekenler veya dikkat edilecek noktalar.
• Örnekler: Girdi-çıktı çiftleriyle beklentinin netleştirilmesi.

Bu yapı, hem yeni ekip üyeleri için bir dokümantasyon görevi görür hem de yapay zekâ asistanının tutarlılığını artırır.

Skill Tanımlama Adımları

1. Tekrarlanan Görevi Belirleyin

Günlük iş akışınızda sürekli aynı talimatları verdiğiniz bir işi seçin. Örneğin: "Her yeni bileşen için test dosyası oluştur ve %80 kapsam hedefle." Bu tür bir istek, skill'e dönüştürmek için uygundur.

2. Skill Dosyasını Oluşturun

Proje kökünde .claude/skills/ gibi bir dizin oluşturup içine test-olustur.md adında bir dosya koyabilirsiniz. İçeriği şöyle olabilir:

---
name: test-olustur
description: Yeni bir React bileşeni için Jest testi üretir.
---

# Test Oluşturma Skill'i

## Tetikleyici
Kullanıcı "test yaz" veya "test oluştur" dediğinde.

## Adımlar
1. İlgili bileşenin dosya yolunu belirle.
2. Bileşenin props ve state yapısını incele.
3. Jest ve React Testing Library kullanarak test dosyası oluştur.
4. En az üç senaryo ekle: render, kullanıcı etkileşimi, hata durumu.

## Kısıtlar
- Snapshot testi kullanma.
- Test dosyasını bileşenle aynı dizine koy.
- Türkçe test açıklamaları yaz.

Bu dosya, Claude Code'un ilgili isteği aldığında izleyeceği yolu netleştirir.

3. Skill'i Test Edin

Claude Code oturumunda "test oluştur" komutunu verin. Asistanın yukarıdaki adımlara uyup uymadığını gözlemleyin. Gerekirse skill dosyasını güncelleyin.

Uygulanabilir Örnek: Commit Mesajı Skill'i

Diyelim ki ekibiniz Conventional Commits standardını kullanıyor. Her seferinde "feat: ..." gibi bir mesaj yazmak yerine bir skill tanımlayabilirsiniz:

---
name: commit-mesaji
description: Değişikliklere göre Conventional Commits formatında mesaj üretir.
---

# Commit Mesajı Skill'i

## Tetikleyici
Kullanıcı "commit mesajı yaz" dediğinde.

## Adımlar
1. `git diff --staged` çıktısını incele.
2. Değişikliğin türünü belirle (feat, fix, docs, refactor, test).
3. Kısa bir başlık ve gerekirse gövde metni oluştur.

## Kısıtlar
- Başlık 72 karakteri geçmesin.
- Gövdede "ne" değil "neden" açıkla.

Bu skill sayesinde her commit öncesi aynı formatta mesaj alırsınız. Ekip içi tutarlılık artar, kod inceleme süreci hızlanır.

Skill'leri Proje Geneline Yayma

Skill'ler yalnızca bireysel kullanım için değildir. Proje kökünde saklanan skill dosyalarını sürüm kontrolüne ekleyerek tüm ekip üyelerinin aynı kurallarla çalışmasını sağlayabilirsiniz. Böylece yapay zekâ asistanı, projenin kodlama standartlarını ve iş akışını otomatik olarak öğrenmiş olur.

Ayrıca kullanıcı dizininde (~/.claude/skills/) tanımlanan skill'ler tüm projelerinizde geçerli olur. Kişisel tercihlerinizi (örneğin her zaman Türkçe yorum satırı yazmak) buraya ekleyebilirsiniz.

Sonuç

Claude Code Skills, yapay zekâ destekli geliştirmeyi bir adım ileri taşır: tekrarlanan görevleri tanımlı, test edilebilir ve paylaşılabilir becerilere dönüştürürsünüz. Bu yaklaşım, hem bireysel verimliliği artırır hem de ekip içi tutarlılığı güçlendirir. Küçük bir skill dosyasıyla başlayıp zamanla kendi kütüphanenizi oluşturabilirsiniz.