Agent Skill Nedir? İşe Yarayan Yetenek Nasıl Yazılır?

Yapay zekâ ajanlarına yetenek yüklemek moda oldu ve ortalık yüzlerce "skill" ile doldu. Kötü yazılmış bir skill ya hiçbir şey değiştirmiyor ya da bağlamı şişirip işi kötüleştiriyor. Bu yazıda gerçekten fark yaratan yetenek kalıplarını, iyi bir skill'in nasıl yazıldığını ve kurmadan önce yapmanız gereken güvenlik kontrolünü anlatıyorum.

Bu yazı, Jack Roberts'ın This New Hermes Agent Skill is Insane videosunu özetleyip genişletiyor. Videoda Roberts, Hermes Agent için yüzlerce skill denediğini ve çoğunu işe yaramaz bulduğunu söyleyip öne çıkan on üç tanesini tanıtıyor. Buradaki kalıplar o listeden seçildi; test yöntemi ve skill ile kural dosyası ayrımı bu yazının eklemesi.

Hermes Agent'ı hiç kurmadıysanız, önce Hermes Agent nedir ve nasıl kurulur rehberine bakabilirsiniz.

Agent skill nedir?

Agent skill, bir yapay zekâ ajanına belirli bir işi nasıl yapacağını öğreten talimat paketi. Modelin kendisini değiştirmiyor; ihtiyaç duyulduğunda devreye giren bir yönerge dosyası olarak çalışıyor. Model ile onu çalıştıran araç arasındaki bu ayrımı harness nedir: model ile kodlama aracı arasındaki fark yazısında ayrıntılandırdım.

Faydası şurada: model her seferinde tahmin etmek yerine yazılı bir yordamı takip ediyor. Bir işi ilk defa iyi yaptırdığınızda o yordamı skill hâline getiriyorsunuz ve sonraki her seferinde aynı kaliteyi alıyorsunuz.

Ajanı çok zeki ama işi yeni öğrenen bir stajyer gibi düşünün. Zekâsı yeterli; eksik olan, sizin nasıl çalıştığınızı bilmesi. Skill tam olarak bu boşluğu dolduruyor.

Bir skill'in anatomisi

İyi bir yetenek dört parçadan oluşuyor ve her parçanın ayrı bir işi var:

• Ad: ne yaptığını söyleyen, kısa. Ajan bunu listede görüyor.
• Tetikleyici açıklama: yeteneğin ne zaman devreye gireceğini anlatan bir iki cümle. Uygulamada en belirleyici parça bu.
• Yordam: işin adımları. Kural listesi biçiminde, gerekçe anlatısı olmadan.
• Referanslar: uzun tablolar, örnekler, şablonlar. Ana dosyaya gömülmez, ayrı tutulup gerektiğinde okunur.

İkinci maddeyi ayrıca vurgulayayım, çünkü çoğu işe yaramayan skill burada başarısız oluyor.

Tetikleyici açıklama nasıl yazılır?

Ajan, hangi yeteneği çağıracağına açıklamaya bakarak karar veriyor. Yordam ne kadar iyi olursa olsun, açıklama belirsizse yetenek hiç devreye girmiyor ya da yanlış yerde giriyor.

İki örnek:

• Zayıf: "Yazma konusunda yardımcı olur."
• İyi: "Blog yazısı taslağı, başlık ve meta açıklama üretirken kullanılır. Var olan bir metni düzenlerken kullanılmaz."

İkincisi hem kapsamı hem de kapsam dışını söylüyor. Negatif sınır yazmak, yanlış tetiklenmeyi engelleyen en ucuz yöntem.

Kurmadan önce: güvenlik kontrolü

Bu kısım atlanıyor ve atlanmamalı. Bir skill, ajanınıza talimat veren metin demek. İnternetten indirdiğiniz bir metnin ajanınıza ne söyleyeceğini okumadan kabul ediyorsanız, ciddi bir açık bırakıyorsunuz.

Videodaki ilk skill tam olarak bu işi yapıyor: yeni bir skill'i kurmadan önce tarıyor, alternatiflerini araştırıyor ve sonuca göre izin veriyor, soruyor ya da karantinaya alıyor. Aynı kontrolü elle de yapabilirsiniz. Kurmadan önce en az şunları yapın:

• Prompt injection taraması. Skill'in içinde ajanı asıl görevinden saptıran, veri dışarı sızdırmaya yönlendiren ya da izin isteme adımlarını atlatan yönerge var mı?
• Ne talep ediyor? Dosya erişimi, ağ isteği, dış servis bağlantısı: hangisini neden istiyor?
• Alternatifine bakın. Aynı işi yapan daha basit ya da daha iyi bakılan bir skill var mı?
• Şüpheliyse karantinaya alın. Doğrudan ana ortamınıza değil, ayrı bir çalışma alanında deneyin.

