Ajan Becerileri İçin Yeni Başlayanlar Rehberi: İlk Becerinizi Oluşturun

Yapay zeka ile çalışan herkes şu sorunla karşılaşmıştır:

Bir şey öğretirsiniz, ertesi gün yeni bir konuşma başlatırsınız ve her şey sıfırlanır.

Bir iş akışını düzeltmek için üç gün harcar, Claude'la ileri geri uğraşırsınız, ancak ertesi gün her şeyi yeniden anlatmak zorunda kalırsınız.

Notlarınıza istemler kaydeder ve her seferinde yapıştırırsınız, ancak bir ay boyunca her gün 500 kelimelik bir talimatı yapıştırmak insanın aklına şu soruyu getirir: Yapay zeka gerçekten böyle mi kullanılmalı?

Skill, tam da bu sorunu çözmek için doğdu.

Ekim 2025'te Anthropic tarafından piyasaya sürüldü ve Aralık ayında açık standart haline geldi.

Bugün tüm internet "Beceriler üretkenliği değiştiriyor" diye bağırıyor, ancak çoğu insan bunu yalnızca duymuş durumda; Skills, istemler, bilgi tabanları, MCP ve ajanlar arasındaki farkı gerçekten anlamıyor, hele ki kendi başına bir tane oluşturmayı hiç bilmiyor.

Bu makale her şeyi bir kerede açıklıyor.

Öncelikle bir şeyi anlayın: Skills belirli bir yapay zekaya bağlı değildir.

Birçok kişi "Claude Skills" duyuyor ve bunun yalnızca Claude'a özel bir özellik olduğunu düşünüyor, ancak öyle değil. Agent Skills, Anthropic tarafından başlatılan açık bir standarttır; Claude ise yalnızca öncü uygulayıcıdır.

Aynı Skill klasörü, Claude Code için ~/.claude/skills/, Cursor için ~/.cursor/skills/ konumuna yerleştirilebilir veya OpenAI Codex, Gemini CLI, VS Code Copilot ve JetBrains Junie ile kullanılabilir.

Bugün yazdığınız Skill, yarın sorunsuzca başka bir Ajan'a taşınabilir; yatırımınız tek bir şirkete kilitlenmez.

Bu makale öncelikle Claude Code'u örnek olarak kullanacaktır (standart belirleyici ve en eksiksiz ekosisteme sahip olduğu için), ancak tüm prensipler, yazma yöntemleri ve sorun giderme deneyimleri Agent Skills'i destekleyen tüm yapay zeka araçları için geçerlidir.

"Claude Skill" gördüğünüzde, "Agent Skill" olarak düşünün.

1. Skill Tam Olarak Nedir?

Tek cümlede tanım:

Bir Skill, sizin tanımladığınız bir SOP'ye göre bir yapay zekaya belirli bir tür profesyonel işi nasıl istikrarlı bir şekilde gerçekleştireceğini söyleyen, SKILL.md adlı bir Markdown dosyası etrafında şekillenen bir klasördür.

"Belirli bir tür işin nasıl yapılması gerektiğini" yeniden kullanılabilir, otomatik olarak tetiklenen bir yetenek modülü halinde kapsüller.

Temel olarak, genel amaçlı yapay zeka için bir "genişletme paketidir".

Genel yapay zeka, zeki olan ancak alan bilgisinden yoksun, çıplak bir makine gibidir. Bir Skill, tak ve çalıştır bir modüldür: bir "Xiaohongshu Stili Skill" kurun, yapay zeka anında markanızı anlayan bir editör haline gelir; bir "Haftalık Rapor Skill"i kurun, yapay zeka anında şirketinizin formatında raporlar oluşturur.

Ve bu "genişletme paketi" yapay zeka konusunda seçici değildir: Claude Code, Codex, Cursor, Gemini CLI ve Junie'nin tümü aynı formatı tanır.

Bir Claude'a özel komut dosyası değil, bir Ajan Becerisi (Agent Skill) yapıyorsunuz.

Dört Diğer Kavramla Sınırlar:

Birçok kişi Skills'i istemler, bilgi tabanları, MCP ve ajanlarla karıştırır, ancak bunlar farklıdır:

Yaygın benzetmeler:

