Claude Skills nedir? Beceri dosyalarıyla Claude'a bir işi bir kez öğretmek
SKILL.md yapısı, nerede durduğu, ne zaman yüklendiği, CLAUDE.md ve MCP'den farkı ve ilk becerini kurma adımları
Claude Skills nedir sorusunun kısa cevabı şu: Skills, Claude'a belirli bir işi nasıl yapacağını öğreten, içinde SKILL.md dosyası bulunan talimat klasörleridir [1][3]. Her becerinin başında bir ad ve açıklama yer alır. Claude isteğini bu açıklamalarla karşılaştırır ve eşleşen beceriyi kendiliğinden devreye sokar [1]. Başlangıçta yalnız ad ve açıklama yüklenir, tam içerik ancak gerektiğinde okunur. Böylece çok sayıda beceri kurabilirsin ve bağlam penceresi dolmaz [2]. Beceriler talimatların yanında betik, şablon ve referans dosyaları da taşıyabilir [2]. Claude Code'da, Claude API'de ve claude.ai ayarlarında kullanılabilir [2].
Skill tam olarak nedir?
Skill, bir işin yapılış biçimini tek bir yerde tanımlayan klasördür. Bir PR incelemesinde, commit mesajında ya da rapor biçiminde her seferinde aynı açıklamayı tekrar yazmak yerine kuralı bir kez yazarsın. Sonrasında Claude bu bilgiyi ilgili iş geldiğinde kendisi uygular [1].
Klasörün merkezinde SKILL.md dosyası durur. Dosyanın üstünde YAML biçiminde bir ön bilgi (frontmatter) bölümü, altında ise Markdown ile yazılmış talimatlar bulunur [3]. Ön bilgi bölümünde zorunlu olan yalnız iki alan vardır. Biri name, yani küçük harfli ve tireli benzersiz addır. Diğeri description, yani becerinin ne yaptığını ve ne zaman kullanılacağını anlatan açıklamadır [3].
Anthropic, Word, Excel, PowerPoint ve PDF gibi yaygın belge işleri için hazır beceriler sunuyor. Kendi özel becerilerini de yazabilirsin. İki tür de aynı şekilde çalışır [2]. Bir kaynağa göre Skills Ekim 2025'te kullanıma açıldı [7].
- Tekrar tekrar anlattığın talimatları tek dosyada toplar [1]
- Claude açıklamaya bakarak beceriyi kendiliğinden seçer, komut yazman gerekmez [1]
- Talimatın yanında betik, şablon ve referans dosyası taşıyabilir [2]
- Beceriler birleştirilerek çok adımlı işler kurulabilir [2]
Beceriler nasıl yüklenir: kademeli açılım
Resmi dokümantasyon bu yapıya kademeli açılım (progressive disclosure) diyor. Bilgi baştan tek seferde yüklenmez, aşama aşama ve ihtiyaç oldukça okunur [2].
1. düzeyde yalnız ad ve açıklama yüklenir. Bu bilgi oturum başında sistem istemine eklenir ve beceri başına yaklaşık 100 token tutar [2]. 2. düzeyde, isteğin açıklamayla eşleşirse Claude SKILL.md gövdesini bash ile okur. Talimatlar bağlama ancak bu anda girer [2]. 3. düzeyde ek dosyalar devreye girer. FORMS.md gibi ek Markdown dosyaları yalnız talimatta anıldığında okunur. Betikler ise çalıştırılır ve bağlama kodun kendisi değil, yalnız çıktısı girer [2].
Bu yüzden bir beceri onlarca referans dosyası içerebilir. İş yalnız birini gerektiriyorsa Claude sadece onu yükler, diğerleri token harcamaz [2]. Bir üçüncü taraf kaynak ise farklı bir yaklaşım anlatıyor. Bu kaynak dosyayı küçük harfle skill.md olarak anıyor ve bazı kurulumlarda bir skill.json manifesti bulunduğunu söylüyor. Ayrıca dosyanın her çalıştırmada bağlama yüklendiğini, bu nedenle kısa tutulması gerektiğini vurguluyor [5]. Anthropic'in kendi belgeleri ise SKILL.md adını ve yalnız ad ile açıklamanın önceden yüklendiği modeli tarif ediyor [1][2]. Resmi tarifi esas alman daha güvenli olur.
- Ad ve açıklama her zaman yüklüdür, beceri başına yaklaşık 100 token tutar [2]
- SKILL.md gövdesi yalnız beceri tetiklenince okunur [2]
- Ek dosyalar yalnız anıldığında okunur, betiklerin yalnız çıktısı bağlama girer [2]
- Açıklama hem ne yaptığını hem ne zaman kullanılacağını söylemelidir [2]
Beceriler nerede durur?
Claude Code'da bir becerinin nereye konacağı, onu kimin kullanacağına göre değişir [1].
Kişisel beceriler ev dizinindeki ~/.claude/skills klasörüne konur ve tüm projelerinde seninle birlikte gelir. Windows'ta bu yol C:/Users/<kullanıcı>/.claude/skills şeklindedir [1]. Proje becerileri ise deponun kök dizinindeki .claude/skills klasörüne konur ve sürüm kontrolüne eklenir. Depoyu klonlayan herkes bu becerilere otomatik olarak sahip olur [1].
claude.ai tarafında özel becerileri ayarlar üzerinden ekleyebilirsin. API'de beceriler yüklenir. Claude Platform on AWS ve Microsoft Foundry'de ise yükleme Skills API üzerinden yapılır [2]. Anthropic'in örnek becerileri claude.ai'de ücretli planlarda zaten kullanılabilir durumda [3].
- Kişisel: ~/.claude/skills; commit stili, dokümantasyon biçimi gibi senin tercihlerin için [1]
- Proje: .claude/skills; ekip standartları ve marka kuralları için [1]
- claude.ai: ayarlar üzerinden ekleme [2]
- API ve bulut platformları: Skills API ile yükleme [2]
Skills, CLAUDE.md, slash komutları ve MCP arasındaki fark
Bu araçların hepsi Claude'u özelleştirir ama farklı katmanlarda çalışır. CLAUDE.md her konuşmaya yüklenir. Bu yüzden her zaman geçerli kurallar oraya yazılır, örneğin TypeScript'te sürekli strict mod kullanılması [1]. Slash komutlarını açıkça yazarak çağırman gerekir. Beceriler ise iş tanındığında kendiliğinden devreye girer [1].
MCP bir bağlantı protokolüdür. Claude'a veritabanı, GitHub ya da tasarım aracı gibi dış sistemlere erişim sağlar. Ancak bu araçları senin iş akışında nasıl kullanacağını öğretmez. Bu yöntem bilgisini beceri taşır [7]. Aynı kaynağa göre MCP araç tanımları oturum başında yüklendiği için bağlamda orta düzeyde yer kaplar. Beceriler tetiklenene kadar yalnız ön bilgileriyle düşük yer kaplar [7].
Alt ajanlar (subagents) ise kendi ayrı bağlam pencerelerinde çalışan Claude örnekleridir. Görevleri devralmak ve işleri paralel yürütmek için kullanılırlar [7]. Aynı kaynak, çok ajanlı akışların tek ajanlı oturumlara göre kabaca 4 ila 7 kat daha fazla token harcadığını belirtiyor [7].
- Her konuşmada geçerli kural için CLAUDE.md [1]
- Senin elle tetiklemek istediğin işler için slash komutu [1]
- Belirli işe özel, kendiliğinden uygulanan yöntem için Skill [1]
- Canlı veri ve dış servis erişimi için MCP [7]
- Paralel ya da izole bağlam gereken büyük işler için alt ajan [7]
Ne zaman beceri yazmalısın, hangi örnekler uygun?
Basit bir ölçüt var: Claude'a aynı şeyi defalarca açıklıyorsan, yazılmayı bekleyen bir beceri var demektir [1]. Bir kaynak da benzer koşullar sıralıyor. İşin tekrar etmesi, doğru bir yönteminin olması, sistem istemine sığmayacak kadar uzun ya da özel adımlar içermesi ve aynı akışın birden fazla ajan veya araçta çalışması gerekmesi [6].
Anthropic'in örnek deposunda yaratıcı işlerden (sanat, müzik, tasarım) teknik işlere (web uygulaması testi, MCP sunucusu üretimi) ve kurumsal iletişime kadar uzanan beceriler bulunuyor [3]. Bu örnekler yalnız gösterim ve eğitim amaçlıdır. Kritik işlerde kullanmadan önce kendi ortamında test etmen gerekir [3].
Becerinin ölçeklendiği durumda sorunlar da değişir. Bir kaynak, dosyaların depolara dağılmasını, sürüm sabitleme eksikliğini ve aynı becerinin kopyalarının zamanla birbirinden ayrışmasını tipik sorunlar olarak sayıyor [6]. Kod tarafında betikler, yapılandırılmış veri işleme ve koşullu mantık için düz yazı talimatlardan daha güvenilir sonuç verebilir [5][2].
- Ekibin kod inceleme standartları [1]
- Tercih ettiğin commit mesajı biçimi [1]
- Kurum marka kuralları [1][3]
- Belirli belge türleri için şablonlar [1]
- Belirli framework'ler için hata ayıklama kontrol listeleri [1]
- Veri ambarı sorgulama gibi şeması bilinen işler [6]
Adım adım
- Claude'a sık tekrarladığın tek bir işi seç, örneğin commit mesajı yazımı ya da PR incelemesi [1].
- Kapsamı belirle. Yalnız sana özelse ~/.claude/skills, tüm ekip kullanacaksa deponun içindeki .claude/skills klasörünü kullan [1].
- Bu klasörün içinde becerinin adıyla bir alt klasör aç ve içine SKILL.md dosyası oluştur [3].
- Dosyanın başına YAML ön bilgisini yaz: name alanına küçük harfli ve tireli bir ad, description alanına becerinin ne yaptığını ve ne zaman kullanılacağını anlatan bir cümle [3][2].
- Ön bilginin altına talimatları Markdown olarak ekle. Kontrol listesi, biçim kuralları, örnekler gibi [1][3]. Uzun referansları ayrı dosyalara ayır ve talimatta bunlara atıf yap [2].
- Tekrarlanabilir ve kesin sonuç gereken adımlar varsa bunları betik olarak ekle. Claude betiği çalıştırır, bağlama yalnız çıktı girer [2].
- Açıklamayla eşleşen bir istek yazarak test et ve terminalde becerinin yüklendiğini gör [1]. Hazır becerileri denemek istersen Claude Code'da /plugin marketplace add anthropics/skills komutuyla örnek depoyu eklenti pazarı olarak kaydedebilirsin [3].
Kontrol listesi
- description alanı hem ne yaptığını hem ne zaman kullanılacağını söylüyor mu? [2]
- name alanı küçük harfli ve tireli mi? [3]
- Her konuşmada geçerli olması gereken kural yanlışlıkla beceriye değil, CLAUDE.md'ye mi yazıldı? [1]
- Uzun referanslar SKILL.md gövdesinden ayrı dosyalara alındı mı? [2]
- Ekip becerisi deponun .claude/skills klasöründe ve sürüm kontrolünde mi? [1]
- Hazır ya da üçüncü taraf beceriyi kritik bir işte kullanmadan önce kendi ortamında test ettin mi? [3]
Sıkça Sorulan Sorular
Claude skill nasıl eklenir?
Claude Code'da içinde SKILL.md bulunan bir klasörü ~/.claude/skills ya da projendeki .claude/skills altına koyman yeterli [1]. claude.ai'de özel becerileri ayarlardan ekleyebilirsin, API'de ise yükleme yaparsın [2]. Hazır örnekler için Claude Code'da /plugin marketplace add anthropics/skills komutunu çalıştırıp document-skills ya da example-skills paketini kurabilirsin [3].
Claude ile becerileri kullanarak neler yapabilirim?
Word, Excel, PowerPoint ve PDF belgeleri oluşturup düzenleyebilir [2], ekip kod standartlarını, commit biçimini ve marka kurallarını otomatik uygulatabilir [1], veri analizini kendi iş akışına göre yaptırabilir ya da kişisel işleri otomatikleştirebilirsin [3]. Örnek depoda sanat, müzik, tasarım ve web uygulaması testi gibi alanlarda da beceriler var [3].
Beceriyi her seferinde çağırmam gerekir mi?
Hayır. Slash komutlarının aksine beceriler, Claude isteğini açıklamayla eşleştirdiğinde kendiliğinden devreye girer [1]. İstersen adıyla da anabilirsin, örneğin "PDF becerisini kullanarak şu dosyadaki form alanlarını çıkar" diyebilirsin [3].
Çok sayıda beceri kurmak Claude'u yavaşlatır mı?
Resmi belgelere göre tetiklenene kadar yalnız ad ve açıklama bağlamda durur ve bu beceri başına yaklaşık 100 token tutar. Bu yüzden çok sayıda beceri kurulabilir [2]. Ancak SKILL.md gövdesini şişirmek, beceri çalıştığında bağlamı gereksiz yere doldurur. Uzun içerikleri referans dosyalarına ayırman önerilir [2][5].
Skills ücretsiz planda var mı?
Anthropic'in örnek deposuna göre bu örnek beceriler claude.ai'de ücretli planlarda zaten kullanılabilir durumda [3]. Plan koşulları değişebileceği için güncel durumu Claude'un kendi sayfasından kontrol et.
5 maddede özet
- Tanım: Skill, Claude'a bir işi bir kez öğreten ve içinde SKILL.md bulunan talimat klasörüdür [1][3].
- Çalışma biçimi: Başta yalnız ad ve açıklama yüklenir, gövde ve ek dosyalar yalnız gerektiğinde okunur [2].
- Konum: Kişisel beceriler ~/.claude/skills, ekip becerileri deponun .claude/skills klasöründe durur [1].
- Fark: CLAUDE.md her zaman yüklenir, slash komutu elle çağrılır, MCP dış sistemlere erişim sağlar; beceri ise yöntemi taşır [1][7].
- Başlangıç: Claude'a en sık tekrarladığın talimatı seç ve net bir description ile ilk SKILL.md dosyanı yaz [1][3].
Kaynaklar
- What are skills? · Introduction to agent skills · Claude Academy · academy.claude.com
- Agent Skills - Claude Platform Docs · platform.claude.com
- GitHub - anthropics/skills: Public repository for Agent Skills · GitHub · github.com
- What Are Claude Code Skills and How Do They Work? | MindStudio · mindstudio.ai
- Habilidades do Claude: O que são e como gerenciá-las · truefoundry.com
- Claude Skills vs MCP vs Agents: Key Differences - Verdent Guides · verdent.ai
Bu rehber yukarıdaki kaynakların 1 Kasım 2026 tarihli derlemesidir; fiyat ve sürüm gibi bilgiler değişebilir, güncelini kaynağından kontrol et.