Kısaca: skill'i bir kütüphane bağımlılığı gibi görün. Kod tabanınıza rastgele bir paket eklemiyorsanız, ajanınıza da rastgele talimat eklemeyin.

Gerçekten işe yarayan yetenek kalıpları

Yüzlercesi arasında kalıcı değer taşıyan birkaç kalıp var. Hepsinin ortak noktası, modelin doğal zayıflığını kapatmaları. Aşağıdaki üç kalıp, videoda Matt Pocock'un açık kaynak skill koleksiyonundan (grill-me, handoff ve teach) örneklerle gösteriliyor. Aynı yaklaşım tasarım işlerinde de geçerli; onu yapay zekâ ile tasarımın yedi seviyesi yazısında ayrıca anlattım.

Netleştirici sorgulama

Ajanların en pahalı hatası, eksik anlaşılmış bir isteği hızlıca yapmak. Bu kalıp tam tersini yaptırıyor: iş başlamadan önce ajan size soru soruyor. Kim için, hangi kısıtla, başarı ölçütü ne?

Basit ama etkisi büyük. "Yeni bir iş fikri düşünüyorum, beni bunun üzerine sorgula" dediğinizde aldığınız sorular, çoğu zaman fikrin zayıf yerini siz farkına varmadan ortaya çıkarıyor.

Devir teslim belgesi

Bir ajandan diğerine ya da bir oturumdan sonrakine geçerken her şeyi baştan anlatmak zorunda kalıyorsunuz. Bu kalıp, çalışmayı yapılandırılmış bir belgeye döküyor: mevcut durum, alınan kararlar, sonraki adımlar, önerilen araçlar ve dikkat edilmesi gereken hassas bilgiler.

Uzun süren işlerde bunun değeri çok yüksek. Bir haftalık çalışmanın bağlamını iki paragrafta özetlemek yerine, gerçekten devredilebilir bir belge elde ediyorsunuz.

Öğretme kipi

Çoğu kişi ajana soru sorup tek paragraflık cevap alıyor ve orada bırakıyor. Bu kalıp etkileşimi derse çeviriyor: önce hedefi belirliyor (bunu neden öğreniyorsun?), sonra tek seferde tek konu anlatıyor, sonunda da neyin akılda kaldığını sınıyor.

Fark şurada: hedefe bağlanmayan bilgi unutuluyor. "Instagram'da nasıl büyürüm" sorusuna genel bir liste yerine, sizin amacınıza göre kurgulanmış bir ders almak bambaşka bir sonuç veriyor.

İyi bir skill nasıl yazılır?

En değerli skill, başka skill'leri iyi yazmanızı sağlayan kurallar bütünü. Videoda da skill yazan bir skill (skill creator) tanıtılıyor; dayandığı ilkeler şöyle özetlenebilir:

• Tek iş, tek skill. Bir yeteneğin kapsamı büyüdükçe ne zaman devreye gireceği belirsizleşiyor ve model onu yanlış yerde çağırıyor.
• Açıklamayı kısaltın. Bir skill'in tanımı her turda bağlamda taşınıyor. Gereksiz her kelimenin sürekli bir maliyeti var.
• Ayrıntıyı talep üzerine yükleyin. Uzun referansları ana dosyaya gömmek yerine ayrı dosyalara koyup yalnızca gerektiğinde okutun.
• Kural yazın, hikâye değil. "Şunu yapmalısın" listesi, paragraflarca gerekçeden daha iyi çalışıyor.
• Direktif olun. Modeller olasılıksaldır; bazen doğru yeteneği kendiliğinden çağırmaz. Kritik işlerde hangi skill'i kullanacağını açıkça söyleyin.

Son madde sık yanlış anlaşılıyor. Ajan çoğu zaman doğru yeteneği kendi buluyor, ama "çoğu zaman" üretim işi için yeterli bir garanti değil.

Skill'i nasıl test edersiniz?

Yazdığınız yeteneği kurup "çalışıyor galiba" demek yeterli değil. Üç testi geçmesi gerekiyor:

1. Tetikleme testi. Yeteneği adıyla çağırmadan, sadece işi tarif ederek isteyin. Devreye giriyor mu? Girmiyorsa açıklama zayıf.
2. Yanlış tetikleme testi. Yeteneğin kapsamı dışında ama benzer görünen bir iş isteyin. Devreye girmemeli. Giriyorsa kapsam çok geniş.
3. Tekrar testi. Aynı isteği üç kez, ayrı oturumlarda çalıştırın. Üç sonuç birbirine yakın mı? Değilse yordam yeterince belirleyici değil.

Üçüncü test en çok bilgi vereni. Bir yeteneğin varlık sebebi zaten tekrarlanabilirlik; üç farklı sonuç veriyorsa o yetenek işini yapmıyor demektir. Aynı tutarlılık derdinin tasarım tarafındaki karşılığını eleştirmen döngüsü yazısında anlatmıştım.

Test sırasında modelin ne yaptığını değil, neyi neden yaptığını izleyin. Doğru sonuca yanlış yoldan varan bir yetenek, girdi biraz değiştiğinde kırılıyor.

