Found something good?

Vibe coding'den yazılım mühendisliğine herkes için kapsamlı rehber

Bu Yazı Kimin İçin?

Eğer Claude, Claude Code, Cursor, GitHub Copilot ya da benzeri bir AI aracı kullanıyorsan bu yazı senin için. Seviyenin hiç önemi yok. "Prompt yazdım çalıştı" diyen biriysen de, production'da multi-agent sistem tasarlayan biriysen de bu yazıdan bir şeyler alacaksın. Yazı bilinçli olarak basitten karmaşığa doğru ilerliyor. Sıkılmaya başladığın yer, zaten bildiğin yer demektir oradan sonrasını oku.

Bölüm 1 - Nedir Bu "Skills"?

En Basit Tanım

Skill, bir klasördür. İçinde bir SKILL.md dosyası vardır. Bu dosya, AI agent'a "şu tip bir iş geldiğinde şöyle çalış" diyen bir talimat setidir. Hepsi bu.

Ciddiyim. Hepsi bu.

Bir skill ne bir API'dir, ne bir plugin'dir, ne de bir framework'tür. Sadece bir klasör ve içindeki markdown dosyası. Ama bu basitlik, gücünün ta kendisi.

Neden Var?

Claude (ya da herhangi bir LLM) inanılmaz yetenekli ama genel amaçlı bir zeka. Tıpkı çok zeki ama ilk gün işe başlamış bir stajyer gibi düşün. Her şeyi anlıyor, her dili biliyor, ama senin şirketinin iş akışlarını, tercihlerini, standartlarını bilmiyor.

Skills, o stajyere verdiğin "işe alım kılavuzu" gibi bir şey. İlk günden beri ne yapması gerektiğini bilecek şekilde onu eğitiyorsun ama her seferinde sıfırdan anlatmak yerine, bir kere yazıp sonsuza kadar kullanıyorsun.

Gerçek Hayat Analojisi

Diyelim ki her hafta bir PowerPoint sunumu hazırlıyorsun. Her seferinde Claude'a şunları söylüyorsun:

Haftada bir bunu tekrar tekrar yazmak hem zaman kaybı hem de tutarsızlık riski. Bir gün logoyu söylemeyi unutursun boom, sunum eksik çıkar.

Skill ile bunu bir kere yazarsın. Artık Claude'a sadece "sunum hazırla" demen yeterli. Gerisini o skill halleder.

Bölüm 2 - Neden Skills Kullanmalıyız?

1. Tekrar Tekrar Aynı Şeyi Söylemekten Kurtulursun

Prompt'lar konuşma düzeyinde çalışır bir seferlik talimatlardır. Skills ise kalıcıdır. Bir kere yaz, her konuşmada otomatik devreye girsin.

2. Tutarlılık

İnsan olarak her seferinde aynı şeyi birebir aynı yazamayız. Bir gün "TypeScript strict mode kullan" deriz, ertesi gün unuturuz. Skill, her seferinde aynı standartları uygular. Bir proje boyunca tutarlı kalite.

3. Alan Uzmanlığı (Domain Expertise)

Claude genel olarak çok şey bilir ama senin spesifik alanındaki best practice'leri, senin şirketinin coding convention'larını, senin müşterinin istediği formatı bilmez. Skill ile ona bu bilgiyi verirsin.

4. Paylaşılabilirlik

Bir skill yazdın ve harika çalışıyor. Bunu takım arkadaşlarınla paylaşabilirsin. Hatta open source olarak tüm dünyayla. Agent Skills artık açık bir standart Claude, Cursor, GitHub Copilot, VS Code, OpenCode ve daha birçok araçta çalışıyor.

5. Progressive Disclosure (Kademeli Bilgi Açığa Çıkarma)

Bu, Skills mimarisinin en zarif tarafı. Claude, kurulum sırasında sadece skill'lerin adını ve açıklamasını yükler (yaklaşık 50-100 token). Asıl talimatları ancak o skill gerektiğinde okur. Yüzlerce skill yükleyebilirsin ama context window'un şişmez. Bu, "ihtiyaç duyulduğunda yükle" prensibidir.

Bölüm 3 - Skill'in Anatomisi

Bir skill'in minimum yapısı şöyle:

Evet, tek bir dosya yeterli. Ama o dosyanın belirli bir formatı var:

İki parça var:

1. YAML Frontmatter (--- işaretleri arasındaki kısım): name ve description zorunlu. Bu bilgi başlangıçta Claude'un system prompt'una yüklenir. Claude bu bilgiyle "Bu skill'i kullanmalı mıyım?" kararını verir.

