11. Skills (Beceriler)

Bölüm 7'de projelerin, modelin hafızasızlığını proje düzeyinde telafi ettiğini gördük. Beceriler farklı bir sorunu çözer: tekrarlanabilir uzmanlığı paketlemek.

Bir proje talimatı yalnızca o projede geçerlidir. Bir beceri ise, tanımladığınız koşullar oluştuğunda hangi projede olursanız olun devreye girer — ve başkalarıyla paylaşılabilir.

11.1 Beceri Nedir?

Beceri, içinde SKILL.md adlı bir dosya bulunan bir klasördür. Bu dosya iki bölümden oluşur: Claude'un beceriyi ne zaman kullanacağını söyleyen üst veri, ve kullanacağı talimatları içeren gövde.

Klasör isteğe bağlı olarak ek dosyalar da barındırabilir: çalıştırılabilir betikler, ayrıntılı başvuru belgeleri, şablonlar.

11.2 Kademeli Açılım

Becerilerin en önemli tasarım ilkesi kademeli açılımdır (progressive disclosure). Bu ilke, bağlam penceresini korurken çok sayıda beceriye sahip olmayı mümkün kılar.

Mekanizma üç kademelidir. Oturum başında Claude yalnızca her becerinin adını ve açıklamasını okur — beceri başına yaklaşık yüz token. Bir görev, bir becerinin açıklamasıyla eşleştiğinde o becerinin tam gövdesi bağlama yüklenir. Ek dosyalar ise ancak gerçekten ihtiyaç duyulduğunda okunur.

Kaynak: Anthropic, "Skills overview" — https://claude.com/docs/skills/overview ve "Equipping agents for the real world with Agent Skills" — https://www.anthropic.com/engineering. Doğrulama tarihi: 6 Eylül 2026.

Bu yapı, Bölüm 1.7'deki dikkat seyrelmesi sorununa doğrudan bir çözümdür: otuz beceriniz olsa bile bağlamda sürekli duran şey yalnızca otuz kısa açıklamadır.

Şekil 11.1 — Kademeli açılım, çok sayıda beceriyi bağlam tüketmeden taşınabilir kılar.

11.3 Beceri ile Proje Talimatı Ayrımı

Pratik ölçüt: aynı talimatı ikinci kez farklı bir projede yazıyorsanız, o bir beceri olmalıdır.

11.4 Açıklama Yazımı: En Kritik Adım

Bir becerinin en önemli satırı açıklamasıdır, çünkü tetiklenme tamamen buna bağlıdır. Gövde ne kadar iyi olursa olsun, açıklama eşleşmezse beceri hiç devreye girmez.

Bilinen Sorun: Yetersiz Tetiklenme

Anthropic'in kendi beceri oluşturma rehberi açık bir uyarı içerir: Claude'un becerileri gerektiğinde kullanmama eğilimi vardır. Rehber, buna karşı açıklamaların bilinçli olarak ısrarcı yazılmasını önerir.

Bir Diğer Sınır

Beceriler yalnızca Claude'un kendi başına kolayca halledemeyeceği görevler için devreye girer. Tek adımlık basit bir istek, açıklama kusursuz eşleşse bile beceriyi tetiklemeyebilir; çünkü model o işi doğrudan yapabilir. Çok adımlı, karmaşık veya uzmanlık gerektiren görevler ise güvenilir biçimde tetikler.

11.5 Vaka İncelemesi: Canlı Beceri Üretimi

Bu kitabın hazırlanması sırasında, kitabın kendi doğrulama metodolojisini kalıcı hale getiren bir beceri üretildi. Süreç baştan sona belgelenmiştir.

Amaç

Kitabın ana prompt'unda tanımlanan doğrulama kuralları — kaynak zorunluluğu, doğrulanamayanı işaretleme, hızlı eskiyen veriyi sabitlememe — her yeni oturumda elle yapıştırılmak zorundaydı. Beceri, bu tekrarı ortadan kaldırmak için üretildi.