• Prompt (İstem) = Bir çalışana WeChat mesajı göndermek; iş bittiğinde unutur.
• Skill (Beceri) = Çalışan için bir el kitabı yazıp masasına koymak, yanına da bir alet çantası eklemek.
• Knowledge Base (Bilgi Tabanı) = Dünyada neler olduğunu söyleyen bir kütüphane.
• MCP = "Yapılabilir mi" sorununu çözen çeşitli mutfak aletleri.
• Agent (Ajan) = Hafızası ve karar alma mekanizması olan tüm çalışan sistemi; Skill bunun sadece bir parçasıdır.

Bu dördü birbirini dışlamaz.

Gerçek işlerde sıklıkla birleştirilirler: MCP, Claude'un Reddit'e bağlanıp veri kazımasını sağlar, bir Skill ona bu verileri nasıl filtreleyeceğini/sınıflandıracağını/önereceğini öğretir, bir Bilgi Tabanı marka materyalleri sağlar ve Ajan süreci yürüten tüm sistemdir.

2. Mimari ve Çalışma Mekanizması

Dosya Yapısı

Her bir alt dizin farklı bir sorunu çözer ancak aynı amaca hizmet eder—bağlamdan tasarruf etmek ve kaliteyi sabitlemek:

• scripts/: Bağlam tüketmeden doğru hesaplamalar.
• references/: İhtiyaç halinde yüklenir, yer israfını önler.
• assets/: Çıktı formatlarını standartlaştırır.

Üç Katmanlı Aşamalı Açıklama—Skill Tasarımının Ruhu

Bir Skill'in temel mekanizması üç katmanlı yüklemedir; bu sayede bir düzine Skill, bağlamı patlatmadan bir arada var olabilir:

Örneğin:

Claude başladığında, hangisini kullanacağına karar vermek için tüm Skills'in "kapaklarına" göz atar; yalnızca çalışma zamanı geldiğinde ana metni açar; ve yalnızca bir eke bakması gerektiğinde referanslara gider.

Bu mekanizma, 200K bağlam penceresini tıkamadan aynı anda 17 Skill'in etkin olmasını sağlar.

YAML Meta Verileri

Alan açıklamaları:

Açıklama Başarıyı veya Başarısızlığı Belirler

Üç katmanlı mimaride, L1 açıklaması en kritik olanıdır—Skill'inizin tetiklenip tetiklenmeyeceğini belirler.

Önemli gerçekler:

1. Claude başlangıçta yalnızca tüm Skills'in açıklamalarını okur.
2. Anahtar kelime eşleştirmesine değil, açıklamaya dayalı anlamsal yargılarda bulunur.
3. Claude muhafazakar olma eğilimindedir: emin değilse tetiklemez. Testlerde, belirsiz açıklamalar yalnızca %55 tetikleme doğruluğuna sahipti.

Olumsuz örnek (asla tetiklenmez):

[Belirsiz açıklama]

