Claude Skills Nedir ve Nasıl Kullanılır? 2026 Kapsamlı Rehber

Anthropic 16 Ekim 2025'te Agent Skills özelliğini duyurduğunda, Claude kullanıcılarının çoğu "bu da başka bir prompt tekniği mi?" diye düşündü. Ancak iki ay içinde Microsoft, Cursor, Goose ve daha birçok araç SKILL.md formatını benimsedi ve Aralık 2025'te Agent Skills açık bir standart haline geldi. Bugün Fortune 100 şirketlerinin yüzde 70'i Claude kullanıyor ve Deloitte 470.000 çalışanı için Claude deployment'ı yaptı. Bu deployment'ların arkasında da skill yapıları bulunuyor.

Peki Claude Skills nedir, nasıl çalışır ve en önemlisi neden çoğu skill güvenilir şekilde tetiklenmiyor? Bu rehberde hem teoriyi hem de pratiği ele alıyoruz. Konuyu detaylı şekilde anlattığımız YouTube video rehberimizi de izleyebilirsiniz. Videoda manuel yazma, skill-creator plugin ve hazır skill indirme yöntemlerini baştan sona birlikte uyguluyoruz.

İçindekiler

• Claude Skills Nedir? Doktor Analojisi İle Anlamak
• Claude Skills Ne İçin Kullanılır? 5 Temel Alan
• Progressive Disclosure: 3 Katmanlı Sistem Nasıl Çalışır?
• Description Craft: Front Matter'ın Sırrı
• SKILL.md Gövdesi, Scripts ve References Katmanları
• Skill Oluşturmanın 3 Yolu: Hangisi Size Uygun?
• Pratik Örnek: GitHub Trending Research Skill
• Yaygın Hatalar ve Çözümleri
• n8n Otomasyon ile Claude Skills Kombinasyonu
• Sonuç
• Sıkça Sorulan Sorular (FAQ)

Claude Skills Nedir? Doktor Analojisi İle Anlamak

Claude Skill, en basit tanımıyla bir klasör ve içindeki SKILL.md adında bir Markdown dosyasıdır. Geriye kalan her şey (scriptler, referans dosyaları, örnekler) opsiyoneldir. Ancak bu basit dosya, Claude'a belirli bir görevi tekrarlanabilir şekilde nasıl yapacağını öğreten güçlü bir yapı sunar.

Bu yapıyı en iyi anlatacak analoji ise yeni mezun doktor hikayesidir. Yeni mezun bir doktor çok zeki ve bilgili olabilir. Anatomi, ilaçlar ve genel tıp bilgisi hepsi vardır. Ancak bir hastaneye ilk atandığında oranın iç prosedürlerini bilmez: hangi yazılım sistemini kullanıldığını, reçete protokolünü, sevk sıralamasını. Bu durumda kıdemli bir doktor ona hastanenin iç kurallarını anlatır ve böylece yeni doktor aynı standartta çalışmaya başlar.

Claude da aynı şekilde çalışır. Çok yetenekli, çok bilgili bir asistan olmasına rağmen sizin ekibinizin iş yapma şeklini, marka standartlarınızı ve şirket içi prosedürlerinizi bilmiyor. Skill, işte o kıdemli doktorun verdiği yönergelerin dijital karşılığıdır.

Agent Skills özelliği 16 Ekim 2025'te Anthropic tarafından duyuruldu ve kısa sürede ekosistem haline geldi. Aralık 2025'te Anthropic bunu açık standart olarak ilan etti; Microsoft (VS Code ve GitHub), Cursor, Goose, OpenCode gibi araçlar da bu formatı benimsedi. Yani bugün yazdığınız bir skill, sadece Claude Code'da değil, diğer coding agent araçlarında da kullanılabiliyor.

Claude Code ile n8n otomasyon arasındaki farkı merak ediyorsanız, konuyu detaylıca işlediğimiz n8n vs Claude Code karşılaştırma rehberimize göz atabilirsiniz.

