Claude Skills ve Plugin'ler: Ekibinizin Çalışma Biçimini Claude'a Öğretmek

Sürüm notu: Bu yazı Claude'daki skill'leri ve plugin'leri 15 Kasım 2026 itibarıyla anlatır; plan kuralları, yükleme adımları ve alan sınırları aynı gün Claude Help Center'dan (support.claude.com) ve Claude platform dokümantasyonundan (platform.claude.com) kontrol edilmiştir. Bu yazıda resmî belgelerden yararlanılmıştır. Anthropic yeni özellikleri hesaplara kademeli açtığı için anlatılanların bir kısmı senin hesabında henüz görünmeyebilir.

Önce Tahmin Et

Emre, sitedeki serilerin ortak örnek uygulaması Bookstore (bir online kitapçı) için müşteriye giden sürüm notlarını hep aynı biçimde yazdırmak istiyor. Bir skill hazırladı, description alanına "Helps with release notes." yazdı ve Customize > Skills'ten yükledi. Ertesi gün Claude'a "Bu sprintte birleşen pull request'lerden müşterilere bir 'yenilikler' duyurusu yaz" dedi; Claude skill'i hiç kullanmadan, kendi bildiği biçimde bir metin yazdı. Aynı gün Ayşe bir forumda "excel-pro" adlı, içinde scripts klasörü olan bir skill buldu ve ekibe önerdi.

İki soru: Emre'nin skill'i neden devreye girmedi? Ayşe'nin bulduğu skill'i yüklemeden önce neye bakmak gerekir? İlk sorunun cevabı skill'lerin nasıl yüklendiğinde, ikincisi Help Center'ın güvenlik uyarısında.

Skill Nedir: Bir Klasör ve Bir SKILL.md

Skill, Claude'a belirli bir işin nasıl yapılacağını öğreten bir klasör. Claude platform dokümantasyonundaki "Agent Skills" sayfasına göre (https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) her skill'in kökünde, YAML (insan tarafından okunabilir yapılandırma formatı) frontmatter'ı olan bir SKILL.md dosyası var; frontmatter'da iki zorunlu alan bulunuyor: name ve description. Dosyanın gövdesinde adımlar, örnekler ve kurallar yazıyor; klasörde ek doküman, şablon ve script'ler de durabiliyor.

Skill'leri prompt'tan ayıran şey yüklenme biçimi. Dokümantasyon bunu progressive disclosure (bilginin ihtiyaç oldukça, kademe kademe yüklenmesi) olarak anlatıyor ve üç seviye tarif ediyor:

Önce Tahmin Et'in ilk sorusunun cevabı bu tabloda. Claude bir skill'i, isteğini her zaman elinde olan tek bilgiyle, yani description'la karşılaştırarak seçiyor. "Helps with release notes." ne zaman kullanılacağını söylemiyor ve Emre'nin "yenilikler duyurusu" isteğiyle eşleşecek bir kelime içermiyor. Gövde ne kadar iyi yazılmış olursa olsun, description eşleşmezse gövde hiç okunmuyor.

