Agent skill nedir? Ajana bir işi bir kez öğretmek

Talimat dosyası ile skill arasındaki fark

Kodlama ajanları, projeyle ilgili kuralları CLAUDE.md ya da AGENTS.md gibi bir dosyadan okuyor (AGENTS.md yazısında anlattık). Bu dosya her oturumda baştan sona okunuyor. Her şeyi oraya yazarsan dosya şişiyor, modelin dikkati dağılıyor ve her mesajda boşa token harcanıyor.

Skill (beceri) bu sorunu çözüyor. Tek bir iş için yazılmış bir klasör: “Bir blog yazısını şöyle yayımla”, “Logoyu şu kaynaklardan bul”, “Animasyonları şu kurallara göre yaz”. Ajan ona sadece ihtiyaç duyduğunda bakıyor.

Bir skill neye benzer?

En basit hâliyle bir klasör ve içinde bir SKILL.md dosyası:

---
name: ipucu-yayimla
description: Kısa bir sosyal medya paylaşımını sitedeki ipuçları sayfasına çevirir. Kullanıcı "ipucu ekle" dediğinde kullan.
---

1. Paylaşımın metnini ve bağlantılarını topla.
2. content/ipuclari/ altında yeni bir dosya oluştur...

Üstteki name ve description zorunlu. Altında serbest Markdown talimatlar var. Klasöre scripts/ (çalıştırılacak betikler), references/ (ayrıntılı belgeler) ve assets/ (şablonlar) da ekleyebiliyorsun.

Sırrı: Kademeli yükleme

Skill’leri ucuz yapan şey, ajanın onları üç adımda okuması. Standart buna progressive disclosure (kademeli açılım) diyor:

1. Başlangıçta ajan her skill’in sadece adını ve açıklamasını yüklüyor. Skill başına yaklaşık 100 token.
2. İş eşleşince SKILL.md’nin tamamını okuyor.
3. Gerekirse ek dosyalara ya da betiklere bakıyor.

Bu yüzden onlarca skill kurulu olsa bile bağlam (context) dolmuyor. Ama bir şartı var: Ajan skill’i açıklamaya bakarak seçiyor. Açıklama “PDF’lerle ilgili yardım” gibi belirsizse skill hiç devreye girmeyebilir. İyi bir açıklama hem ne yaptığını hem de ne zaman kullanılacağını söylüyor.

Syntax ekibi ne kullanıyor?

Syntax’ın 1003. bölümünde Wes Bos ve Scott Tolinski kendi becerilerini anlattı. Birkaç örnek:

• İpucu skill’i (Wes): Kısa paylaşımları sitesindeki bir ipucu sayfasına çeviriyor. Wes’e göre eskiden yazdığı ve her değişiklikte bozulan bir betiğin yerini aldı.
• HTML skill’i (Scott): Ajanın sık yaptığı hataları listeliyor: liste olmayan şeyler için liste kullanmak, bağlantı gibi davranan butonlar, anlamsız div yığınları.
• CSS hareket sistemi (Scott): Animasyonlar için temel kurallar ve bir kontrol listesi. Hareketi azaltmak isteyen kullanıcılar ve performans dahil.
• Logo bulma (Wes): Ajan bir logoyu uydurmak yerine bilinen SVG kaynaklarından indiriyor.
• Video becerileri: Remotion gibi kodla video üreten araçların kendi skill’leri. Bunu Remotion yazısında ayrıca anlattık.

Wes’in bir pratik önerisi de var: Bir sohbette ajanla bir işi sonunda doğru yaptırdıysan, o sohbeti bir skill’e dönüştür.

Dikkat edilecekler

• Her skill’i kurma. Scott’a göre her skill bakım ister ve istemediğin şeyler yapabilir.
• Zevk kopyalanmıyor. “Güzel site yap” türü tasarım becerileri herkesin sitesini birbirine benzetebiliyor.
• Lint işi lint’e. Her yeni sekme bağlantısına aynı özniteliği eklemek gibi kurallar bir linter’da daha güvenilir.
• Kodu okumadan kurma. Bir skill çalıştırılabilir betikler içerebilir. Başkasının skill’ini kurmadan önce içine bak.
• Para vermeden önce düşün. Wes ve Scott, skill için para istenmesine şüpheyle bakıyor. Bölümde anlatılanların çoğu GitHub’da ücretsiz duruyor.

Zararlı skill’lerin talimatlarını gözden nasıl sakladığını gizli talimatlar yazısında anlattık. Yapay zekâya yazdırılan skill’lerin gerçekten işe yarayıp yaramadığını bağlam taşıma yazısında konuştuk.

Sonra ne oldu?

Format, Anthropic’in geliştirip açık standart olarak yayımladığı Agent Skills. Ekim 2026 itibarıyla Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI ve OpenCode dahil onlarca ajan destekliyor. Vercel’in skills.sh dizini ve npx skills add komutu, skill bulup kurmanın yaygın yolu oldu. Skill’ler, MCP sunucularıyla birlikte Agent Plugins paketlerinin içine de giriyor.

Düşün

• Ajana her hafta aynı şekilde anlattığın bir iş var mı? Onu bir skill’e çevirsen açıklaması ne olurdu?
• Talimat dosyandaki hangi bölüm aslında sadece bazı işlerde gerekiyor ve bir skill’e taşınabilir?

Kendi cümlelerimizle yazılmış bir özettir, çeviri değildir. Tüm kaynaklar yukarıda.