Claude Skills Ne İçin Kullanılır? 5 Temel Alan

Skill'lerin kullanım alanı çok geniştir ama özellikle 5 senaryoda size büyük değer katar. Her birinde temel fikir aynıdır: tekrar eden bir iş parçasını bir kez doğru tanımlayın, sonra Claude her seferinde aynı kalitede üretsin.

1. Tekrar eden iş akışları: Haftalık rapor formatınız, pull request şablonunuz veya code review checklist'iniz varsa bunları skill'e dönüştürebilirsiniz. Böylece hangi takım arkadaşınız Claude'a sorarsa sorsun, aynı formatta çıktı alır.

2. Takım ve marka standartları: Logo kullanım kuralları, font tercihleri, tone of voice, commit mesaj formatı gibi ekip kurallarınızı SKILL.md içine yazdığınızda dijital ajanslarda ve içerik ekiplerinde büyük bir tutarlılık elde edersiniz.

3. Dış veri çekme: GitHub trending, Reddit popüler başlıklar, hava durumu API'si veya şirket içi API'nizden veri çekme işlemleri bu kategoriye girer. Bunların tamamı scriptler aracılığıyla skill içinden yapılabilir. Claude'un kendi fetch'i bazen tutarsız sonuç verebiliyor, scriptle çok daha stabil çalışır.

4. Adım adım prosedürler: Deploy süreci, müşteri onboarding, release akışı ve test prosedürleri gibi kritik operasyonel adımlar skill'e dönüştürüldüğünde, yeni ekip üyelerinin öğrenme eğrisi önemli ölçüde kısalır.

5. Alan bilgisi (domain knowledge): Hukuk clause'ları, medikal terimler, ürün kataloğu bilgileri gibi uzmanlık gerektiren bilgi setleri de skill'e dönüştürülebilir. Bu sayede Claude, genel bilgisinin üzerine sizin alanınıza özgü uzmanlığı ekler.

Türkiye'de e-ticaret markaları ürün açıklaması üretimi ve SEO başlık formatlaması için bu yapıyı kullanmaya başladı. n8n otomasyon ajansları ise workflow dokümantasyonu ve deploy kuralları için skill'leri yoğun şekilde kullanıyor. Benzer kazanç fırsatları için n8n otomasyon satarak ayda 20.000-60.000₺ kazanma rehberimize de bakabilirsiniz.

Progressive Disclosure: 3 Katmanlı Sistem Nasıl Çalışır?

Skill'lerin gücünün ardındaki temel mimari progressive disclosure (aşamalı açılım) adı verilen 3 katmanlı sistemdir. Bu mimari, Claude'un yüzlerce skill'iniz olsa bile context window'unuzu şişirmemesini sağlar.

1. Katman: Front Matter (her zaman yüklü). SKILL.md dosyasının en üstündeki üç tire arasındaki YAML bloğudur. Yalnızca name ve description alanlarını içerir. Claude, yüklü olan tüm skill'lerin sadece bu kısmına bakarak hangi skill'i yükleyeceğine karar verir. 100 tane skill'iniz olsa bile sistem prompt'ta yalnızca yaklaşık 100 token yer kaplarlar, yani sadece name ve description bilgisi.

2. Katman: SKILL.md Gövdesi (ilgili olduğunda yüklenir). Claude front matter'dan "bu skill bu göreve uyar" kararı verdiğinde, dosyanın tüm gövdesini context window'a yükler. Bu yüzden gövde 500 satırı veya yaklaşık 2000 kelimeyi aşmamalıdır. Anthropic'in resmi skill authoring best practices dokümanı bunu açıkça belirtiyor: fazlası Claude'un talimat takibini düşürür.

3. Katman: Scripts ve References (yalnızca gerektiğinde). Bu katmandaki dosyalar asla otomatik yüklenmez. Script için Claude dosyayı çalıştırır ve yalnızca çıktısı context'e eklenir. 1000 satırlık bir Python scripti olsa bile içeriği Claude'un context'ine girmez. References klasöründeki Markdown dosyaları ise Claude ihtiyaç duyduğunda, örneğin "şu kurallara bak" denildiğinde okunur.

