Bir önceki yazıda Boris Cherny’nin Claude Code iş akışını ele almıştım. Paralel oturumlar, Plan modu, CLAUDE.md disiplini ve alt ajanlar. O yazıya buradan ulaşabilirsiniz.
Bu sefer konu daha da derinleşiyor. Claude Code’un en çok kullanılan genişletme noktalarından biri olan Claude Code Skills sistemi hakkında, Anthropic/Claude çalışanı “Thariq” X’te kapsamlı bir makale yayınladı. Anthropic’in yüzlerce aktif skill kullandığı iç deneyimden derlenen notları bizlerle paylaştı.
Skills Nedir?
Thariq, skills hakkındaki en yaygın yanılgıyı şu şekilde açıklıyor:
“Skills hakkında sıkça duyduğumuz bir yanılgı, bunların ‘sadece markdown dosyaları’ olduğudur. Oysa en ilginç kısım tam da bu değil: Skills, ajanın keşfedebileceği, inceleyebileceği ve üzerinde çalışabileceği scriptler, varlıklar, veriler içeren klasörlerdir.”
Yani skills bir klasördür. İçinde scriptler, şablonlar, referans kod örnekleri, veri dosyaları olabilir. Ajan bu klasörü keşfeder, dosyaları okur, scriptleri çalıştırır. Claude Code’da ayrıca dinamik hook kaydetme gibi ileri konfigürasyon seçenekleri de mevcut.
Bu farkı kavramak, skills’ten ne beklediğinizi ve nasıl inşa edeceğinizi tamamen değiştiriyor.
Skills Türleri
Thariq, yüzlerce skills’i katalogladıktan sonra ortaya çıkan tabloyu şöyle özetliyor:
“Tüm skills’lerimizi katalogladıktan sonra birkaç tekrarlayan kategoride toplandıklarını fark ettik. En iyi skills’ler bunlardan birine net biçimde giriyor; kafa karıştıranlar ise birden fazlasına yayılıyor.”
1. Library & API Reference İç kütüphanelerin nasıl kullanılacağını, hangi edge case’lerden kaçınılması gerektiğini anlatan skills’ler. Referans kod örnekleri ve “gotcha” listeleri içeriyor. Örnekler: billing-lib, internal-platform-cli, frontend-design
2. Product Verification Yazılan kodun gerçekten çalışıp çalışmadığını test eden skills’ler. Playwright veya tmux gibi araçlarla birlikte kullanılıyor. Thariq bu konuda şunları söylüyor:
“Doğrulama skills’leri, Claude’un çıktısının doğruluğunu garantilemek için son derece kullanışlı. Bir mühendis yalnızca doğrulama skills’lerinizi mükemmelleştirmek için bir hafta harcayabilir ve buna değer.”
Örnekler: signup-flow-driver, checkout-verifier, tmux-cli-driver
3. Data Fetching & Analysis Veri ve izleme sistemlerine bağlanan skills’ler. Kimlik bilgileri, dashboard ID’leri ve sık kullanılan sorgular içeriyor. Örnekler: funnel-query, cohort-compare, grafana
4. Business Process & Team Automation Tekrarlayan iş akışlarını tek komuta indirgeyen skills’ler. Genellikle diğer skills’lere veya MCP’lere bağımlı. Örnekler: standup-post, create-<ticket-system>-ticket, weekly-recap
5. Code Scaffolding & Templates Belirli bir framework için boilerplate kod üretimi. Saf kodla ifade edilemeyen doğal dil gereksinimlerini de kapsayabiliyor. Örnekler: new-<framework>-workflow, new-migration, create-app
6. Code Quality & Review Kod kalite standartlarını zorunlu kılan skills’ler. Hook’larla veya GitHub Actions ile otomatik tetiklenebiliyor. Örnekler: adversarial-review, code-style, testing-practices
7. CI/CD & Deployment PR takibi, kod push ve deployment süreçleri için skills’ler. Örnekler: babysit-pr, deploy-<service>, cherry-pick-prod
8. Runbooks Bir uyarı veya hata alındığında çok adımlı soruşturma yürüten ve yapılandırılmış rapor çıkaran skills’ler. Örnekler: <service>-debugging, oncall-runner, log-correlator
9. Infrastructure Operations Rutin bakım ve kritik operasyonlar için skills’ler. Yıkıcı sonuçlar doğurabilecek aksiyonlarda güvenlik bariyerleri içeriyor. Örnekler: <resource>-orphans, dependency-management, cost-investigation
Skills Geliştirmeye Yönelik İpuçları
Skills kategorisine karar verdikten sonra nasıl yazacaksınız? Thariq, Anthropic’in bu süreçte öğrendiği en iyi pratikleri şu başlıklar altında paylaşıyor.
Açıkça Belli Olanı Yazma
Thariq bu konuda şu uyarıyı yapıyor:
“Claude Code zaten kod tabanınız hakkında çok şey biliyor. Eğer öncelikli olarak bilgi paylaşan bir skills yayımlıyorsanız, Claude’u olağan düşünce biçiminin dışına çıkaran bilgilere odaklanmaya çalışın.”
frontend-design skills örneği bunu somutlaştırıyor: “iyi tasarım yap” demiyor. Inter font kullanımı, mor gradyanlar gibi Claude’un düşmesi muhtemel klişeleri özellikle engelliyor. Genel talimat değil, spesifik uyarı.
Gotchas Bölümü Şart
Thariq, her skills’in en değerli kısmının Gotchas bölümü olduğunu vurguluyor:
“Herhangi bir skills’deki en yüksek değerli içerik Gotchas bölümüdür. Bu bölümler, Claude’un skills’inizi kullanırken sık düştüğü hatalardan derlenmeli. İdeal olarak, zaman içinde bu hataları yakaladıkça skills’inizi güncellemeye devam edin.”
Skills’i baştan mükemmel yazmak zorunda değilsiniz. Claude hata yaptıkça Gotchas büyüyor, skills akıllanıyor. Günün sonunda organik ve sürdürülebilir bir yaklaşım sunuyor.
Dosya Sistemi = Context Mühendisliği
Thariq, dosya sistemini nasıl kullanmak gerektiğini şu şekilde açıklıyor:
“Skills bir klasördür, sadece markdown dosyası değil. Dosya sisteminin tamamını bir tür bağlam mühendisliği ve kademeli açılım aracı olarak düşünmelisiniz. Claude’a skills’inizde hangi dosyaların olduğunu söyleyin; uygun zamanlarda kendisi okuyacaktır.”
Pratikte şu anlama geliyor: Ayrıntılı fonksiyon imzalarını references/api.md‘ye taşıyın, şablonları assets/ klasörüne koyun, script ve örnek klasörler ekleyin. Claude bunların hepsini gerektiğinde kendisi keşfedecek.
Claude’a Baskı Yapmaktan Kaçın
Thariq bu konuda da net bir uyarı yapıyor:
“Skills çok yeniden kullanılabilir olduğu için talimatlarınızda fazla spesifik olmamaya dikkat edin. Claude’a ihtiyaç duyduğu bilgiyi verin ama duruma uyum sağlayacak esnekliği de bırakın.”
Çok katı talimatlar, skills’i tek kullanımlık hale getiriyor. Bilgi ver, esneklik bırak.
Skills Kurulumunu Planlayın
Bazı skills’lerin kullanıcıdan bağlam alması gerekebiliyor. Thariq bu durumu şöyle açıklıyor:
“Örneğin standup’ınızı Slack’e gönderen bir skills yapıyorsanız, Claude’un hangi Slack kanalına göndereceğini sormasını isteyebilirsiniz. Bunun için iyi bir yaklaşım, bu kurulum bilgisini skills dizinindeki bir config.json dosyasında saklamaktır. Config henüz kurulmamışsa ajan kullanıcıdan bilgi isteyebilir.”
Yapılandırılmış, çoktan seçmeli sorular sunmak istiyorsanız Claude’a AskUserQuestion aracını kullanmasını da talimat edebilirsiniz.
Description Alanı Model İçindir
Thariq, description alanının çoğu zaman yanlış kullanıldığını belirtiyor:
“Claude Code bir oturum başlattığında, mevcut her skills’in açıklamasıyla bir liste oluşturur. Bu liste, Claude’un ‘bu istek için bir skills var mı?’ diye taradığı şeydir. Yani description alanı bir özet değil, ne zaman tetikleneceğinin tanımıdır.”
Description’ı kullanıcıya değil, modele yazın. Mevcut skills’lerinizin description alanlarına bu gözle tekrar bakmanızı öneririm.
Memory & Veri Saklama
Thariq, skills’lerin veri saklayarak hafıza kazanabileceğini şu şekilde açıklıyor:
“Bazı skills’ler, veri saklayarak bir hafıza biçimi içerebilir. Basit bir metin log dosyasından JSON dosyalarına, hatta SQLite veritabanına kadar her şeyi saklayabilirsiniz.”
Örnek olarak standup-post skills’i veriliyor: her çalıştığında bir log dosyasına yazıyor, bir sonraki gün Claude bu log’u okuyup “dünden bu yana ne değişti?” sorusunu kendi yanıtlıyor.
Önemli bir uyarı: Skills klasöründeki veriler, skills güncellendiğinde silinebilir. Kalıcı veriyi $CLAUDE_PLUGIN_DATA gibi ayrı bir kararlı klasörde saklamak daha güvenli olacaktır.
Script ve Kod Üretimi
Thariq, Claude’a verebileceğiniz en güçlü araçlardan birinin kod olduğunu vurguluyor:
“Claude’a scriptler ve kütüphaneler vermek, Claude’un her seferinde boilerplate yeniden inşa etmek yerine ne yapacağına karar vermeye odaklanmasını sağlar.”
Örnek olarak bir data science skills’inde olay kaynağından veri çeken hazır fonksiyonlar veriliyor. Claude bu fonksiyonları birleştirerek “Salı günü ne oldu?” gibi karmaşık sorgulara anında cevap üretebiliyor.
İsteğe Bağlı Hook’lar
Thariq, on-demand hook’ların neden bu kadar işlevsel olduğunu somut örneklerle anlatıyor:
“Örneğin
/careful– rm -rf, DROP TABLE, force-push, kubectl delete komutlarını engelliyor. Bunu yalnızca production’a dokunduğunuzu bildiğinizde istiyorsunuz, her zaman açık olsa dayanılmaz olurdu.”
/freeze ise belirli bir dizin dışında herhangi bir düzenlemeyi engelliyor. Hata ayıklarken alakasız dosyalara kazara dokunmamak için biçilmiş kaftan.
Skills’leri Dağıtmak
Thariq, skills paylaşmanın iki yolunu tarif ediyor: Repoya eklemek (./.claude/skills altında) ya da dahili bir plugin marketplace kurmak. Küçük ekipler için repo yeterli, ölçeklenince marketplace çok daha yönetilebilir bir yapı sunduğunu aktarıyor.
Skills Marketplace Yönetimi
Thariq, marketplace yönetiminde merkezi bir onay mekanizması yerine organik bir süreci tercih ettiklerini söylüyor:
“Merkezi bir karar verici ekibimiz yok; bunun yerine en kullanışlı skills’leri organik olarak bulmaya çalışıyoruz. Bir skills denemek istiyorsanız, GitHub’daki bir sandbox klasörüne yükleyip Slack’te paylaşabilirsiniz. Yeterli ilgi gördükten sonra marketplace’e PR açılabiliyor.”
Bununla birlikte önemli bir uyarı da ekliyor:
“Kötü veya gereksiz skills’ler yaratmak oldukça kolay olabilir, bu yüzden yayına almadan önce bir tür kürasyon mekanizmanız olduğundan emin olun.”
Skills’leri Birleştirmek
Skills’lerin birbirine bağımlı olabileceğini de belirtiyor. Örneğin bir dosya yükleme skills’i ile bir CSV üretme skills’i birleştirilebilir. Bu bağımlılık yönetimi henüz marketplace’e yerleşik gelmese de skills’leri isimle referans almak yeterli olacaktır diyor. Model, kurulu olması koşuluyla onları çağırıyor ve skillsleri birleştirerek kullanıyor.
Skills Performansını Ölçmek
Thariq, skills performansını takip etmek için PreToolUse hook’u kullandıklarını paylaşıyor. Bu sayede hangi skills’lerin popüler, hangilerinin beklenenden az tetiklendiğini görebiliyorlar. Beklentinizle gerçek kullanım arasındaki fark, genellikle description alanını yeniden yazmayı gerektirir.
Thariq, makalesini şu şekilde noktalıyor:
“Skills ajanlar için inanılmaz derecede güçlü ve esnek araçlar, ama hâlâ erken dönemdeyiz ve hepimiz bunları en iyi nasıl kullanacağımızı keşfediyoruz. Çoğumuzun skills’leri birkaç satır ve tek bir gotcha ile başladı; Claude yeni edge case’lere çarptıkça insanlar ekleme yaptı ve zamanla daha iyi hale geldi.”
Skills sistemi, göründüğünden çok daha derin bir yapı. Başlangıçta “bir talimat dosyası” gibi görünse de doğru kurgulandığında Claude Code’u ekip belleğine sahip bir otomasyon katmanına dönüştürüyor. Thariq’in de dediği gibi çoğu skills birkaç satır ve tek bir gotcha ile başlıyor. Asıl büyüme, Claude her hata yaptığında birileri bir şeyler ekliyor ve zamanla skills akıllanıyor.
Denemek için karmaşık bir başlangıca gerek yok. Küçük bir şeyle başlayın, Claude’un nerede tökezlediğini görün ve oradan büyütün.
Kaynak: Thariq X — Lessons from Building Claude Code: How We Use Skills
Son yazılar için;
VMware vSphere 8.0 Update 3i Yayınlandı: ESXi ve vCenter Release Notes Detaylı İnceleme
VMSA-2026-0001: VMware Aria Operations Çoklu Güvenlik Açıkları
ESXTOP Kullanım Rehberi: VMware Performans İzleme ve Analiz
Anthropic Academy Nedir? Ücretsiz Claude AI Eğitimleri ve Sertifika Programları
Claude Code’un Yaratıcısından: Profesyonel Kullanım Rehberi
