Yetenekler, Claude Code'da en çok kullanılan genişletme noktalarından biri haline geldi. Esnektirler, yapımı kolaydır ve dağıtımı basittir.
Ancak bu esneklik, en iyi neyin işe yaradığını bilmeyi de zorlaştırır. Hangi tür beceriler yapmaya değer? İyi bir beceri yazmanın sırrı nedir? Bunları başkalarıyla ne zaman paylaşırsınız?
Anthropic'te Claude Code'de Claude Code'da yüzlerce aktif beceriyle kapsamlı bir şekilde becerileri kullanıyoruz. Bunlar, geliştirme sürecimizi hızlandırmak için becerileri kullanma konusunda öğrendiğimiz derslerdir.
Beceriler (Skills) Nedir?
Becerilerde yeniyseniz, dokümanlarımızı okumanızı veya Skilljar'daki Agent Becerileri üzerine yeni kursumuzu izlemenizi öneririm; bu yazı, becerilere zaten biraz aşina olduğunuzu varsayacaktır.
Beceriler hakkında sık duyduğumuz yaygın bir yanılgı, onların "sadece markdown dosyaları" olduğudur, ancak becerilerin en ilginç kısmı, yalnızca metin dosyaları olmamalarıdır. Bunlar, ajanın keşfedebileceği, inceleyebileceği ve üzerinde işlem yapabileceği komut dosyaları, varlıklar, veriler vb. içerebilen klasörlerdir.
Claude Code'da beceriler ayrıca, dinamik kancaları (hook'lar) kaydetme dahil olmak üzere çok çeşitli yapılandırma seçeneklerine sahiptir.
Claude Code'daki en ilginç becerilerden bazıların bazılarının bu yapılandırma seçeneklerini ve klasör yapısını yaratıcı bir şekilde kullandığını gördük.
Becerilerin Türleri
Tüm becerilerimizi katalogladıktan sonra, bunların birkaç yinelenen kategoride kümelendiğini fark ettik. En iyi beceriler bunlardan birine temiz bir şekilde uyar; daha kafa karıştırıcı olanlar ise birkaçının arasında kalır. Bu kesin bir liste değil, ancak kuruluşunuz içinde herhangi birini kaçırıp kaçırmadığınızı düşünmek için iyi bir yoldur.
1. Kütüphane ve API Referansı
Bir kütüphanenin, CLI'ın veya SDK'ların nasıl doğru kullanılacağını açıklayan beceriler. Bunlar hem dahili kütüphaneler hem de Claude Code'un bazen sorun yaşadığı yaygın kütüphaneler için olabilir. Bu beceriler genellikle bir referans kod parçacıkları klasörü ve Claude'un bir komut dosyası yazarken kaçınması gereken tuzakların (gotchas) bir listesini içerir.
Örnekler:
- billing-lib — dahili faturalandırma kütüphaneniz: uç durumlar, kendi ayağına sıkma noktaları vb.
- internal-platform-cli — dahili CLI sarmalayıcınızın her bir alt komutu, ne zaman kullanılacaklarına dair örneklerle birlikte
- frontend-design — Claude'u tasarım sisteminizde daha iyi hale getirin
2. Ürün Doğrulama
Kodunuzun çalıştığını nasıl test edeceğinizi veya doğrulayacağınızı açıklayan beceriler. Bunlar genellikle doğrulama yapmak için playwright, tmux vb. gibi harici bir araçla eşleştirilir.
Doğrulama becerileri, Claude'un çıktısının doğru olduğundan emin olmak için son derece kullanışlıdır. Bir mühendisin doğrulama becerilerinizi mükemmelleştirmek için bir hafta harcaması buna değebilir.
Claude'a çıktısının bir videosunu kaydettirmek gibi teknikleri düşünün, böylece tam olarak neyi test ettiğini görebilir veya her adımda durum üzerinde programlı iddialar (assertions) uygulayabilirsiniz. Bunlar genellikle beceriye çeşitli komut dosyaları eklenerek yapılır.
Örnekler:
- signup-flow-driver — başlıksız bir tarayıcıda kaydolma → e-posta doğrulama → kullanıcıya alıştırma sürecini çalıştırır, her adımda durumu iddia etmek için kancalarla birlarla birlikte
- checkout-verifier — ödeme arayüzünü Stripe test kartlarıyla çalıştırır, faturanın gerçekten doğru duruma geldiğini doğrular
- tmux-cli-driver — doğruladığınız şeyin bir TTY gerektirdiği etkileşimli CLI testleri için
3. Veri Getirme ve Analiz
Veri ve izleme yığınlarınıza bağlanan beceriler. Bu beceriler, kimlik bilgilerinizle verilerinizi getirecek kütüphaneleri, belirli pano kimliklerini vb. ve ayrıca yaygın iş akışları veya veri alma yolları hakkında talimatları içerebilir.
Örnekler:
- funnel-query — "kaydolma → etkinleştirme → ödeme akışını görmek için hangi olayları birleştirmeliyim" artı asıl kurallı user_id'ye sahip tablo
- cohort-compare — iki kohortun elde tutma veya dönüşüm oranını karşılaştırır, istatistiksel olarak anlamlı farkları işaretler, segment tanımlarına bağlantı verir
- verir
- grafana — veri kaynağı UID'leri, küme adları, sorunları → pano arama tablosu
4. İş Süreci ve Ekip Otomasyonu
Tekrarlayan iş akışlarını tek bir komutta otomatikleştiren beceriler. Bu beceriler genellikle oldukça basit talimatlardır ancak diğer becerilere veya MCP'lere daha karmaşık bağımlılıkları olabilir. Bu beceriler için, önceki sonuçları günlük dosyalarında kaydetmek, modelin tutarlı kalmasına ve iş akışının önceki yürütmeleri üzerinde düşünmesine yardımcı olabilir.
Örnekler:
- standup-post — bilet takipçinizi, GitHub etkinliğinizi ve önceki Slack mesajlarını birleştirir → biçimlendirilmiş standup, yalnızca fark
- create-<ticket-system>-ticket — şemayı (geçerli enum değerleri, zorunlu alanlar) artı oluşturma sonrası iş akışını (gözden geçireni etiketle, Slack'te paylaş) zorunlu kılar
- weekly-recap — birleştirilen PR'ler + kapatılan biletler + dağıtımlar → biçimlendirilmiş özet yazısı
5. Kod İskeleti ve Şablonlar
Kod tabanında belirli bir işlev için framework (çatı) iskeleti oluşturan beceriler. Bu becerileri birleştirilebilen komut dosyalarıyla birleştirebilirsiniz. Özellikle iskeletinizin, kod tarafından tamamen karşılanamayan doğal dil gereksinimleri olduğunda kullanışlıdırlar.
Örnekler:
- new-<framework>-workflow — ek açıklamalarınızla yeni bir hizmet/iş akışı/işleyici iskeleti oluşturur
- new-migration — migratin dosyanızın şablonu artı yaygın tuzaklar
- create-app — kimlik doğrulama, günlükleme ve dağıtım yapılandırmanız önceden bağlı yeni bir dahili uygulama
6. Kod Kalitesi ve İnceleme
Kuruluşunuz içinde kod kalitesini zorunlu kılan ve kodun gözden geçirilmesine yardımcı olan beceriler. Bunlar, maksimum sağlamlık için deterministik komut dosyaları veya araçlar içerebilir. Bu becerileri otomatik olarak kancaların bir parçası olarak veya bir GitHub Eylemi içinde otomatik olarak çalıştırmak isteyebilirsiniz.
- adversarial-review — eleştirmek için yeni bir göz alt etmeni (subagent) oluşturur, düzeltmeleri uygular, küçük detaylara indirgenene kadar yineler
- code-style — kod stilini zorunlu kılar, özellikle Claude'un varsayılan olarak iyi yapamadığı stiller
- testing-practices — testlerin nasıl yazıve neyin test edilmesi gerektiği hakkında talimatlar
7. CI/CD ve Dağıtım
Kod tabanınızda kod getirme, gönderme ve dağıtma konusunda yardımcı olan beceriler. Bu beceriler veri toplamak için diğer becerilere başvurabilir.
Örnekler:
- babysit-pr — bir PR'ı izler → kararsız CI'yı yeniden dener → birleştirme çatışmalarını çözer → otomatik birleştirmeyi etkinleştirir
- deploy-<service> — derleme → duman testi → hata oranı karşılaştırmasıyla kademeli trafik dağıtımı → gerilemede otomatik geri alma
- cherry-pick-prod — izole çalışma ağacı → seçerek al → çatışma çözümü → şablonlu PR
8. Çalıştırma Kılavuzları (Runbook'lar)
Bir belirtiyi (bir Slack başlığı, uyarı veya hata imzası gibi) alan, çoklu araç araştırması boyunca ilerleyen ve bu araştırmayı yapılandırılmış bir rapor üreten beceriler.
Örnekler:
- <service>-debugging — en yoğun trafikli hizmetleriniz için belirtileri → araçları → sorgu desenlerini eşler
- oncall-runner — uyarıyı getirir → olağan şüphelileri kontrol eder → bir bulgu formatlar
- log-correlator — verilen bir istek kimliği için, ona dokunmuş olabilecek her sistemden eşleşen günlükleri çeker
9. Altyapı İşlemleri
Rutin bakım ve operasyonel prosedürleri gerçekleştiren beceriler — bunlarden bazıları, güvenlik önlemlerinden fayda sağlayan yıkıcı eylemler içerir. Kritik operasyonlarda en iyi uygulamaları takip etmeyi mühendisler için kolaylaştırır.
Örnekler:
- <resource>-orphans — sahipsiz pod'ları/volümleri bulur → Slack'te yayınlar → bekleme süresi → kullanıcı onaylar → kademeli temizlik
- dependency-management — kuruluşunuzun bağımlılık onay iş akışı
- cost-investigation — "depolama/çıkış faturaları neden fırladı?" spesifik bucket'lar ve sorgu desenleriyle
Beceri Yapmak İçin İpuçları
Yapmaya karar verdiğiniz beceriyi nasıl yazmsınız? Bunlar, bulduğumuz en iyi uygulamalardan, ipuçpüf noktalarından bazıları.
Ayrıca yakın zamanda Becerioluşturucu'yu (Skill Creator) yayınladık. Claude Code'da beceriler oluşturmayı kolaylaştırır.
Aşikar Olanı Belirtmeyin
Claude Code, kod tabanınız hakkında çok şey bilir ve Claude kodlama hakkında, birçok varsayılan görüş dahil olmak üzere çok şey bilir. Eğer ağırlıklı olarak bilgiyle ilgili bir beceri yayınlıyorsanız, Claude'u normal düşünce tarzının dışına iten bilgilere odaklanmaya çalışın.
Frontend tasarım becerisi bunun harika bir örneğidir — Anthropic'teki mühendislerden biri tarafından, müşterilerle yinelemeli çalışarak Claude'un tasarım zevkini iyileştirmek, Inter yazı tipi ve mor degrade gibi klasik desenlerden kaçınmak üzere oluşturulmuştur.
Bir Tuzaklar (Gotchas) Bölümü Oluşturun
Herhangi bir becerideki en yüksek sinyalli içerik Tuzaklar bölümüdür. Bu bölümler, Claude'un becerinizi kullanırken karşılaştığı yaygın başarısızlık noktalarından oluşturulmalıdır. İdeal olarak, zaman içinde bu tuzakları yakalamak için becerinizi güncelleyeceksiniz.
Dosya Sistemini ve Aşamalı Açıklamayı Kullanın
Daha önce söylediğimiz gibi, bir beceri bir klasördür, yalnızca bir markdown dosyası değil. Dosya sisteminin tamamını bir bağlam mühendisliği ve aşamalı açıklama biçimi olarak düşünmelisiniz. Claude'a becerinizde hangi dosyalar olduğunu söyleyin; bunları uygun zamanlarda okuyacaktır.
Aşamalı açıklamanın en basit biçimi, Claude'un kullanması için diğer markdown dosyalarını işaret etmektir. Örneğin, ayrıntılı fonksiyon imzalarını ve kullanım örneklerini references/api.md dosyasına ayırabilirsiniz.
Başka bir örnek: nihai çıktınız bir markdown dosyasıysa, kopyalayıp kullanmak üzere assets/ klasöründe bunun için bir şablon dosyası ekleyebilirsiniz.
Referanslar, komut dosyaları, örnekler vb. klasörleriniz olabilir; bunlar Claude'un daha etkili çalışmasına yardımcı olur.
Claude'u Raylara Oturtmaktan Kaçının
Claude genellikle talimatlarınıza uymaya çalışacaktır ve Beceriler o kadar yeniden kullanılabilir olduğundan, talimatlarınızda çok spesifik olmamaya dikkat etmelisiniz. Claude'a ihtiyacı olan bilgiyi verin, ancak duruma uyum sağlama esnekliğini de tanıyın. Örneğin:
Kurulumu Düşünün
Bazı becerilerin kullanıcıdan bağlam alınarak kurulması gerekebilir. Örneğin, standup'ınızı Slack'te paylaşan bir beceri yapıyorsanız, Claude'un hangi Slack kanalına göndereceğini sormasını isteyebilirsiniz.
Bunu yapmak için iyi bir desen, bu kurulum bilgilerini yukarıdaki örnekteki gibi beceri dizininde bir config.json dosyasında saklamaktır. Yapılandırma ayarlanmamışsa, ajan daha sonra kullanıcıya bilgi sorabilir.
Ajanın yapılandırılmış, çoktan seçmeli sorular sunmasını istiyorsanız, Claude'a AskUserQuestion aracını kullanması talimatını verebilirsiniz.
Açıklama Alanı Model İçindir
Claude Code bir oturum başlattığında, kullanılabilen her beceriyi açıklamasıyla birlikte listeleyen bir liste oluşturur. Claude bu listeyi tarar ve "bu istek için bir beceri var mı?" kararını verir. Bu, açıklama alanının bir özet olmadığı anlamına gelir — bu PR'ın ne zaman tetikleneceğinin açıklamasıdır.
Bellek ve Veri Depolama
Bazı beceriler, içlerinde veri depolayarak bir tür bellek içerebilir. Verileri, yalnızca ekleme yapılan bir metin günlük dosyası veya JSON dosyaları kadar basit ya da bir SQLite veritabanı kadar karmaşık herhangi bir şeyde saklayabilir.
Örneğin, bir standup-post becerisi, yazdığı her gönderiyle birlikte bir standups.log dosyası tutabilir; bu, bir sonraki çalıştırdığınızda Claude'un kendi geçmişini okumasını ve dünden bu yana neyin değiştiğini söyleyebilmesini sağlar.
Beceri dizininde saklanan veriler, beceriyi yükselttiğinizde silinebilir, bu nedenle bunları kararlı bir klasörde saklamalısınız. Bugün itibarıyla, her eklenti için veri depolamak üzere kararlı bir klasör olarak ${**CLAUDE_PLUGIN_DATA**} sunuyoruz.
Komut Dosyalarını Saklayın ve Kod Oluşturun
Claude'a verebileceğiniz en güçlü araçlardan biri koddur. Claude'a komut dosyaları ve kütüphaneler vermek, Claude'un dönüşlerini kompozisyona, sıradaki adıma karar vermeye harcamasını sağlar, tekrarlayan kodları yeniden oluşturmak yerine.
Örneğin, veri bilimi becerinizde, olay kaynağınızdan veri getirecek bir kütüphane işlevleri olabilir. Claude'un karmaşık analiz yapabilmesi için, aşağıdaki gibi bir dizi yardımcı işlev verebilirsiniz:
Claude daha sonra, "Salı günü ne oldu?" gibi istemler için daha gelişmiş analizler yapmak üzere bu işlevselliği birleştirmek üzere anında komut dosyaları oluşturabilir.
İsteğe Bağlı Kancalar (On Demand Hooks)
Beceriler, yalnızca beceri çağrıldığında etkinleşen ve oturum boyunca süren kancalar içerebilir. Bunu, her zaman çalışmasını istemediğiniz ancak bazen son derece kullanışlı olan daha görüşlü kancalar için kullanın.
Örneğin:
- /careful — Bash üzerinde PreToolUse eşleştiricisi aracılığıyla rm -rf, DROP TABLE, force-push, kubectl delete işlemlerini engeller. Bunu yalnızca prod'a dokunduğunuzu bildiğinizde istersiniz — her zaman açık olması sizi çıldırtır.
- /freeze — Belirli bir dizinde olmayan herhangi bir Düzenleme/Yazma işlemini engeller. Hata ayıklarken kullanışlıdır: "Günlük eklemek istiyorum ama yanlışlıkla ilişkisiz şeyleri 'düzeltiyorum'"
- /freeze — Belirli bir dizinde olmayan herhangi bir Düzenleme/Yazma işlemini engeller. Hata ayıklarken kullanışlıdır.
Becerileri Dağıtma
Becerilerin en büyük faydalarından biri, bunları ekibinizin geri kalanıyla paylaşabilmenizdir.
Becerileri başkalarıyla paylaşmanın iki yolu vardır:
- becerilerinizi reponuza (./.claude/skills altına) ekleyin
- bir eklenti (plugin) yapın ve kullanıcıların eklenti yükleyip kurabileceği bir Claude Code Eklenti Pazarı (Plugin Marketplaces) oluşturun (daha fazlasını dokümantasyonda okuyun)
Nispeten az sayıda repo üzerinde çalışan daha küçük ekipler için, becerileri repolara eklemek iyi çalışır. Ancak eklenen her beceri modele biraz daha bağlam ekler. Ölçek büyüdükçe, dahili bir eklenti pazarı, becerileri dağıtmanıza ve ekibinizin hangilerini kuracağına karar vermesine olanak tanır.
Bir Pazarı Yönetme
Bir pazara hangi becerilerin gireceğine nasıl karar veriyorsunuz? İnsanlar bunları nasıl gönderiyor?
Karar veren merkezi bir ekibimiz yok; bunun yerine en kullanışlı becerileri organik olarak bulmaya çalışıyoruz. İnsanların denemesini istediğiniz bir beceriniz varsa, bunu GitHub'da bir kum havuzu (sandbox) klasörüne yükleyebilir ve insanları Slack veya diğer forumlarda buna yönlendirebilirsiniz.
Bir beceri ivme kazandıktan sonra (buna beceri sahibi karar verir), onu pazara taşımak için bir PR açabilir.
Bir uyarı notu: Kötü veya gereksiz beceriler oluşturmak oldukça kolay olabilir, bu nedenle yayınlamadan önce bir tür küratörlük yönteminizin olması önemlidir.
Becerileri Birleştirme (Composing Skills)
Birbirine bağımlı becerilere sahip olmak isteyebilirsiniz. Örneğin, bir dosyayı yükleyen bir dosya yükleme becerisi ve bir CSV oluşturup yükleyen bir CSV oluşturma becerisi olabilir. Bu tür bir bağımlılık yönetimi henüz pazarlara veya becerilere yerel olarak yerleşik değildir, ancak diğer becerilere adlarıyla referans verebilirsiniz; model, eğer kuruluysa onları çaıracaktır.
Becerileri Ölçme
Bir becerinin nasıl gittiğini anlamak için, şirket içinde beceri kullanımını günlüğe kaydetmemizi sağlayan bir PreToolUse kancası kullanıyoruz (örnek kod burada). Bu, popüler olan veya beklentilerimize göre az tetiklenen becerileri bulmamızı sağlar.
Sonuç
Beceriler, ajanlar için inanılmaz derecede güçlü ve esnek araçlardır, ancak henüz başlangıç aşamasındayız ve hepimiz onları en iyi nasıl kullanacağımızı çözmeye çalışıyoruz.
Bunu kesin bir kılavuzdan ziyade, işe yaradığını gördüğümüz kullanışlı ipuçlarından oluşan bir seçki olarak düşünün. Becerileri anlamanın en iyi yolu, başlamak, denemek ve sizin için neyin işe yaradığını görmektir. Bizimkilerin çoğu birkaç satır ve tek bir tuzakla başladı ve Claude yeni uç durumlarla karşılaştıkça insanlar eklemeye devam ettiği için daha iyi hale geldi.
Umarım yardımcı olmuştur, sorularınız varsa bana bildirin.
