Kaynak: https://oguzerol.com/claude-skills-nedir/ [ Görseli büyüt](https://oguzerol.com/gorseller/senaryo/claude-skills-nedir-senaryo-tr.webp) # Claude Skills Nedir, Ne İşe Yarar? [Oğuz Erol](https://oguzerol.com/hakkimda/) | 9 dk okuma | Yayın: 3 Ağustos 2026 | Güncelleme: 13 Ekim 2026 ## Kısa özet Claude Skills nedir, Claude instruction'dan farkı ne, claude.ai ve Claude Code'a nasıl eklenir? Ekim 2026 resmi belgelerine göre adım adım anlatıyorum. Claude Skills, Anthropic’in yapay zeka modeli [Claude’a](https://oguzerol.com/claude-ai-nedir/) belirli bir işi baştan sona nasıl yapacağını öğreten, yeniden kullanılabilir talimat paketleridir. Her skill; adım adım yöntemi anlatan bir SKILL.md dosyasından, gerekirse yardımcı script ve şablonlardan oluşur. Claude bir görevle karşılaştığında elindeki skill listesine bakar, işe uygun olanı kendisi seçip uygular — siz aynı talimatı her defasında yeniden yazmazsınız. Bu yazıda ne olduğunu, “Claude instruction” denen talimat türlerinden farkını, nasıl eklendiğini ve hangi işler için işe yaradığını anlatıyorum. ## Claude Instruction Nedir: Talimat Türleri ve Skill’den Farkı “Claude instruction” tek bir özelliğin adı değil; Claude’a kalıcı talimat vermenin birkaç yoluna verilen genel ad. Hangisinin ne işe yaradığı şöyle: | Yöntem | Nerede geçerli | Ne zaman bağlama girer | En uygun kullanım | | --- | --- | --- | --- | | Prompt | O sohbet | Yazdığınız an | Tek seferlik istek | | Instructions for Claude (hesap talimatı) | Tüm sohbetleriniz | Her sohbette | Dil, hitap, ton gibi genel tercihler | | Proje talimatı | Yalnız o projedeki sohbetler | Projede her sohbette | Bir projeye özel bağlam ve kurallar | | CLAUDE.md | Claude Code’da bir klasör ya da kullanıcı | Her oturumda | Kod tabanı kuralları, komutlar, çalışma düzeni | | Skill | Eklendiği yerde | Yalnız iş eşleşince | Tarif edilebilir, tekrar eden bir iş | Ekim 2026 itibarıyla Claude Yardım Merkezi’ne göre hesap talimatları Settings içindeki “Instructions for Claude” bölümünden eklenir ve tüm konuşmalara uygulanır; proje talimatları ise yalnız o projedeki sohbetleri etkiler ([Kaynak: Claude Yardım Merkezi](https://support.claude.com/en/articles/10185728-understanding-claude-s-personalization-features)). Claude Code tarafında aynı rolü CLAUDE.md dosyaları oynar; Anthropic bu dosyayı kesin kural motoru değil, bağlam olarak tanımlıyor ([Kaynak: Claude Code belgeleri](https://code.claude.com/docs/en/memory)). Bir eylemin kesinlikle engellenmesini istiyorsanız belgeler hook kullanmayı öneriyor. ### Hangisi Ne Zaman? Pratik ayrım şu: **her işte geçerli olması gereken kural** talimata ya da CLAUDE.md’ye, **belirli bir işte devreye girecek yöntem** skill’e yazılır. Anthropic’in Claude Code belgesi de aynı mantığı veriyor: CLAUDE.md içeriği her zaman yüklenir, skill’in gövdesi yalnız kullanıldığında yüklenir; talimatlar bir prosedüre dönüştüyse skill kullanın. - “Türkçe cevap ver, bana Oğuz diye hitap et” → hesap talimatı. - “Bu klasörde testleri şu komutla çalıştır” → CLAUDE.md. - “Bir siteyi şu 5 kritere göre denetle ve şu formatta raporla” → skill. Üçünün sohbet, ajan ve skill boyutundaki karşılaştırmasını [Prompt vs Skill vs Agent](https://oguzerol.com/prompt-vs-skill-vs-agent/) yazısında ayrıca anlattım. ## Nasıl Çalışır: SKILL.md ve Otomatik Seçim Bir skill’in çekirdeği **SKILL.md** adında tek bir dosyadır. İçinde genelde üç şey bulunur: - Skill’in ne işe yaradığını ve ne zaman tetikleneceğini anlatan kısa bir açıklama (dosyanın başındaki `name` ve `description` alanları), - İşin adım adım nasıl yapılacağını anlatan talimat metni, - Gerekiyorsa yardımcı dosyalar — bir Python script’i, bir şablon, referans bir tablo ya da örnek çıktı. Claude görev listesine bakıp uygun skill’i kendisi seçer; siz “şu skill’i çalıştır” demek zorunda değilsiniz. Bir skill’i sıfırdan nasıl yazacağınızı [SKILL.md Nasıl Yazılır](https://oguzerol.com/skill-md-nasil-yazilir/) yazısında anlattım. ### Neden Çok Skill Kurmak Bağlamı Şişirmez? Skill’ler kademeli yüklenir. Anthropic’in belgesine göre (Ekim 2026 itibarıyla) Claude başlangıçta yalnız her skill’in adını ve açıklamasını yükler; skill başına yaklaşık 100 token. SKILL.md’nin gövdesi, isteğiniz açıklamayla eşleşince okunur ve belgede 5 bin token altı olarak belirtiliyor. Yardımcı dosyalar ve script’ler ise iş gerektirdiğinde açılır ([Kaynak: Agent Skills belgesi](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)). Sonuç: eşleşmeyen skill’ler neredeyse hiç yer kaplamaz. Aynı belge `name` alanı için en çok 64 karakter (küçük harf, rakam, tire), `description` için en çok 1024 karakter sınırı koyuyor ve açıklamanın hem ne yaptığını hem ne zaman kullanılacağını söylemesini istiyor. Skill’in tetiklenip tetiklenmemesini en çok bu açıklama belirler. ## Claude Skill Nasıl Eklenir? Ekleme yolu kullandığınız yere göre değişiyor ve **özel skill’ler yüzeyler arasında senkronize olmuyor**: claude.ai’a yüklediğiniz skill API’de ya da Claude Code’da otomatik görünmez (Anthropic belgesi, Ekim 2026). Arayüz adları zamanla değişebilir; aşağıdaki adımlar Ekim 2026’da okuduğum Yardım Merkezi ve belge sayfalarına göre. ### claude.ai’da 1. Skill klasörünü hazırlayın (içinde SKILL.md olmalı) ve ZIP olarak paketleyin. 2. Settings > Capabilities altında “Code execution and file creation” seçeneğinin açık olduğundan emin olun; skill’ler kod yürütmeyi gerektiriyor. Team ve Enterprise’ta bunu kuruluş sahibi açar. 3. Customize > Skills sayfasında ”+” simgesine, ardından ”+ Create skill” seçeneğine basın. 4. “Upload a skill” ile ZIP dosyasını yükleyin. 5. Listede çıkan skill’i açıp kapatabilirsiniz. Yüklemenin takıldığı tipik durumlar: ZIP’in çok büyük olması, klasör adının skill adıyla uyuşmaması, SKILL.md dosyasının eksik olması, ad ya da açıklamada geçersiz karakter ([Kaynak: Claude Yardım Merkezi](https://support.claude.com/en/articles/12512180-using-skills-in-claude)). claude.ai’daki özel skill’ler kişiye özeldir; ekipteki herkes ayrı ayrı yükler. Excel, Word, PowerPoint ve PDF için Anthropic’in hazır skill’leri ise ayrıca kurmadan çalışır. ### Claude Code’da Claude Code’da yükleme yok; skill bir klasördür. SKILL.md dosyasını şu konumlardan birine koyarsınız ([Kaynak: Claude Code skills belgesi](https://code.claude.com/docs/en/skills)): - Kişisel (her projede): `~/.claude/skills/<skill-adı>/SKILL.md` - Proje (o depoda): `.claude/skills/<skill-adı>/SKILL.md` Skill’i ister Claude’un isteğinizle eşleştirmesine bırakır, ister `/skill-adı` yazarak doğrudan çağırırsınız. Belgeye göre Claude Code bu klasörleri izlediği için mevcut bir skill’de yaptığınız düzenleme yeniden başlatma gerektirmiyor. ### Claude API’sinde API’de özel skill’ler Skills API (`/v1/skills`) üzerinden yüklenir ve kod yürütme aracıyla birlikte kullanılır; yüklenen skill çalışma alanındaki herkese açıktır ([Kaynak: Agent Skills belgesi](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)). Geliştirici değilseniz bu yola ihtiyacınız olmaz. ## Skill mi, MCP mi, Alt Ajan mı? Üçü birbirinin yerine geçmiyor, farklı soruyu cevaplıyor: | Katman | Cevapladığı soru | Örnek | | --- | --- | --- | | Skill | Claude bu işi nasıl yapmalı? | Denetim kontrol listesi, rapor formatı | | MCP | Claude neye ulaşabilir? | Veritabanı, takvim, reklam hesabı bağlantısı | | Alt ajan | Bu işi kim, ayrı bağlamda yapsın? | Uzun bir taramayı ana sohbeti şişirmeden yürütmek | Claude işi yanlış yapıyorsa skill, bir sisteme erişemiyorsa MCP, bağlam kalabalıklaşıyorsa alt ajan düşünün. Bu ayrım benim yorumum; kavramların tanımı yukarıdaki resmi belgelerden. ## Hangi İşler İçin Skill Yazılır Tekrar eden, adımları belli olan her iş skill’e dönüşebilir. En sık karşılaştığım örnekler: - **SEO/GEO denetimi** — bir sitenin title, açıklama, şema ve iç link durumunu hep aynı kontrol listesine göre taramak. - **Haftalık rapor üretimi** — reklam hesabı ya da GA4 verisini her hafta aynı formatta özetlemek. - **Kod inceleme** — bir pull request’i güvenlik, performans ve stil açısından sabit bir kontrol listesiyle gözden geçirmek. - **Marka ses tonu kontrolü** — yayınlanacak bir metnin ton, yasaklı kelime ve format kurallarına uyup uymadığını denetlemek. - **Müşteri onboarding brief’i** — yeni bir müşteri geldiğinde hep aynı soruları sorup aynı formatta özet çıkarmak. Ortak nokta şu: iş tarif edilebilir ve tekrar ediyor. Skill yazmanın anlamsız olduğu üç durum da var: tek seferlik ve sürekli değişen işler (düz prompt yeter), her işte geçerli genel kurallar (talimat ya da CLAUDE.md’ye yazın), yalnız sizin ihtiyacınız olan küçük kişisel tercihler (hesap talimatı yeter). ## Kendi Operasyonumdan Bir Gözlem Kendi işimde de aynı mantığı kullanıyorum. Bu sitedeki her sayfanın title, açıklama, görsel, şema ve İngilizce karşılığını hep aynı beş kritere göre kontrol ediyorum; bunu bir skill’e yazdırdıktan sonra denetim, elle yaptığım versiyona göre hem daha hızlı hem daha tutarlı hale geldi. Aynı mantıkla, sektördeki gelişmeleri haftalık tarayıp içerik fikrine çeviren bir iş de artık tekrar eden bir skill üzerinden yürüyor. Fark şu: skill yazmadan önce bu işleri her seferinde yeniden anlatıyordum, şimdi anlatmıyorum. ## Skill Marketplace’leri: Kurmadan Önce Kontrol Edin Skill paylaşan siteler (marketplace’ler) hızla çoğalıyor ama bu alan çok yeni — bir güvenlik veya kalite standardı henüz oturmadı. Bilmeniz gereken risk şu: bir skill sadece talimat metni değil, çoğu zaman **çalıştırılabilir script** da içeriyor. Anthropic de aynı uyarıyı yapıyor: skill’leri yalnız kendi yazdığınız ya da güvendiğiniz kaynaklardan kullanın; kötü niyetli bir skill Claude’u, belirtilen amaca uymayan araç çağrılarına ya da veri sızdırmaya yönlendirebilir ([Kaynak: Agent Skills belgesi](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview), Ekim 2026). Kurmadan önce şunlara bakın: - SKILL.md’yi ve klasördeki bütün script’leri okuyun. - Beklenmedik ağ isteği, dosya erişimi ya da skill’in amacıyla ilgisiz işlemler arayın. - Dış bir adresten içerik çeken skill’lere ekstra dikkat edin; o içerik sonradan değişebilir. Kaynağı belirsiz bir skill’i okumadan çalıştırmak, tanımadığınız birinin yazdığı bir programı bilgisayarınızda çalıştırmakla aynı şey. ## Bu Konu Nereye Bağlanıyor Claude Skills, kendi başına duran bir özellik değil — ajanların araç kullanma, karar verme ve tekrar eden işleri devralma yeteneğinin bir parçası. Bütün resmi görmek isterseniz [Agentic AI Rehberi](https://oguzerol.com/agentic-ai-rehberi/)’nden başlayabilirsiniz. ## Bu İşi Benden İsteyebilirsiniz Skill mimarisini kurmak — hangi işlerin skill’e dönüşeceğine karar vermek, SKILL.md’yi yazmak, test etmek — teknik bilgi ister ama büyük bir proje değildir. **Bu işi benden isteyebilirsiniz:** genelde 2 saat–2 hafta arası süren, uzaktan, saatlik ücretli bir iş. [Kendi yapay zeka asistanınızı](https://oguzerol.com/kendi-yapay-zeka-asistaniniz/) kurma sürecinin bir parçası olarak da ele alabiliriz. ## Sıkça Sorulan Sorular ### Claude Skills ücretsiz mi? Skill’lerin kendisi genelde ücretsiz paylaşılan bir metin/kod dosyasıdır. Ücretlendirme skill’e değil, kullandığınız Claude planına bağlıdır. Skill’lerin çalışması için claude.ai’da kod yürütme (code execution) özelliğinin açık olması gerekir; hangi planlarda kullanılabildiği için güncel Yardım Merkezi sayfasına bakın, çünkü kapsam değişebilir. ### Skill yazmak için kod bilmek gerekir mi? Hayır. Çoğu skill sadece düz metin talimattan (SKILL.md) oluşur. Kod ancak işin bir kısmı gerçekten otomasyon gerektiriyorsa devreye girer, o zaman da genelde hazır bir script’i eklemek yeterlidir. ### Skill’ler hangi Claude sürümlerinde çalışır? Anthropic’in belgesine göre (Ekim 2026) skill’ler claude.ai, Claude Code ve Claude API üzerinde kullanılabiliyor. Yüzeyler arasında özel skill’ler senkronize olmuyor, her yere ayrı eklenir. Kapsam değişebileceği için güncel dokümantasyona bakın. ### Claude skill nasıl eklenir? claude.ai’da skill klasörünü ZIP yapıp Customize > Skills sayfasından yüklersiniz; Claude Code’da klasörü `~/.claude/skills/` (kişisel) ya da projedeki `.claude/skills/` altına koyarsınız. Adımlar yukarıdaki “Claude Skill Nasıl Eklenir?” bölümünde. ### Claude skill nasıl kullanılır? claude.ai’da skill açıkken isteğiniz skill’in açıklamasıyla eşleşirse Claude onu kendisi kullanır. Claude Code’da ek olarak `/skill-adı` yazarak doğrudan çağırabilirsiniz. Skill devreye girmiyorsa isteği daha açık yazın ve skill açıklamasının ne zaman kullanılacağını net söylediğini kontrol edin. ### CLAUDE.md nedir, skill ile aynı mı? Hayır. CLAUDE.md, Claude Code’un her oturumda okuduğu kalıcı talimat dosyasıdır; skill ise yalnız iş eşleşince yüklenir. Genel kural CLAUDE.md’ye, belirli bir işin yöntemi skill’e yazılır. ### Custom GPT ya da GPT Actions ile aynı şey mi? Amaç benzer — tekrar eden bir işi paketlemek — ama mimari farklı. Skill’ler talimat ve opsiyonel dosya odaklıyken, GPT Actions daha çok API entegrasyonuna dayanır. İkisini birbirinin yerine koymak yanlış olur. [Başa dön ↑](https://oguzerol.com/claude-skills-nedir/#icerik) ## Bunları da okumak ister misiniz? [Claude Skills Marketplace’leri: Hangisi Kurulmaya DeğerClaude Skills marketplace'lerinden skill indirmeden önce nelere bakmalı? Kaynak, güncellik, izin kontrolü ve gerçek riskler — üçüncü taraf rehberi.](https://oguzerol.com/claude-skills-marketplace-hangisi-kurulmaya-deger/)[Danışman Olarak Gerçekten Kullandığım Claude Skills’lerHaftalık Google Ads raporu, GA4 özeti, SEO ses tonu ve yedek disiplini — danışmanlıkta gerçekten kullandığım dört Claude Skill örneğini anlatıyorum.](https://oguzerol.com/danisman-olarak-kullandigim-claude-skills-ornekleri/)[Benim Agentic Yığınım: Claude Code + Skills + MCP, Tek Kişilik SürümClaude Code, Skill'ler, MCP bağlantıları ve insan onayından oluşan ajanik yığınımı anlatıyorum: kurulum, günlük akış, sınırlar ve dürüst bir bakış açısıyla.](https://oguzerol.com/benim-agentic-yigimim-claude-code-skills-mcp/) [Tüm yazılara göz atın →](https://oguzerol.com/yazilarim/)