2. Markdown Body (geri kalan her şey): Claude skill'i tetiklediğinde okuduğu asıl talimatlar. Burada ne kadar detaylı ve net olursan, sonuçlar o kadar iyi olur.

Büyüyen Skill'ler

Skill karmaşıklaştıkça, tek bir SKILL.md yetmeyebilir. O zaman ek dosyalar eklersin:

SKILL.md içinde bu dosyalara referans verirsin. Claude ihtiyaç duyduğunda onları okur, duymadığında dokunmaz. Bu, üçüncü seviye progressive disclosure'dır. Böylece bir skill'in taşıyabileceği bilgi miktarının pratikte sınırı yoktur.

Bölüm 4 - Skills Nerede Çalışıyor?

Claude.ai (Web/Mobil)

Anthropic'in hazır skill'leri (PowerPoint, Excel, Word, PDF) zaten arka planda aktif. Sen bir sunum ya da tablo istediğinde Claude bunları otomatik kullanıyor.

Kendi skill'lerini yüklemek için: Settings → Features bölümünden zip dosyası olarak yüklersin. Pro, Max, Team ve Enterprise planlarda kullanılabilir.

Claude Code (Terminal)

Skill'ler dosya sistemi üzerinden çalışır. .claude/skills/ dizinine koyarsın, Claude Code otomatik keşfeder. Slash command olarak da çağırabilirsin: /my-skill.

Claude API

API üzerinden container.skills parametresiyle skill'leri mesaj isteğine eklersin. Hem Anthropic'in hazır skill'lerini hem de kendi yüklediklerini kullanabilirsin.

Diğer Platformlar

Agent Skills açık bir standart olduğu için artık Cursor, GitHub Copilot (VS Code), OpenCode, Amp, Letta ve daha birçok araçta destekleniyor. Bir kere yaz, her yerde kullan.

Bölüm 5 - İlk Skill'ini Yaz (Uygulamalı)

Hadi basit bir örnekle başlayalım. Diyelim ki blog yazıları yazıyorsun ve her seferinde aynı formatı istiyorsun:

Bu kadar. Bu dosyayı bir blog-post-writer/SKILL.md olarak kaydedip Claude'a yüklediğinde, artık "blog yaz" dediğinde Claude bu formatı otomatik uygulayacak.

Bölüm 6 - Orta Seviye: Kod Çalıştıran Skill'ler

Skill'ler sadece metin talimatı değildir. İçine script koyabilirsin ve Claude bu script'leri çalıştırabilir.

LLM'ler bazı işlerde harikadır ama bazı işler için deterministik kod çalıştırmak çok daha güvenilirdir. Bir listeyi sıralamak, bir PDF'den form alanlarını çıkarmak, bir dosyayı doğrulamak bunlar token üretmekle değil, kod çalıştırmakla yapılması gereken işlerdir.

Örneğin Anthropic'in PDF skill'i içinde Python script'leri var. Claude bu script'leri çalıştırarak form alanlarını çıkarıyor ne script'i ne de PDF'i context window'a yüklemesine gerek kalmıyor. Sonuç deterministik ve tekrarlanabilir.

SKILL.md içinde:

Claude bu talimatı okuduğunda, script'i çalıştırmayı bilir.

Bölüm 7 - İleri Seviye: Mimari Kararlar ve Best Practice'ler

Progressive Disclosure'ı Doğru Tasarla

Skill'inin üç seviyesini bilinçli olarak planla:

Seviye 1 - Metadata (her zaman yüklü, ~50-100 token): name ve description. Claude'un "Bu skill'i kullanmalı mıyım?" sorusuna cevap veren bilgi. Description'ı çok iyi yaz. Ne zaman tetiklenmesi gerektiğini açıkça belirt. Tetiklenmemesi gereken durumları da yaz.

Seviye 2 - SKILL.md body (tetiklendiğinde yüklenir, <5000 token önerisi): Ana talimatlar. 500 satırın altında tut. Detaylı referansları ayrı dosyalara taşı.

Seviye 3 - Ek dosyalar (ihtiyaç duyulduğunda yüklenir): Spesifik senaryolara özel detaylar. Claude sadece ihtiyacı olduğunda okur.

Skill Yazarken Dikkat Edilecekler

