Skill'lerden Agent Takımlarına: Hangi İş Hangi Basamakta Çözülmeli?

Bir skill, içinde SKILL.md dosyası bulunan bir klasör. Dosyanın başında en az name ve description alanları olan bir YAML bloğu, altında ajanın izleyeceği talimatlar var. Klasöre scripts, references ve assets gibi alt dizinlerle yardımcı betikler, referans belgeler ve şablonlar eklenebiliyor. Format Anthropic tarafından geliştirildi, Aralık 2025'te açık standart olarak yayımlandı ve agentskills.io'daki listeye göre Claude Code, Cursor, Gemini CLI, OpenAI Codex, GitHub Copilot, VS Code ve JetBrains Junie dahil çok sayıda araçta destekleniyor. GitHub Copilot proje skill'lerini .github/skills, .claude/skills ya da .agents/skills altında arıyor; yani bir kez yazılan skill farklı araçlarda aynı klasörden okunabiliyor.

Mobil ekip için iyi bir ilk skill örneği: “release notu hazırla”. Talimatlar, son etiketten bu yana commit'leri okuyup App Store ve Play Store için ayrı, karakter sınırına uyan metinler üretmeyi tarif eder; bir betik commit listesini çeker, bir şablon formatı sabitler.

Anti-pattern: skill'i genel bir kodlama tavsiyeleri yığınına çevirmek. “Temiz kod yaz” gibi talimatlar modelin zaten bildiği şeylerdir. Skill'in değeri ekibe özgü, modelin tahmin edemeyeceği bilgide: modül adlandırma kuralınız, imzalama adımlarınız, iç API sözleşmeleriniz.

Son 12 ayda merdivenin alt basamağı bir endüstri standardına dönüştü. Anthropic, Agent Skills'i 18 Aralık 2025'te açık standart olarak yayımladı; agentskills.io'daki istemci listesi bugün Claude Code, Cursor, Gemini CLI, Codex, GitHub Copilot, VS Code, Junie, Kiro, OpenCode ve Goose dahil onlarca aracı kapsıyor. Spesifikasyon sade kaldı: name en fazla 64, description en fazla 1024 karakter, SKILL.md gövdesi için 500 satırın altı ve 5 bin tokenın altı öneriliyor. Mobil tarafta Xcode 27, plug-in'lerle özel skill, MCP tool'ları ve ACP uyumlu Agent'ları destekliyor; Android CLI ise Ekim 2026'da 20'den fazla resmî SKILL.md skill'i yayımladı. Subagent tarafında Claude Code arka planda çalışma, git worktree izolasyonu ve kalıcı Memory alanları ekledi. Agent takımları Şubat 2026'da Opus 4.6 ile deneysel olarak geldi ve bugün de bir ortam değişkeniyle açılan deneysel bir özellik; resmî dokümantasyon session devam ettirme, görev durumu gecikmesi ve kapanma tarafında bilinen sınırları sıralıyor ve plan modunda teammate'lerin standart bir session'a göre yaklaşık 7 kat token harcadığını söylüyor.

Skill'lerin ölçeklenmesini sağlayan mekanizma progressive disclosure (aşamalı açılım). Ajan açılışta yalnızca her skill'in adını ve açıklamasını yükler. Görev bir açıklamayla eşleştiğinde SKILL.md'nin tamamını okur; referans dosyaları ve betikleri ise yalnızca talimatlar gerektirdiğinde açar. Böylece onlarca skill tanımlı olsa bile bağlamın büyük kısmı boş kalır.

Bu yapı, açıklama alanını skill'in en kritik satırı hâline getiriyor. Açıklama ne zaman tetikleneceğini net söylemiyorsa skill ya hiç kullanılmaz ya da alakasız görevlerde devreye girer. İyi bir açıklama hem ne yaptığını hem de tetikleyici durumları içerir: “iOS veya Android sürüm notu, changelog ya da mağaza ‘What's New’ metni istendiğinde kullan” gibi.

Pratik eşik: spesifikasyon SKILL.md gövdesini 500 satırın ve yaklaşık 5 bin tokenın altında tutmayı öneriyor; açıklama alanı ise en fazla 1024 karakter. Gövdeyi kısa tutun, uzun API referanslarını ayrı dosyalara taşıyıp gövdeden bağlantı verin. Ayrıca bir skill betik çalıştırıyorsa, o betik ajanın yetkileriyle çalışır; dışarıdan indirilen skill'leri bir bağımlılık gibi inceleyip sürümleyin.

Subagent, ana ajanın belirli bir işi devrettiği, kendi bağlam penceresi, kendi sistem talimatı ve kısıtlı araç seti olan yardımcı ajan. Claude Code'da bunlar proje içinde .claude/agents altında Markdown dosyaları olarak tanımlanıyor; her biri bir ad, açıklama, izinli araçlar ve isteğe bağlı model seçimi taşıyor. Subagent işini bitirince ana ajana yalnızca özet sonucu döner. Ana bağlam, subagent'ın okuduğu yüzlerce dosyayla kirlenmez.

Bu yüzden subagent'lar en çok iki durumda değer üretir. Birincisi geniş arama: “bu 300 dosyalık projede tüm deep link işleyicilerini bul” gibi çok okuma, az yazma gerektiren işler. İkincisi bağımsız paralel işler: iOS ve Android tarafındaki aynı analytics olayını iki ayrı subagent'ın aynı anda incelemesi.