Skill şişmesi: asıl tehlike

Zamanla onlarca yetenek biriktiriyorsunuz ve bir noktadan sonra sistem yavaşlıyor, ajan yanlış yeteneği çağırmaya başlıyor. Buna skill şişmesi (skill bloat) deniyor.

Önlemek için iki kural:

1. Yeni bir skill yazmadan önce sorun: var olanı genişletmek mi daha doğru, yenisini yazmak mı? Çoğu durumda genişletmek daha doğru.
2. Düzenli budayın. Üç aydır bir kez bile devreye girmemiş yeteneği silin. Silmek geri alınabilir, kirlilik geri alınamaz.

Skill mi, kural dosyası mı, düz prompt mu?

Üçü karıştırılıyor ve yanlış olanı seçmek zaman kaybettiriyor. Ayrım şöyle:

• Düz prompt: iş bir kere yapılacaksa. Yordamı yazmak, işi yapmaktan uzun sürüyorsa orada durun.
• Kural dosyası (projenin kökünde duran, her oturumda geçerli olan yönergeler): kısıt her zaman geçerliyse. Kod stiliniz, dilinize dair tercihler, dokunulmaması gereken dizinler. Bunlar tetiklenmez, sürekli açıktır.
• Skill: iş tekrar ediyorsa ama her zaman geçerli değilse. Yalnızca o iş geldiğinde devreye girmesi gereken yordamlar.

En sık görülen hata, sürekli geçerli olması gereken bir kuralı skill hâline getirmek. O kural tetiklenmediği sürece yok sayılıyor ve neden uygulanmadığını anlamıyorsunuz.

Tersi de olur: her oturumda taşınması gereken uzun bir yordam kural dosyasına konur ve hiç kullanılmadığı turlarda bile bağlamı işgal eder.

Ajanı sürekli çalışır tutmak

Ajanın en güçlü özellikleri, siz başında değilken de çalışabilmesinden geliyor: gelen bir mesaja yanıt vermek, zamanlanmış bir işi yürütmek, uzun bir görevi arka planda tamamlamak.

Dizüstü bilgisayarınızı kapattığınızda bunların hepsi duruyor. Bu yüzden gerçekten sürekli çalışan bir kurulum istiyorsanız ajanı kendi makineniz yerine sürekli açık bir sunucuda çalıştırmanız gerekiyor. Videoda bu kurulum küçük bir sanal sunucu (VPS) üzerinde gösteriliyor ve bu ölçekte bir sunucunun yettiği belirtiliyor.

Bir uyarı: sürekli çalışan bir ajana API anahtarı ve servis erişimi veriyorsunuz. Harcama limiti tanımlayın, erişimleri dar tutun ve ne yaptığını görebileceğiniz bir kayıt tutun.

Özetle

Skill kurmak bir koleksiyon işi değil. Değer, sayıda değil; tekrar eden işlerinizi yazılı yordama çevirmekte, kurduğunuz her yeteneği okumuş olmakta ve işini görmeyeni silmekte. Tekrar eden üretim işlerini yordama çevirmenin somut bir örneği için veri görseli ve ikon üretimini otomatikleştirme yazısına bakabilirsiniz. Az sayıda iyi yazılmış yetenek, ajanınızı gerçekten farklı bir seviyeye taşıyor.

Sık Sorulan Sorular

Skill ile prompt arasındaki fark ne?

Prompt tek seferlik bir istektir; skill, tekrar eden bir işin yazılı yordamıdır. Aynı prompt'u üçüncü kez yazıyorsanız, orası skill'e dönüştürülecek yerdir.

Kaç tane skill kurmalıyım?

Sayı hedef değil. Genel kural olarak az sayıda ve iyi tanımlanmış yetenek, çok sayıda ve bulanık olandan daha iyi çalışır; kullanılmayanları düzenli olarak budayın.

Skill'i kendim mi yazmalıyım, hazır mı kurmalıyım?

Hazır olanlarla başlayıp kendi işinize göre değiştirin. Ama içeriğini okumadan hiçbirini kurmayın; bu hem güvenlik hem de kalite meselesi.

Skill yazmak için kod bilmek gerekir mi?

Genellikle hayır. Çoğu yetenek düz metin talimattan ibaret. Kod bilmek, yeteneğin çalıştırdığı adımları doğrulayabilmenizi sağlıyor; bu bir avantaj ama önkoşul değil.

Kaynak

• Jack Roberts, This New Hermes Agent Skill is Insane (YouTube, Ağustos 2026). Güvenlik taraması yapan skill, netleştirici sorgulama, devir teslim belgesi, öğretme kipi, skill yazma ilkeleri ve ajanı sunucuda çalıştırma bu videoya dayanıyor.
• Matt Pocock, mattpocock/skills (GitHub): grill-me, handoff ve teach skill'lerinin kaynağı.