Claude'un perspektifinden düşün. Claude bu skill'i okuduğunda ne yapması gerektiğini net anlayabiliyor mu? Belirsizlik varsa Claude kendi yorumunu katacaktır bu her zaman istediğin sonucu vermez.

Değerlendirmeyle başla. Önce Claude'u representative görevlerde çalıştır, nerede zorlandığını gözlemle. Sonra o boşlukları dolduran skill'ler yaz. Ön sezgiyle değil, veriyle ilerle.

Claude ile birlikte iterate et. Bir görevde Claude başarılı olduğunda, ona "Bu yaklaşımı bir skill olarak yaz" de. Yanlış gittiğinde, "Ne yanlış gitti, self-reflect yap" de. Claude'un kendi deneyiminden öğrenmesini sağla.

Deterministik işleri koda bırak. Claude'un token üretmesini gerektirmeyen işler (dosya dönüştürme, veri doğrulama, format kontrolü) için script yaz. Hem daha güvenilir hem daha hızlı hem daha ucuz.

Güvenlik

Skill'ler Claude'a yeni yetenekler kazandırır bu çok güçlü bir şey ve kötüye kullanılabilir. Sadece güvendiğin kaynaklardan skill kullan. Bilinmeyen bir kaynaktan skill alıyorsan, kullanmadan önce tüm dosyaları oku. Özellikle script'lere, ağ çağrılarına ve dosya erişim paternlerine dikkat et.

Bölüm 8 - Skills vs MCP: Farkı Anlamak

Bu konuda kafalar sık karışıyor. İkisi rakip değil, tamamlayıcı.

MCP (Model Context Protocol): Agent'ların dış dünyayla iletişim kurmasını sağlayan "tesisat" altyapısı. Veritabanlarına, API'lara, servislere bağlantı sağlar. Soruya cevap verir: "Hangi araçlar mevcut?"

Agent Skills: Agent'ın bu araçları nasıl kullanacağını öğreten "prosedürel hafıza". Soruya cevap verir: "Bu araçları ne zaman, nasıl, hangi sırayla kullanmalıyım?"

Başka bir deyişle: MCP, bir mutfağa tüm malzemeleri ve ekipmanları koyar. Skill ise aşçıya tarifi öğretir. İkisi birlikte olduğunda yemek ortaya çıkar.

Bölüm 9 - Açık Standart: Write Once, Use Everywhere

Aralık 2025'te Anthropic, Agent Skills'i açık bir standart olarak yayımladı. Spesifikasyon agentskills.io adresinde yaşıyor. Bu, MCP ile aynı stratejik hamle: "Herkes kullansın, biz en iyi uygulayan olalım."

Bu ne anlama geliyor?

Vendor lock-in yok. Bugün Claude kullanıyorsun, yarın başka bir araca geçsen skill'lerin hâlâ çalışır.

Bölüm 10 - Pratik Senaryolar

Senaryo 1: Vibe Coder

Kod yazmayı yeni öğreniyorsun, Claude'la projeler yapıyorsun. Bir skill yaz:

Senaryo 2: Takım Lideri

Ekibinin kod standartlarını skill olarak paketlersek:

Senaryo 3: Doküman Üretimi

Şirketinin belirli bir doküman formatı var her seferinde açıklamak yerine skill'e dök:

Bölüm 11 - Skill Oluşturmanın Platformlara Göre Yolları

Claude.ai'de

Claude Code'da

Slash command olarak çağır: /my-skillVeya Claude otomatik tetikler description'ı yeterince iyi yazdıysan.

VS Code / Cursor'da

veya

Bölüm 12 - Sonuç: Skills Neden Önemli?

Agent Skills, AI araçlarıyla çalışma biçimimizi temelden değiştiriyor. Artık her kullanım senaryosu için ayrı bir özelleştirilmiş agent inşa etmek yerine, tek bir genel amaçlı agent'a ihtiyaç duyduğu skill'leri yükleyebiliyoruz. Tıpkı bir insanın yeni beceriler öğrenmesi gibi.

Özetlersek:

Skill yazmak zor değil. Bir klasör, bir markdown dosyası. Ama etkisi büyük.

Başla. Bugün en çok tekrar ettiğin prompt'u bir skill'e dönüştür. Bir hafta sonra "Bunu neden daha önce yapmadım?" diyeceksin.

Kaynaklar

Bu makale, Agent Skills ekosistemini herkes için anlaşılır kılmak amacıyla yazılmıştır. Skills açık bir standarttır ve sürekli gelişmektedir güncel bilgi için her zaman resmi dokümantasyonu kontrol edin.