2026'da subagent'lar da güçlendi: Claude Code'da bir subagent arka planda çalışabiliyor, geçici bir git worktree içinde izole kopyada çalışarak ana çalışma dizinine dokunmuyor ve proje ya da kullanıcı düzeyinde kalıcı bir Memory klasörü tutabiliyor.

Sınır ise büyük ölçüde aynı: subagent'lar sonucu çağırana döner ve koordinasyon ana Agent'tan geçer. Bir subagent'ın bulgusu diğerinin işini değiştiriyorsa, bunu yalnızca ana ajan fark edip yeni görev verebilir. Araç kısıtlaması da önemli; yalnızca okuma yapan bir inceleme subagent'ına dosya yazma izni vermek gereksiz risktir.

Ajan takımları bir adım öteye gidiyor. Claude Code'un Şubat 2026'da deneysel olarak sunduğu ve Ekim 2026'da hâlâ deneysel olan agent teams özelliğinde lider Agent takımı kurar, görevleri tanımlar ve sonuçları birleştirir. Teammate'ler her biri kendi bağlamına sahip bağımsız Claude Code örnekleri. Aralarında bağımlılık takibi olan ortak bir görev listesi ve birbirlerine doğrudan ya da toplu mesaj atabildikleri bir posta kutusu var. Özellik CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ortam değişkeniyle açılıyor; TeammateIdle, TaskCreated ve TaskCompleted hook'larıyla kalite kapıları tanımlanabiliyor.

Subagent'tan temel farkı, teammate'lerin birbirinin bulgusuna doğrudan tepki verebilmesi. Örnek senaryo: bir teammate API istemcisini yeni sürüme taşırken, ikincisi iOS ekranlarını, üçüncüsü testleri günceller; istemci tarafında bir alan adı değişince ilk teammate diğerlerine mesaj atar.

Resmî dokümantasyonun saydığı sınırlar: teammate'ler kendi takımlarını kuramıyor, session başına tek takım var, /resume ve /rewind süreç içi teammate'leri geri getirmiyor, görev durumu gecikebiliyor ve aynı dosyayı birden fazla teammate'in düzenlemesi üzerine yazma üretiyor. Kesin sıralı işlerde ya da küçük görevlerde takım kurmak, kazançtan çok koordinasyon gürültüsü getirir.

Her basamak daha fazla token harcar, çünkü her ajan kendi bağlamını baştan doldurur. Anthropic'in Haziran 2025'te yayımladığı çok ajanlı araştırma sistemi yazısı bunu açıkça ortaya koyuyor (2025 verisi): çok ajanlı yapı, şirketin iç değerlendirmesinde tek ajanlı yapıyı yüzde 90,2 farkla geçti ama sohbet kullanımına göre yaklaşık 15 kat token harcadı. Claude Code'un güncel maliyet dokümantasyonu da plan modunda çalışan teammate'lerin standart session'a göre yaklaşık 7 kat token harcadığını belirtiyor. Yazının vardığı sonuç da önemli: bu yapı, görevin değeri maliyeti karşılayacak kadar yüksek ve iş paralelleşebilir olduğunda mantıklı.

Basit bir karar sırası öneriyorum. Görev tek bir bağlama sığıyor ve sıralıysa, tek ajan ve iyi yazılmış skill'ler yeter. Görev çok okuma gerektiriyor ama sonuç kısa bir özetse, subagent kullanın. Görev gerçekten paralel, bağımsız parçalara bölünüyor ve parçalar arasında bilgi akışı gerekiyorsa, ajan takımı düşünün; o zaman da küçük başlayın; resmî dokümantasyon çoğu iş akışı için 3-5 teammate öneriyor ve üç odaklı teammate'in beş dağınık teammate'ten iyi çalıştığını vurguluyor.

Anti-pattern: “daha çok ajan daha iyi sonuç” varsayımıyla her görevi takıma dönüştürmek. Sonuç çoğu zaman aynı dosya üzerinde çakışan değişiklikler ve şişmiş bir fatura olur.

Mobil geliştirmede ajanların en net değer ürettiği yerler tekrar eden, kuralları belli işler: lokalizasyon dosyalarını senkronize etmek, iOS ve Android'de aynı analytics olayının tutarlılığını denetlemek, crash raporlarını sınıflandırmak, mağaza metinlerini hazırlamak. Bunların her biri iyi bir skill adayı. Xcode 27'nin plug-in'lerle özel skill'leri, MCP tool'larını ve Agent Client Protocol uyumlu Agent'ları desteklemesi, Android CLI'ın Ekim 2026'da Play politika denetimi, R8 analizi ve Wear Compose gibi konularda 20'den fazla resmî skill yayımlaması, bu paketlerin artık platform sahiplerince de dağıtıldığını gösteriyor.

Koruma tarafında üç kural öneririm. Birincisi, skill'leri repo içinde sürümleyin ve kod incelemesinden geçirin; bir skill, ekibin ajanlara verdiği yazılı talimattır. İkincisi, imzalama sertifikaları, mağaza API anahtarları ve üretim veritabanı erişimi hiçbir subagent ya da teammate'in araç setinde olmasın. Üçüncüsü, takım çıktısını insan incelemesi olmadan birleştirmeyin; ajanların birbirini onaylaması bir doğrulama değildir.

Ölçü olarak, bir skill'in ekibe kazandırdığı süreyi haftalık takip etmek basit ama etkili: tekrar eden bir işin süresi düşmüyorsa skill yeniden yazılmalı ya da silinmeli.