Skill'ler bir çalışma ortamı istiyor: Claude skill dosyalarını bir sandbox'ta okuyor ve script'leri orada çalıştırıyor. Help Center'ın "Use skills in Claude" makalesine göre (https://support.claude.com/en/articles/12512180) bu yüzden Settings > Capabilities altında "Create and edit files" (eski adıyla "Code execution and file creation") ayarının açık olması gerekiyor. Altıncı yazıda Excel ve PowerPoint dosyalarını üreten hazır skill'leri görmüştük; onlar da aynı mekanizmayla çalışıyor.

Skill'ler Nerede ve Hangi Planda Çalışır

Help Center'a göre skill'ler Free, Pro, Max, Ultra, Team ve Enterprise planlarında var. Anthropic'in Excel, Word, PowerPoint ve PDF skill'leri Customize > Skills'ten açılıyor ve Claude bunları ilgili işlerde kendisi kullanıyor. Kendi skill'ini eklemek için klasörü ZIP (sıkıştırılmış arşiv dosyası) olarak paketleyip Customize > Skills'te "+", "+ Create skill" ve "Upload a skill" adımlarıyla yüklüyorsun; listeden açıp kapatabiliyorsun. "How to create custom skills" makalesi (https://support.claude.com/en/articles/12512198) iki paketleme kuralı koyuyor: klasörün adı skill'in adıyla aynı olmalı ve ZIP'in kökünde klasörün kendisi durmalı, içindekiler değil.

Aynı skill başka yüzeylerde de kullanılabiliyor, ama her yüzeyin kendi kuralı var. Help Center'a göre aynı Claude hesabıyla giriş yapılmış Claude Code'a (v2.1.273 ve sonrası) claude.ai'daki skill'ler tek yönlü senkronize oluyor ve /skills komutuyla görülüyor; API anahtarıyla ya da Amazon Bedrock gibi bir bulut sağlayıcısıyla girişte senkronizasyon yok. Excel, PowerPoint, Word ve Outlook eklentilerinde de skill'ler çalışıyor. Claude API tarafı ayrı: platform dokümanına göre claude.ai'a yüklenen bir skill API'de kendiliğinden görünmüyor, oraya ayrıca yüklenmesi gerekiyor. Claude Code'da skill'ler dosya sisteminde duruyor: kişisel olanlar ~/.claude/skills/, proje skill'leri repository'deki .claude/skills/ altında. Claude Code tarafının ayrıntısı ilerideki Claude Code serisinin "Claude Code'da Skills ve Slash Command'lar: Tekrar Eden İşleri Paketlemek" yazısında, API tarafı ilerideki Claude API ile Uygulama Geliştirme serisinde.

Description: Skill'in Tetiklendiği Yer

Platform dokümanı alan kurallarını net veriyor: name en fazla 64 karakter, yalnız küçük harf, rakam ve tire içerebiliyor, XML etiketi ve "anthropic" ya da "claude" kelimelerini içeremiyor; description boş olamıyor, en fazla 1.024 karakter ve hem skill'in ne yaptığını hem de ne zaman kullanılacağını söylemeli. Help Center'ın claude.ai'a yükleme anlatan makalesi ise description için 200 karakter sınırı veriyor. Aynı skill'i hem claude.ai'da hem Claude Code'da kullanacaksan description'ı 200 karakterin altında tutmak iki kurala birden uyuyor.

Emre'nin description'ı ile işe yarayan bir description'ı yan yana koyalım:

description: Helps with release notes.

description: Writes customer-facing Bookstore release notes from commits or
  merged pull requests. Use when asked for release notes, a changelog or a
  what's-new post.

İkincisi üç şey söylüyor: ne üretildiği (müşteriye giden sürüm notu), girdinin ne olduğu (commit ya da pull request listesi) ve hangi isteklerde kullanılacağı (release notes, changelog, what's-new). Kullanıcıların aynı işi farklı kelimelerle istediğini düşünerek eş anlamlıları description'a koymak, skill'in gerçek kullanımda tetiklenme ihtimalini artırıyor. Help Center'ın test önerisi de bu yönde: yükledikten sonra skill'i birkaç farklı prompt'la dene, Claude'un düşünme adımlarında skill'in yüklenip yüklenmediğine bak ve Claude beklediğin yerde skill'i kullanmıyorsa description'ı düzelt.

Bookstore: Sürüm Notu Skill'i

Skill'in klasör yapısı küçük tutuluyor; Help Center'ın önerisiyle uyumlu olarak script'siz, yalnız Markdown ile başlıyoruz:

bookstore-release-notes/
    SKILL.md
    template.md
    banned-words.md
    examples/2026-10.md

SKILL.md dosyası:

---
name: bookstore-release-notes
description: Writes customer-facing Bookstore release notes from commits or
  merged pull requests. Use when asked for release notes, a changelog or a
  what's-new post.
---

# Bookstore release notes

Follow these steps in order.

1. Read the commit or pull request list the user gives you. If there is
   no list, ask for one; never invent changes.
2. Drop changes customers cannot notice: refactoring, tests, CI,
   dependency updates without a visible effect.
3. Sort the rest into the sections in template.md.
4. Rewrite each item for a customer: what they can do now, in one sentence.
   No ticket IDs, class names or endpoint paths.
5. Check the draft against banned-words.md and remove every match.
6. Write in the language the user asks for; default to Turkish.
7. End with a short "Not included" list that names the dropped items,
   so the team can check what was left out.

See examples/2026-10.md for an approved release note.

Şablon ve yasaklı kelime listesi ayrı dosyalarda:

# template.md
## New
## Improved
## Fixed
(Translate the section titles into the output language.)

# banned-words.md
Never use these in customer-facing text:
- refactor, migration, endpoint, null, exception, hotfix
- internal ticket IDs such as BOOK-1234
- dates or promises about future releases

Bu yapının iki tasarım kararı var. Birincisi "Not included" listesi: Claude'un müşteriye görünmez saydığı değişiklikleri ayrıca listelemesi, Selin'in "bu düzeltme neden notta yok?" sorusunu sormasını kolaylaştırıyor; atlanan bir iade düzeltmesi, Gül'ün destek ekibi için önemli bir bilgi olabilir. İkincisi kuralların ayrı dosyalarda durması: yasaklı kelime listesi büyüdükçe SKILL.md gövdesi değişmiyor ve dosya yalnız 5. adımda okunuyor.

Skill'i yükledikten sonra tetiklenmeyi dört prompt'la ölçmek yeterli. İlk ikisinde skill'in yüklenmesi, son ikisinde yüklenmemesi bekleniyor:

Dördüncü satır description'ın sınırını test ediyor: iç ekip için yazılan bir changelog'da sınıf adları ve endpoint'ler serbest. Claude bu isteğe de müşteri skill'ini uygularsa description'a "not for internal changelogs" gibi bir cümle eklemek gerekiyor. Aynı klasörü repository'de .claude/skills/bookstore-release-notes/ altına koyarsan Ayşe ve Emre Claude Code'da da aynı kuralı kullanıyor; skill'in tek bir kaynağı oluyor ve değişiklikler pull request'le review ediliyor.

Ekipte Skill Paylaşımı

Team ve Enterprise'da skill'ler kişiden kişiye ve organizasyona paylaşılabiliyor. Help Center'a göre Team'de skill'ler organizasyon düzeyinde varsayılan olarak açık; Enterprise'da sahiplerin Organization settings > Plugins & skills altındaki Policy sekmesinde "Code execution and file creation" ve "Skills" ayarlarının açık olduğunu kontrol etmesi gerekiyor. Sahipler skill'leri bütün kullanıcılara dağıtabiliyor; dağıtılan skill'ler bir ekip işaretiyle görünüyor. Kullanıcıların kendi skill'lerini oluşturmasını kapatmak da mümkün; Enterprise'da custom role kullanılıyorsa kullanıcının ayrıca "Create skills" yetkisine ihtiyacı var.

Paylaşılan bir skill alıcı tarafında yalnız görüntülenebiliyor ve güncellemeler alıcıya otomatik gidiyor. Bir skill'i bütün organizasyona açmak için "Publish to org" adımı var; review zorunluysa bir reviewer skill'i önce inceliyor ve kullanılabilir, varsayılan olarak yüklü ya da zorunlu yapabiliyor. Bookstore'da sürüm notu skill'inin sahibi Selin olabilir: kuralları o belirliyor, Emre ve Ayşe değişiklik öneriyor, yayımlanan sürüm herkese aynı anda gidiyor.

Plugin'ler: Skill, Connector ve Daha Fazlası

Plugin bir paket. Help Center'ın "Use plugins in Claude" makalesine göre (https://support.claude.com/en/articles/13837440) plugin skill'leri, connector'ları ve sub-agent'ları tek pakette topluyor; hook'lar ve local MCP (Model Context Protocol; Claude'un dış araç ve veri kaynaklarına bağlandığı açık protokol) server'ları da içerebiliyor. Plugin'in skill'leri ve komutları slash command olarak görünüyor; "/" yazınca listeleniyor. Plugin'ler bütün ücretli planlarda (Pro, Max, Ultra, Team, Enterprise) var ve Customize menüsündeki Plugins sekmesinde Discover'dan seçilip "Add" ile ekleniyor.

Plugin'in her parçası her yerde çalışmıyor. Skill'ler ve komutlar web'deki chat'te, Desktop'ta ve Cowork'te çalışıyor; hook'lar ve sub-agent'lar yalnız Cowork'te ve Claude Code'da çalışıyor, chat'te gri görünüyor. Kendi yaptığın bir plugin dosyasını yükleyebiliyor ya da "Plugin Create" plugin'iyle adım adım oluşturabiliyorsun. Varsayılan olarak Knowledge Work marketplace'i ekli; GitHub, GitLab ya da Bitbucket'taki bir repository'yi de marketplace olarak eklemek mümkün. Release notes'a göre plugin marketplace'i Cowork'e 24 Şubat 2026'da geldi ve 25 Eylül 2026'dan beri geliştiriciler plugin'lerini yeni bir portal üzerinden Claude dizinine gönderebiliyor.

Team ve Enterprise'da sahipler plugin'leri marketplace'ler üzerinden dağıtıyor ya da kullanıcıların organizasyon kütüphanesine yayımladığı plugin'leri onaylıyor. Zorunlu yapılan plugin'ler, Claude Code'da bile kapatılamıyor ve kaldırılamıyor. Sahipler hangi marketplace'lerin kullanılabileceğini sınırlayabiliyor ve local MCP server'ları tamamen kapatabiliyor. Bookstore için mantıklı bir plugin, sürüm notu skill'i ile sekizinci yazıdaki Bookstore connector'ını birlikte paketlemek olur: skill nasıl yazılacağını, connector hangi verinin okunacağını söylüyor.

Güvenlik: Skill Yüklemek Yazılım Kurmaktır

Önce Tahmin Et'in ikinci sorusunun cevabı Help Center'da açıkça yazıyor: skill'leri yalnız güvendiğin kaynaklardan kur. Skill'ler üçüncü taraf paket ve yazılım kurabiliyor ya da Claude'a kurdurabiliyor; makaleye göre başlıca riskler prompt injection ve kötü niyetli paket kodu ya da enjekte edilmiş veri yoluyla veri sızdırılması. Az güvendiğin bir kaynaktan gelen skill'i açmadan önce içindeki bütün dosyalara, özellikle bağımlılıklara, script'lere ve dış ağa bağlanmayı söyleyen talimatlara bakman gerekiyor.

Platform dokümanı aynı uyarıyı daha sert yapıyor: skill'i bir yazılım kurar gibi ele al; dış URL'lerden veri çeken skill'ler özellikle riskli, çünkü çekilen içerik talimat taşıyabilir ve bugün güvenilir olan bir bağımlılık yarın değişebilir. Ayşe'nin bulduğu "excel-pro" için yapılacak iş belli: SKILL.md'yi baştan sona oku, scripts klasöründeki her dosyanın ne yaptığını anla, dışarıya istek atan ya da beklenmedik dosyalara erişen bir satır var mı bak; anlamadığın bir şey varsa yükleme.

Enterprise'da ek bir katman var. Release notes'a göre 6 Ağustos 2026'dan beri beta olan skill ve plugin güvenlik taraması, yüklenen ya da düzenlenen üçüncü taraf skill ve plugin'leri çalışmadan önce kötü niyetli içerik için tarıyor. Plugin makalesine göre kötü niyetli bulunan plugin'ler engelleniyor, riskli görünenler bir uyarı bandıyla gösteriliyor. Platform dokümanı, taramanın Skills API ya da Claude Console üzerinden yüklenen skill'leri kapsamadığını da not ediyor. Tarama iyi bir ağ, ama okuma işini senin yerine yapmıyor.

Üretimde Dikkat

Skill'i kod gibi yönet. Repository'de duran, pull request'le değişen ve sahibi belli bir skill, birinin kendi hesabına yüklediği kopyadan daha güvenilir. Her önemli değişiklikten sonra tetiklenme tablosundaki prompt'ları yeniden çalıştır.

Bir skill, bir iş. Help Center'ın önerisi de bu: her skill tek bir iş akışına odaklansın. "Bookstore'da her şey" diye bir skill, description'ı belirsizleştiriyor ve yanlış yerde tetiklenmeye başlıyor.

Secret koyma. Skill dosyalarına API anahtarı ya da şifre yazılmıyor; dış servise erişim gerekiyorsa bunun yeri sekizinci yazıdaki connector'lar. Katmanları da karıştırma: her konuşmada geçerli kurallar Instructions for Claude'da, bir işe ait bağlam project'te, bir işin nasıl yapılacağı skill'de duruyor.

Sık Düşülen Tuzaklar

Description'ı belirsiz yazmak. Skill hiç tetiklenmiyor. Ne yaptığını ve hangi isteklerde kullanılacağını, kullanıcıların kullandığı kelimelerle yaz.

ZIP'i yanlış paketlemek. Klasörün içindekileri değil, klasörün kendisini paketle; klasör adı skill adıyla aynı olsun.

Güvenilmeyen kaynaktan skill yüklemek. Skill script çalıştırabilir ve paket kurabilir. Bütün dosyaları okumadan yükleme.

Skill'i Instructions yerine kullanmak. Her konuşmada geçerli bir kural (örneğin "cevapları Türkçe ver") skill'e değil Instructions for Claude'a yazılır; skill yalnız ilgili iş geldiğinde yükleniyor.

Skill'in her yüzeyde kendiliğinden olduğunu sanmak. claude.ai'dan Claude Code'a senkronizasyon tek yönlü ve aynı hesapla girişe bağlı; API'ye ayrıca yüklemek gerekiyor.

Küçük Bir Deneme

★☆☆ Customize > Skills'i aç, Anthropic'in hazır skill'lerinin açık olup olmadığına bak. Bir Excel dosyası isteyip Claude'un düşünme adımlarında xlsx skill'inin yüklendiğini gör.

★★☆ Ekibinin sık yaptığı bir iş için yazıdaki gibi bir skill hazırla: SKILL.md, bir şablon ve bir kural dosyası. Description'ı 200 karakterin altında tut ve dört prompt'luk bir tetiklenme tablosuyla test et.

★★★ İnternette bulduğun, script içeren bir skill'i yüklemeden incele. Her dosya için ne yaptığını, dış ağa erişip erişmediğini ve hangi paketleri kurduğunu bir tabloya yaz; sonunda "yüklerim" ya da "yüklemem" kararını gerekçesiyle ver.

Skill'ler Claude'a bir işin nasıl yapılacağını öğretiyor. Onuncu yazıda Claude'un o işi uzun süre, birçok adımda ve bazen senin tarayıcında yaptığı duruma geçiyoruz: Cowork görevleri, Claude in Chrome ve güvenli permission ayarları.