Olumlu örnek (Anthropic'in önerdiği "zorlayıcı" stil):

[Spesifik açıklama]

Açıklama yazmak için üç altın kural:

1. NE + NE ZAMAN birlikte yazın: Ne yaptığını ve ne zaman kullanılacağını söyleyin.
2. Tetikleyici kelimeleri hem Türkçe hem İngilizce listeleyin: Kullanıcının ne söylediğiyle eşleşsin.
3. Muhafazakar olmaktansa zorlayıcı olun: Anthropic, ana sorunun yetersiz tetikleme olduğunu açıkça belirtiyor.

3. İyi Skills Yazmak İçin Temel İlkeler

Üç Ana Prensip

Özgürlükle nasıl başa çıkılır:

Beş Tasarım Deseni

Anthropic, ilk kullanıcılardan beş Skill tasarım deseni çıkardı:

Kullanışlı Skills genellikle birden çok deseni birleştirir. Bunlara harfiyen uymak zorunda değilsiniz, ancak var olduklarını bilmek daha yapılı bir şekilde tasarlamanıza yardımcı olur.

Altın Kural: "Zorunlu" yerine "Neden" Kullanın

Bu, skill-creator'ın (Skills yapmak için Anthropic'in resmi meta-skill'i) kaynak kodundan bir alıntıdır:

"Modele, katı ve zorlayıcı ZORUNLULUKLAR yerine bir şeylerin neden önemli olduğunu açıklamaya çalışın."

Olumsuz örnek:

[Katı ZORUNLU kurallar]

Olumlu örnek:

[Mantığı açıklamak]

İlk durumda, Claude yalnızca bu iki kurala uyacaktır. Kuralların kapsamadığı durumlarda (güvenli görünen ancak riskli bir komut gibi) takılıp kalır. İkinci durumda, Claude "güvenliğin neden önemli olduğunu" anlar ve gri alanlarda bile dikkatli olmaya yönelecektir.

Nedenler, modelin genelleme yapmasını sağlar; kurallar ise yalnızca aklınıza gelen senaryoları kapsar. Tek istisna çıktı formatıdır: "çıktı bu şablonu kullanmalıdır" gibi mekanik gereksinimlerin açıklanacak bir "neden"i yoktur, bu yüzden doğrudan kodlayın.

Bilgi Sahipliği: Kendinizi Tekrarlamayın

skill-creator'ın ayrıca kesin bir kuralı vardır:

"Bilgi, SKILL.md veya referanslarda bulunmalıdır—ikisinde birden değil."

SKILL.md yalnızca temel prosedürleri içermeli; ayrıntıları references/ klasörüne taşıyın. Yinelenen depolama, bir yeri güncellerken diğerini unuttuğunuzda tutarsızlıklara yol açar.

Kaçınılması Gereken Dosyalar

Skills yapay zeka içindir, insanlar için değil. README.md, INSTALLATION_GUIDE.md, QUICK_REFERENCE.md veya CHANGELOG.md eklemeyin. Bu insan belgeleri yalnızca bağlamı boşa harcar.

4. İlk Skill'inizi Oluşturmak

Anthropic'in Resmi Altı Adımı

skill-creator içinde tanımlanan standart süreç:

1. Niyeti Yakala: Ne yapılacağını / ne zaman tetikleneceğini / çıktı formatını / test ihtiyaçlarını netleştirin.
2. Görüşme ve Araştırma: Uç durumlar / G/Ç formatları / örnek dosyalar / bağımlılıklar.
3. SKILL.md Yazın: Taslağı yazın.
4. Test Durumları: 2-3 gerçek test durumu yazın.
5. Çalıştır ve Değerlendir: Skill'li ve temel (skillsiz) sürümleri yan yana çalıştırarak bir kıyaslama yapın.
6. Yinele: Geri bildirime göre değiştirin ve tatmin olana kadar yeniden çalıştırın.

Normal Kullanıcılar İçin Dört Hızlı Yol

skill-creator: Skills Yazmak İçin Meta-Skill

Anthropic'in resmi skill-creator'ını ilk önce kurmanızı şiddetle tavsiye ederim. Skills oluşturmanıza yardımcı olmak için tasarlanmış bir Skill'dir. Başlatıldığında, Claude sizinle görüşme yapacak—iş akışınızı, tetikleme koşullarınızı ve sınırlarınızı soracak—ardından SKILL.md ve klasör yapısını otomatik olarak oluşturacaktır.

Kurulum komutu:

[Komut]

Yalnızca çıktı üretmekle kalmaz, aynı zamanda size şu konularda da yardımcı olur:

• Eval: Skill'in doğru tetiklenip tetiklenmediğini doğrulamak için otomatik olarak test durumları oluşturun.
• Improve: Test sonuçlarına göre açıklamaları ve talimatları otomatik olarak optimize edin, aşırı uyumu önlemek için %60/%40 eğitim/test bölmesi kullanın.
• Benchmark: Başarı oranlarını ve token kullanımını takip edin, hatta iki sürüm arasında A/B testleri yapın.

Minimum Örnek

Diyelim ki bir Xiaohongshu yemek blogcusunuz ve normal tarifleri Xiaohongshu stiline yeniden yazmak istiyorsunuz:

Bunu ~/.claude/skills/xiaohongshu-recipe/SKILL.md konumuna yerleştirin. Gelecekte "Xiaohongshu versiyonuna dönüştür" dediğinizde otomatik olarak tetiklenecektir.

Dosyayı oluşturmaktan kullanmaya kadar 20 dakikadan az sürer.

5. Kurulum, Depolama ve Araçlar Arası Kullanım

Yükleme Önceliği (4 Seviye)

Claude Code aşağıdaki sırayla arar; daha spesifik konumlar daha yüksek önceliğe sahiptir:

İpucu: Projeye özel olmadıkça, tek bir yönetim için kişisel ~/.claude/skills/ dizininde tutun.

Üç Kurulum Yöntemi:

Kurulumdan sonra Claude Code'u yeniden başlatmayı unutmayın.

Araçlar Arası Uyumluluk (Tekrar Vurgulanıyor)

Daha önce belirtildiği gibi, Skills Claude'a bağlı değildir. İşte yol karşılaştırmaları:

Operasyonel anlamı: Aynı SKILL.md klasörünü farklı araç dizinlerine sembolik bağlayabilirsiniz. Agent Skills'in açık bir standart olarak en büyük faydası budur.

Yerel Kullanıcıların Sorunları

• Resmi Claude pahalıdır: Daha iyi performans/maliyet için proxy API'leri kullanın.
• CC Switch: Birden çok API yapılandırmasını yönetmek ve değiştirmek için açık kaynaklı bir araç (github.com/farion1231/cc-switch).
• Yerel kurulum npm'den daha kararlıdır: curl -fsSL https://claude.ai/install.sh | bash.

6. İleri Seviye—Çoklu Skill İş Birliği Mimarisi

Ayrıntı Düzeyi

Temel İlke: Her Skill net bir görev için. "Evrensel bir Skill" yapmayın.

Ayrıntı düzeyi çok kaba olursa, açıklama net olmaz ve tetiklemeler kesin olmaz. Çok ince olursa, yönetim maliyetleri artar. Makul bir ayrıntı düzeyi, sorun kategorisi başına bir Skill, SKILL.md gövdesi yaklaşık 200-500 satırdır.

Örnek Olay: Blog Yazma Skill Paketi

Tek bir "Her Şeyi Yapan Yazma Skill"i yapmayın. Bunu iş birliği yapan 5 Skill'e bölün:

İş birliği modu: Ana Skill, ## Steps bölümünde diğer Skills'i açıkça çağırır.

Bu bölmenin faydaları:

Beş Mühendislik Deneyimi

1. İnce ayrıntı düzeyi: Her Skill net bir görev için.
2. Açık iş birliği: Diğerlerini çağırmak için ana Skill'de ## Steps kullanın.
3. Hesaplama için Script'ler: SEO karakter sayıları veya bağlantı istatistikleri için script'ler kullanın; modelin tahmin etmesine izin vermeyin.
4. Bağımsız stil kılavuzları: Kararlı bilgiyi (yazım stili/marka özellikleri) references/ klasörüne koyun, böylece stili güncellemek için yalnızca bir dosyayı değiştirirsiniz.
5. Şablon yedeği: Şablonlar, çıktının çok fazla sapmaması için bir temel garanti sağlar.

7. Profesyonel Değerlendirme ve Yineleme

Değerlendirme Sistemi:

skill-creator'dan standart süreç:

1. evals/evals.json dosyasına test istemleri yazın.
2. Çift kör bir karşılaştırma için with_skill ve baseline (skillsiz) sürümlerini aynı anda çalıştırın.
3. agents/grader.md kullanarak her bir iddiayı puanlayın.
4. aggregate_benchmark kullanarak pass_rate / time / tokens hakkında bir rapor çıktısı alın.

Otomatik Açıklama Optimizasyonu

skill-creator'un en değerli kısmı Açıklama Optimizasyonu'dur:

• 20 tetikleyici değerlendirme sorgusu yazın (8-10 tetiklemeli + 8-10 tetiklememeli).
• Zorluk: Tetiklememesi gerekenler için "neredeyse kaçıranlar"—anahtar kelimeleri paylaşan ancak diğer araçlara ihtiyaç duyan sorgular.
• Optimizasyon komut dosyası: Aşırı uyumu önlemek için %60 eğitim + %40 ayrılmış test.
• En yüksek test puanına sahip açıklamayı seçmek için 5 tur çalıştırın.

Tetikleyicilerin iyi örnekleri: Sadece "PDF tablosunu çıkar" yazmayın; gerçek bir kullanıcı gibi yazın:

"tamam patronum bana bu xlsx dosyasını gönderdi (indirilenler klasörümde, 'Q4 satış final FINAL v2.xlsx' gibi bir şey) ve kar marjını yüzde olarak gösteren bir sütun eklememi istiyor."

Bu, dosya yollarını, kişisel bağlamı, sütun adlarını, gündelik dili ve olası yazım hatalarını içerir.

Yineleme Zihniyeti

skill-creator'dan dört nokta:

1. Geri bildirimden genelleme yapın: Tek bir durum için ince ayarlı kurallar eklemeyin. Bir sorun tekrarlıyorsa, farklı bir metafor veya iş akışı deneyin.
2. Sade tutun: Zaman kaybettiren talimatlar için transkriptleri kontrol edin ve yardımcı olmayan kısımları silin.
3. Nedenini açıklayın: LLM'ler zihin teorisine sahiptir ve genelleme yapabilir.
4. Gereksiz iş bulun: Her alt ajan bağımsız olarak create_docx.py yazıyorsa, bunu scripts/ klasöründe toplayın.

İlk sürüm asla mükemmel değildir.

Gerçek bir yineleme örneği: Bir yazarın /daily becerisi 6 sürümde stabilize oldu.

• v1: Net olmayan adımlar, yanlış yollar.
• v2: İçerik keşif sistemi entegrasyonu eklendi.
• v3: Haftalık ilerleme hesaplama hataları düzeltildi.
• v4: Otomatik tetikleyiciler eklendi (Salı hatırlatıcıları, ay sonu arşivleme).
• v5: iPhone açık modu eklendi (mobilde Python adımlarını atlama).
• v6: Sonunda "kullanımı iyi."

Bir Skill, kur ve unut tarzı bir yapılandırma dosyası değildir; iş akışınızın yaşayan bir belgesidir.

8. Ne Zaman Skill Yapmalısınız?

Her şey bir Skill'e değmez. Yalnızca şu üç sinyalden biri göründüğünde harekete geçin:

Tersine: Ne Zaman Skill YAPMAMALI

• Tek seferlik görevler: Sadece bir istem kullanın.
• Aşırı kapsülleme: Yalnızca üç kullanımdan sonra Skills'e ayırmak; bakım maliyetleri faydalardan ağır basar.
• Mükemmeliyetçilik: v1'i mükemmel yapmaya çalışmak; gerçekten kullanmaya başladığınızda ihtiyaçların hayal ürünü olduğunu göreceksiniz.

9. Tuzak Kontrol Listesi

10. Ekosistem ve Olmazsa Olmazlar Listesi

Beceri Kaynak Haritası

Olmazsa Olmaz Skill Listesi

11. Skills'in Ticari Potansiyeli

Skills, kişisel verimlilik araçlarından daha fazlasıdır; yapay zeka uygulamalarının nasıl üretildiğini yeniden tanımlıyorlar.

Geçmişte, dikey bir yapay zeka uygulaması geliştirmek uzun döngüler, yüksek maliyetler ve teknik ekipler gerektiriyordu. Şimdi:

• Kod gerektirmeyen eşik: Kod yazmadan dikey Ajanlar oluşturun.
• Hızlı doğrulama: Geliştirme döngüleri haftalardan dakikalara sıkıştırıldı.
• API Hizmeti: Bir Skill'i API olarak paketleyip mevcut ürünleri güçlendirin.
• Skills ürün olarak: İstem koleksiyonları satmaya benzer, ancak daha yüksek değerle.

Gerçek vakalar:

• Article-Copilot: Malzeme temizliğinden yazmaya kadar tüm zincir için tek bir Skill.
• AI Partner Skill: Genel Ajanlara derin hafıza vererek gerçek arkadaşlar haline getirir.
• Mülakat Hazırlık Skill: Şirket/pozisyon/özgeçmişe göre tam raporlar oluşturur. Birisi bunu kullanarak Hithink RoyalFlush'ta mülakata girdi.
• Süper Huang'ın yöntemi: Düzinelerce Skill + cron işleri ile o uyurken saatlik raporlar çalıştırıyor.

Herhangi bir sektörde derinlemesine bilgi sahibi olan herkes, deneyimini bir Skill'e dönüştürerek zaman kazanabilir veya bunu bir ürün olarak satabilir.

Sonuç

Bir Ajan, yapay zeka dünyasının bedeniyse, bir Skill ona enjekte edilen ruhtur.

Bu, Steam ile Workshop arasındaki ilişki gibidir; genişletilebilir mimari, oyunlara sonsuz ömür verir.

Skills zor değildir—biraz yapıya sahip Markdown'dur. Ancak temsil ettikleri eğilim hayatidir: yapay zekanın "her seferinde öğretmek zorundasın" dan "bir kere öğretiyorsun" a geçişi.

Ve standart açıktır. Bugün Claude Code için yazdığınız Skill, yarın Cursor veya Gemini'ye taşınabilir.

Hâlâ izleyenlere:

Skills tasarlanmaz; tekrarlanan emekten doğar.

Önce bir şeyi çalıştırın, sonra kapsülleyin. İyi iş akışları planlanmaz, yinelenir.

Terminalinizi açın, skill-creator kurun ve bugün üç kez tekrarladığınız o paragrafı ilk SKILL.md dosyanıza dönüştürün.