Bu mimarinin sonucu şudur: 100 sayfalık bir skill koleksiyonunuz bile token bütçenizi yakmaz. Context window'da sadece o anda ihtiyaç duyulan bilgi yer alır. Bu yaklaşım, Claude'un 2026'da enterprise'da yaklaşık yüzde 29 pazar payına ulaşmasının teknik sebeplerinden biri olarak görülüyor.

Description Craft: Front Matter'ın Sırrı

Skill'ler ekosisteminin en büyük sorunu şudur: skill'lerin büyük çoğunluğu güvenilir şekilde tetiklenmiyor. Anthropic'in resmi PDF skill'i bile bu şikayeti alıyor. Sebep neredeyse her zaman aynı: kötü yazılmış description alanı.

Front matter'ın description alanı, Claude'un bir skill'i yüklemeye karar verirken gördüğü tek bilgidir. Gövde ne kadar iyi yazılmış olursa olsun, eğer description zayıfsa Claude o skill'in varlığından bile haberdar olmaz.

Kötü ve iyi description'ın farkı çok net:

Kötü örnek:

"Araştırma için yardımcı bir araç olur."

Bu belirsiz ifadeyle Claude asla hangi durumda skill'i çağıracağını bilemez. "Araştırma" çok genel bir kelimedir.

İyi örnek:

"GitHub'da trend olan repoları araştırır. Kullanıcı 'GitHub'da neler trend?', 'Trend olan repoları göster', 'Bu hafta hangi projeler popüler?' gibi sorular sorduğunda tetiklenir. GitHub Search API üzerinden son 7 günün en çok yıldız alan repolarını çeker ve tema bazlı bir rapor üretir."

Fark açıktır: iyi description ne yaptığını ve ne zaman tetikleneceğini kullanıcının söyleyeceği birebir cümlelerle tanımlar.

Bir diğer kritik detay: Anthropic, description listelemesinde ilk 250 karakter sonrası kesiyor. Yani kritik trigger kelimelerinizi ilk 250 karaktere yerleştirmezseniz, Claude onları hiç görmeyecektir. Bu yüzden description'ınızı piramit gibi yazın ve en önemli sinyaller en üstte olsun.

Name alanı içinse kurallar şunlardır: maksimum 64 karakter, sadece küçük harf, rakam ve tire kullanılabilir, XML tag'i ve rezerve edilmiş kelimeler yasaktır. Description ise maksimum 1024 karakter olabilir.

SKILL.md Gövdesi, Scripts ve References Katmanları

Front matter onayı geçildikten sonra Claude, SKILL.md gövdesini okur. Bu gövdede üç ana başlık önerilir: workflow adımları, referans atıfları ve kurallar (anti-hallucination notları).

Workflow bölümünde adım adım talimatlar yer alır: "1. Kullanıcı girdisini parse et. 2. Tarih hesapla. 3. Scripti çalıştır. 4. Sonuçları analiz et..." gibi. Bu kısım, stajyer öğrenciye SOP yazar gibi, buyurgan dilde ve üçüncü şahıs ağzıyla yazılmalıdır.

Referanslar bölümünde ise gövdeye sığmayan detaylar için dosya atıfları yapılır: "Analiz kuralları için references/analiz-kurallari.md dosyasını oku", "Çıktıyı formatlarken references/cikti-sablonu.md şablonunu kullan" gibi. Böylece gövde şişmez, detaylar parçalara bölünür.

Kurallar bölümü ise anti-hallucination notlarını ve istisnai durumları içerir. Örneğin "API hiçbir şey döndürmediyse kullanıcıya söyle, veri uydurma" veya "3'ten az sonuç gelirse düşük sinyal uyarısı ver" gibi kurallar burada tanımlanır.