Bu, 11.3'teki ölçütün somut bir uygulamasıdır: aynı talimat ikinci kez yazılıyorsa, beceri olmalıdır.

Yapı

Kademeli açılım burada bilinçli olarak kullanıldı: kaynak hiyerarşisi tablosu ve çelişki çözme yöntemi ana dosyada değil, ayrı bir başvuru dosyasında tutuldu. Bu ayrıntılar yalnızca gerçekten çelişkili kaynaklarla karşılaşıldığında okunur; her tetiklenmede bağlam tüketmez.

Karşılaşılan Engel

Beceriyi paketleme adımında gerçek bir hata alındı: paketleme betiği, çıktı dosyasını kendi bulunduğu dizine yazmaya çalıştı; ancak o dizin salt-okunur olduğu için işlem başarısız oldu.

Çözüm, beceri dosyasının yazılabilir bir dizinde doğrudan arşivlenmesi oldu. Bir beceri dosyası, içinde beceri klasörünü barındıran sıradan bir zip arşividir; uzantısı dışında özel bir biçimi yoktur.

Doğrulama

Son satır kitabın yöntemi açısından önemlidir: beceri üretilmiş ve paketlenmiştir, ancak kurulduğunda beklenen anda tetiklenip tetiklenmediği ancak kullanıcı tarafından denenerek öğrenilir. Bu, Bölüm 8'deki artifact vakasıyla aynı ayrımdır.

11.6 Beceri Yazım İlkeleri

• Tek bir işe odaklan. Birden çok odaklı beceri, tek bir kapsayıcı beceriden daha iyi çalışır.
• Açıklamayı ısrarcı yaz. Hem ne yaptığını hem hangi durumlarda kullanılacağını belirt.
• Gövdeyi kısa tut. Beş yüz satırı aşıyorsa, ayrıntıyı başvuru dosyasına taşı.
• Belirlenimci işi betiğe al. Hesaplama, dosya adlandırma, API çağrısı gibi işler kod olarak yazılırsa model doğaçlama yapmaz.
• Başvuru dosyalarına ne zaman bakılacağını gövdede açıkça belirt.
• Yasakları da yaz. Modelin yapmamasını istediğin şey, yapmasını istediğin kadar önemlidir.
• Test et. Beceri kurulduktan sonra beklenen anda tetiklenip tetiklenmediğini gerçek bir görevle dene.

11.7 Kurulum ve Paylaşım

Paketlenmiş bir beceri dosyası sunulduğunda, alıcının hesabında beceri oluşturmaya izin veriliyorsa kaydetme seçeneği görünür. Kurumsal hesaplarda bu yetki yönetici tarafından kısıtlanmış olabilir.

11.8 Bölüm Özeti

• Beceri, SKILL.md dosyası içeren ve tekrarlanabilir uzmanlığı paketleyen bir klasördür.
• Kademeli açılım sayesinde çok sayıda beceri bağlam tüketmeden taşınabilir.
• Proje talimatı o projeye özgüdür; beceri tüm oturumlarda tetiklenebilir ve paylaşılabilir.
• Aynı talimatı ikinci kez farklı bir projede yazıyorsanız, o bir beceri olmalıdır.
• Açıklama en kritik satırdır; tetiklenme tamamen ona bağlıdır.
• Claude becerileri yetersiz tetikleme eğilimindedir; açıklamalar ısrarcı yazılmalıdır.
• Basit tek adımlık görevler, açıklama eşleşse bile beceriyi tetiklemeyebilir.
• Belirlenimci işler betiğe alınmalıdır; model o zaman doğaçlama yapmaz.
• Paketleme betiği salt-okunur dizinde başarısız olabilir; beceri dosyası sıradan bir zip arşividir.

Güncellik kontrolü: Kavramsal içerik https://claude.com/docs/skills/overview adresinden 6 Eylül 2026 itibarıyla doğrulanmıştır. Vaka incelemesi aynı tarihli canlı oturumda üretilmiştir; kurulum ve tetiklenme doğrulaması kullanıcıya bırakılmıştır.