{"id":"2032041205245116828","url":"https://x.com/ersinkoc/status/2032041205245116828","text":"","author":{"name":"Ersin KOÇ","username":"ersinkoc","avatarUrl":"https://pbs.twimg.com/profile_images/1993454452456534016/z540NVXr_200x200.jpg"},"createdAt":"Thu Mar 12 10:29:11 +0000 2026","engagement":{"replies":6,"retweets":32,"likes":254,"views":107263},"article":{"title":"Agent Skills: AI Agentlarına \"Meslek\" Öğretmenin Yolu","previewText":"Vibe coding'den yazılım mühendisliğine  herkes için kapsamlı rehber\nBu Yazı Kimin İçin?\nEğer Claude, Claude Code, Cursor, GitHub Copilot ya da benzeri bir AI aracı kullanıyorsan bu yazı senin için.","coverImageUrl":"https://pbs.twimg.com/media/HDNCrlMWYAAY6D4.jpg","content":"## Vibe coding'den yazılım mühendisliğine  herkes için kapsamlı rehber\n\n## Bu Yazı Kimin İçin?\n\nEğ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.\n\n## Bölüm 1 - Nedir Bu \"Skills\"?\n\nEn Basit Tanım\n\nSkill, 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.\n\nCiddiyim. Hepsi bu.\n\nBir 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.\n\nNeden Var?\n\nClaude (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.\n\nSkills, 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.\n\nGerçek Hayat Analojisi\n\nDiyelim ki her hafta bir PowerPoint sunumu hazırlıyorsun. Her seferinde Claude'a şunları söylüyorsun:\n\n- \"Arial fontu kullan\"\n\n- \"Her slide'da şirket logosu olsun\"\n\n- \"Renk paleti şu olsun: #2E75B6, #1F4E79...\"\n\n- \"Son slide'da her zaman iletişim bilgileri bulunsun\"\n\nHaftada 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.\n\nSkill ile bunu bir kere yazarsın. Artık Claude'a sadece \"sunum hazırla\" demen yeterli. Gerisini o skill halleder.\n\n## Bölüm 2 - Neden Skills Kullanmalıyız?\n\n1. Tekrar Tekrar Aynı Şeyi Söylemekten Kurtulursun\n\nPrompt'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.\n\n2. Tutarlılık\n\nİ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.\n\n3. Alan Uzmanlığı (Domain Expertise)\n\nClaude 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.\n\n4. Paylaşılabilirlik\n\nBir 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.\n\n5. Progressive Disclosure (Kademeli Bilgi Açığa Çıkarma)\n\nBu, 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.\n\n## Bölüm 3 - Skill'in Anatomisi\n\nBir skill'in minimum yapısı şöyle:\n\nEvet, tek bir dosya yeterli. Ama o dosyanın belirli bir formatı var:\n\nİki parça var:\n\n1. 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.\n\n2. 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.\n\nBüyüyen Skill'ler\n\nSkill karmaşıklaştıkça, tek bir SKILL.md yetmeyebilir. O zaman ek dosyalar eklersin:\n\nSKILL.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.\n\n## Bölüm 4 - Skills Nerede Çalışıyor?\n\nClaude.ai (Web/Mobil)\n\nAnthropic'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.\n\nKendi 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.\n\nClaude Code (Terminal)\n\nSkill'ler dosya sistemi üzerinden çalışır. .claude/skills/ dizinine koyarsın, Claude Code otomatik keşfeder. Slash command olarak da çağırabilirsin: /my-skill.\n\nClaude API\n\nAPI üzerinden container.skills parametresiyle skill'leri mesaj isteğine eklersin. Hem Anthropic'in hazır skill'lerini hem de kendi yüklediklerini kullanabilirsin.\n\nDiğer Platformlar\n\nAgent 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.\n\n## Bölüm 5 - İlk Skill'ini Yaz (Uygulamalı)\n\nHadi basit bir örnekle başlayalım. Diyelim ki blog yazıları yazıyorsun ve her seferinde aynı formatı istiyorsun:\n\nBu 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.\n\n## Bölüm 6 - Orta Seviye: Kod Çalıştıran Skill'ler\n\nSkill'ler sadece metin talimatı değildir. İçine script koyabilirsin ve Claude bu script'leri çalıştırabilir.\n\nLLM'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.\n\nÖ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.\n\nSKILL.md içinde:\n\nClaude bu talimatı okuduğunda, script'i çalıştırmayı bilir.\n\n## Bölüm 7 - İleri Seviye: Mimari Kararlar ve Best Practice'ler\n\nProgressive Disclosure'ı Doğru Tasarla\n\nSkill'inin üç seviyesini bilinçli olarak planla:\n\nSeviye 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.\n\nSeviye 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şı.\n\nSeviye 3 - Ek dosyalar (ihtiyaç duyulduğunda yüklenir): Spesifik senaryolara özel detaylar. Claude sadece ihtiyacı olduğunda okur.\n\nSkill Yazarken Dikkat Edilecekler\n\nClaude'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.\n\nDeğ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.\n\nClaude 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.\n\nDeterministik 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.\n\nGüvenlik\n\nSkill'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.\n\n## Bölüm 8 - Skills vs MCP: Farkı Anlamak\n\nBu konuda kafalar sık karışıyor. İkisi rakip değil, tamamlayıcı.\n\nMCP (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?\"\n\nAgent 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?\"\n\nBaş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.\n\n## Bölüm 9 - Açık Standart: Write Once, Use Everywhere\n\nAralı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.\"\n\nBu ne anlama geliyor?\n\n- Claude Code için yazdığın skill, Cursor'da da çalışır\n\n- GitHub Copilot (VS Code) da aynı formatı destekler\n\n- OpenAI'ın Codex'i bile Agent Skills standardını benimsedi\n\n- Atlassian, Figma, Canva, Stripe, Notion, Zapier gibi büyük şirketler partner skill'ler oluşturdu\n\nVendor lock-in yok. Bugün Claude kullanıyorsun, yarın başka bir araca geçsen skill'lerin hâlâ çalışır.\n\n## Bölüm 10 - Pratik Senaryolar\n\nSenaryo 1: Vibe Coder\n\nKod yazmayı yeni öğreniyorsun, Claude'la projeler yapıyorsun. Bir skill yaz:\n\nSenaryo 2: Takım Lideri\n\nEkibinin kod standartlarını skill olarak paketlersek:\n\nSenaryo 3: Doküman Üretimi\n\nŞirketinin belirli bir doküman formatı var her seferinde açıklamak yerine skill'e dök:\n\n## Bölüm 11 - Skill Oluşturmanın Platformlara Göre Yolları\n\nClaude.ai'de\n\n1. Settings → Features → Custom Skills bölümüne git\n\n1. Skill klasörünü zip'le ve yükle\n\n1. Veya \"Create a skill\" seçeneğiyle Claude'a ne istediğini anlat  o skill'i senin için oluştursun\n\nClaude Code'da\n\nSlash command olarak çağır: /my-skillVeya Claude otomatik tetikler description'ı yeterince iyi yazdıysan.\n\nVS Code / Cursor'da\n\nveya\n\n## Bölüm 12 - Sonuç: Skills Neden Önemli?\n\nAgent 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.\n\nÖzetlersek:\n\n- Başlangıç seviyesindeysen: Skill'ler, Claude'un seni her seferinde aynı kalitede desteklemesini sağlar. Bir kere yaz, her seferinde tutarlı sonuç al.\n\n- Orta seviyedeysen: Skill'ler, tekrar eden iş akışlarını otomatize etmenin en zarif yolu. Takımınla paylaş, herkes aynı standartta çalışsın.\n\n- İleri seviyedeysen: Skill'ler, agent mimarinin temel yapı taşı. MCP ile birlikte kullanarak, kurumsal bilgiyi paketlenmiş, versiyonlanmış, taşınabilir birimlere dönüştürebilirsin.\n\nSkill yazmak zor değil. Bir klasör, bir markdown dosyası. Ama etkisi büyük.\n\nBaş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.\n\n## Kaynaklar\n\n- Resmi Dokümantasyon: docs.claude.com/en/docs/agents-and-tools/agent-skills/overview\n\n- Açık Standart Spesifikasyonu: agentskills.io/specification\n\n- Anthropic Mühendislik Blogu: anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills\n\n- Örnek Skill'ler: github.com/anthropics/skills\n\n- Claude Code Skills: docs.claude.com/en/docs/claude-code/skills\n\nBu 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."},"adhxContext":{"savedByCount":1,"publicTags":[],"previewUrl":"https://adhx.com/ersinkoc/status/2032041205245116828"}}