Scripts ve references klasörleri skill yapısının ölçeklenebilirliğini sağlayan katmanlardır. Scripts çalıştırılabilir dosyalardır (Python, Bash, Node.js vb.) ve Claude bunları çıktılarıyla tüketir. References ise statik Markdown dosyalarıdır ve Claude bunları sadece ihtiyaç anında okur.

Bu mimari sayesinde bir skill, yüzlerce sayfa dokümantasyon içerse bile Claude sadece o anda ilgili olan bilgiyi yükler. Bu yaklaşım, büyük kural setlerini ve şablonları taşıyan skill'lerde özellikle değerlidir.

Skill Oluşturmanın 3 Yolu: Hangisi Size Uygun?

Claude Skill oluşturmanın üç ana yöntemi vardır ve her biri farklı bir senaryo için idealdir. Aşağıdaki karşılaştırma tablosu hangisini seçmeniz gerektiğini netleştirir:

Yöntem	Kontrol	Hız	Öğrenme	En İyi Senaryo
Manuel yazma	Tam	Yavaş	Yüksek	Takıma özel workflow, öğrenme
skill-creator plugin	Orta	Hızlı	Orta	Hızlı prototip, ilk denemeler
Hazır indirme (skills.sh)	Düşük	Çok hızlı	Düşük	Frontend design, PDF gibi genel işler

1. Manuel yazma tam kontrol sağlar. .claude/skills/ klasörü altında yeni bir klasör açar, içine SKILL.md dosyasını koyar ve her şeyi elden yazarsınız. Öğrenme için en iyisidir çünkü yapıyı tam anlamadan düzgün skill üretmek mümkün değildir. Bir problem çıktığında nedenini anlayabilmeniz için bu temeli bilmelisiniz.

2. Skill-creator plugin Anthropic'in resmi aracıdır. Claude Code içinde /plugin komutu ile yüklenir ve size "skill analyzer oluştur" gibi doğal bir cümle söylediğinizde otomatik olarak klasör yapısını kurar, SKILL.md iskeletini oluşturur ve test önerileri sunar. Bu bir skill'dir ve diğer skill'leri üretir. Yani Anthropic kendi yapısını kullanarak bir meta-skill sunmuş durumdadır.

3. Hazır indirme (skills.sh) en hızlı yoldur. skills.sh üzerinde frontend-design, pdf, excalidraw-diagram-generator gibi toplulukça paylaşılan skill'ler bulunuyor. Örneğin frontend-design skill'i 200.000'den fazla indirme aldı ve AI'ın tipik ürettiği tasarımdan çok daha kaliteli sonuçlar üretiyor. Tek bir komut ile projenize eklenir ve Claude Code otomatik olarak tetikler.

Bizim önerimiz şudur: önce manuel yöntemle bir skill yazın, yapıyı zihninize yerleştirin, sonra kısa yollar için skill-creator'ı veya hazır skill'leri kullanın.

Pratik Örnek: GitHub Trending Research Skill

Teoriyi pratikte görmek için GitHub Trending Research Skill örneğini inceleyelim. Bu skill, kullanıcının "Bu hafta Claude konusunda GitHub'da neler trend?" gibi bir cümle söylediğinde otomatik tetiklenir, GitHub Search API üzerinden son 7 günün en çok yıldız alan repolarını çeker ve tema bazlı bir rapor üretir.

Dosya yapısı şu şekildedir:

.claude/skills/github-trending/
├── SKILL.md
├── scripts/
│   └── fetch-trending.sh
└── references/
    ├── analiz-kurallari.md
    ├── cikti-sablonu.md
    └── ornek-sorgular.md

SKILL.md dosyasında front matter doğru yazılmış description içerir, gövde 6 adımlık bir workflow tanımlar ve referanslara atıf yapar. fetch-trending.sh scripti GitHub API'yi çağırır ve yıldız sayısına göre sıralı repo listesi döndürür. Script'in içeriği context'e yüklenmez, sadece çıktısı kullanılır.

References klasöründe üç dosya vardır. analiz-kurallari.md hangi repoların filtreleneceğini (örneğin 50'den az yıldızlıları at) ve tema tespitinin nasıl yapılacağını tanımlar. cikti-sablonu.md raporun nihai formatını belirler ve böylece her çıktı aynı yapıda gelir. ornek-sorgular.md ise kullanıcıya gösterilebilecek alternatif sorgu önerileri içerir.

Bu skill'i nasıl manuel oluşturduğumuzu, skill-creator ile nasıl hızlandırdığımızı ve skills.sh'den hazır skill'lerin nasıl indirildiğini baştan sona uygulamalı olarak anlattığımız YouTube video rehberimizi mutlaka izleyin. Video, yazı tarafından kolayca aktaramadığımız IDE içi adımları, klasör oluşturma sırasını ve gerçek çalışma anlarını gösteriyor.

Yaygın Hatalar ve Çözümleri

Claude Skills ekosisteminde sürekli karşılaşılan üç tipik hata var ve hepsinin net çözümü mevcut:

1. Belirsiz (vague) description: "X için yardımcı olur" gibi genel ifadeler kullanmak. Çözüm: kullanıcının söyleyebileceği gerçek cümleleri tırnak içinde description'a eklemek. Hangi trigger kelimelerini kullanıcı yazarsa skill yüklensin, bunları net belirtin.

2. Şişkin SKILL.md gövdesi: 2000 kelimeyi veya 500 satırı aşan gövdeler Claude'un talimat takibini ciddi oranda düşürür. Çözüm: detayları references/ klasöründeki dosyalara taşıyın ve gövdede onlara atıf yapın. Böylece gövde yalın ve odaklı kalır, detaylar ise ihtiyaç anında yüklenir.

3. Trigger sinyali eksikliği: Description yalnızca ne yaptığını söylüyor ama ne zaman kullanılacağını söylemiyor. Çözüm: her description'da "ne yapar" ve "ne zaman tetiklenir" bilgisini zorunlu olarak bulundurun. Özellikle kullanıcının yazabileceği örnek cümleler olmazsa olmazdır.

Topluluk içinde yapılan çok sayıda skill hatası analizinde bu üç sorunun, başarısızlıkların yaklaşık yüzde 85'ini oluşturduğu görülüyor. Yani bu üç noktayı çözdüğünüzde skill'leriniz büyük ölçüde sorunsuz tetiklenir.

Ayrıca önemli bir not: description'ın ilk 250 karakteri kritiktir. Anthropic listelemede bu noktadan sonrasını kesiyor. Trigger sinyallerinizi ilk 250 karaktere yerleştirmezseniz, gövdede ne yazdığının önemi kalmaz.

n8n Otomasyon ile Claude Skills Kombinasyonu

Claude Skills ve n8n otomasyon platformu farklı katmanlarda çalışıyor gibi görünse de, birlikte kullanıldıklarında ciddi bir verimlilik artışı sağlarlar. İki yaklaşım birbirinin yerine geçmez, birbirini tamamlar.

Tipik bir kombinasyon şöyle çalışır: n8n workflow'larınızı Claude Code ile geliştirirken, workflow dokümantasyon standartlarınızı bir SKILL.md'ye dönüştürürsünüz. Bu skill, "yeni webhook node'u ekle", "error handling blokunu ekle", "credentials'ı güvenli sakla" gibi tekrarlanan işleri standardize eder.

Örneğin bir n8n otomasyon ajansı şu skill'leri oluşturabilir:

• n8n-webhook-builder: Standart webhook node yapısı ve error handling şablonu
• n8n-deploy-checklist: Production'a gönderilmeden önce kontrol edilmesi gereken 10 madde
• n8n-client-handoff: Müşteriye workflow teslim ederken kullanılacak dokümantasyon şablonu

Böylece yeni ekip üyeleri onboarding sürecini kısaltır, tüm ekip aynı standartlarda iş çıkarır ve müşteri memnuniyeti artar. Bu yaklaşım, n8n otomasyon işinizi profesyonel seviyeye taşımanın somut yollarından biridir. Eğer n8n ile yapay zeka entegrasyonu konusunda derinleşmek istiyorsanız, n8n ile Yapay Zeka Otomasyonu 2026 Rehberimiz iyi bir başlangıç noktasıdır.

Sonuç

Claude Skills, 2026'nın en etkili AI produktivite mimarilerinden biri haline geldi. Ekim 2025'te özel bir özellik olarak duyurulan Agent Skills, iki ay içinde açık standart oldu ve Microsoft'tan Cursor'a kadar tüm ekosistem bu formatı benimsedi.

Üç temel çıkarım var:

1. Description craft en kritik beceridir. Gövde ne kadar iyi yazılırsa yazılsın, description zayıfsa skill görünmezdir. Kullanıcının söyleyeceği gerçek cümleleri ilk 250 karaktere yerleştirin.
2. Progressive disclosure context'inizi korur. 3 katmanlı yapıyla yüzlerce skill'iniz olsa bile token bütçeniz şişmez. Detayları scripts/ ve references/ klasörlerine taşıyın.
3. Manuel yaklaşımla öğrenin, sonra hızlanın. Önce yapıyı tam anlamak için bir skill'i elden yazın. Sonra skill-creator ve hazır skill indirmeyi kısa yol olarak kullanın.

Claude Skills mantığını ve pratik uygulamasını baştan sona anlattığımız YouTube video rehberimizi izlemeyi unutmayın. Videoda manuel yazma, skill-creator ve skills.sh'den indirme olmak üzere üç yöntemi de uygulamalı gösteriyoruz. n8n otomasyon ve AI araçları konusunda kapsamlı Türkçe eğitim almak isterseniz n8nkursu.com platformu sizin için ideal bir başlangıç noktasıdır. Skills ekosistemi büyüyor ve bu trende erken katılan ekipler ciddi bir verimlilik avantajı elde ediyor.

Sıkça Sorulan Sorular (FAQ)

Claude Skills nedir ve neden kullanmalıyım?

Claude Skills, Claude'a belirli görevleri tekrarlanabilir ve tutarlı şekilde nasıl yapacağını öğreten talimat setleridir. Bir klasör ve içinde SKILL.md dosyasından oluşur. Ekip standartlarını bir kez tanımlar, her seferinde aynı kalitede sonuç alırsınız.

Skill'im neden tetiklenmiyor?

Yüzde 90 oranında sebep zayıf description alanıdır. Description'a kullanıcının yazacağı gerçek cümleleri tırnak içinde eklemelisiniz. Ayrıca ilk 250 karakterde kritik trigger kelimelerinin geçtiğinden emin olun çünkü Anthropic sonrasını kesiyor.

Claude Skills ile MCP arasındaki fark nedir?

MCP (Model Context Protocol) Claude'u dış veri kaynaklarına (Google Drive, GitHub, veritabanı) bağlar, yani erişim sağlar. Skills ise bu verilerle ne yapılacağını anlatan prosedür setidir. MCP çekiç verir, Skills çiviyi nasıl çakacağını anlatır. İkisi birbirini tamamlar.

Kendi skill'imi oluşturmanın en iyi yolu hangisi?

Üç yol vardır: manuel yazma, skill-creator plugin ve skills.sh üzerinden hazır indirme. Öğrenme için manuel yaklaşım en sağlıklıdır çünkü yapıyı tam olarak anlarsınız. Yapıyı öğrendikten sonra hızlandırmak için skill-creator'ı veya hazır skill'leri kullanabilirsiniz.

SKILL.md ve CLAUDE.md arasındaki fark nedir?

CLAUDE.md her oturumda otomatik yüklenen proje kurallarıdır ve sürekli token yer. SKILL.md ise sadece ilgili göreve uygun olduğunda progressive disclosure ile yüklenir. Bu yüzden SKILL.md token bütçenizi korurken CLAUDE.md global davranışları tanımlar.