Bir skill uzun bir prompt değildir

Prompt tek bir isteği açıklar. Skill ise bir istek sınıfının tanımlı koşullarda tekrarlanabilir, doğrulanabilir ve güvenli biçimde nasıl işlendiğini açıklar.

Dil modeli bir görevi iyi çözdüğünde başarılı promptu saklamak doğal görünür. Her istisna yeni metin getirir: format kuralı, kaynak, örnek, tool ipucu, hata yönetimi ve özel durum. Sonunda her şeyi bilmesi beklenen dev bir evrensel prompt oluşur.

Bu ayrıntılı görünür; fakat mimari olarak zayıftır. Uzun talimatlar kullanıcı verisiyle bağlam için yarışır. Önemli kurallar ayrıntılar içinde kaybolur. Eski bilgi görünmeden kalır. Global proje metni, hedeflemediği görevleri de sınırlar. Yararlı rehber gizli teknik borca dönüşür.

Skill bu sorunu daha çok metinle değil, doğru ayrımla çözer.

Prompt, proje kuralı, resource, tool ve skill farklıdır

Prompt mevcut amacı söyler. Proje kuralı klasör yapısı, kalite seviyesi veya yasak eylem gibi ortak konvansiyonları tanımlar. Resource bilgi veya veri sağlar. Tool işlev yürütür. Skill bunları yeniden kullanılabilir prosedürde birleştirir.

Fiyat listesi çekirdek talimatta değil, güncellenebilir veri kaynağında durmalıdır. Parser, prompt içindeki pseudo-code değil test edilmiş script olmalıdır. Marka renkleri asset veya stil referansına aittir. Bileşenler yalnız ihtiyaç halinde yüklendiği için kullanıcı isteği küçük kalır.

Açık Agent Skills spesifikasyonu bunu somutlaştırır: skill, SKILL.md içeren klasördür; isteğe bağlı scripts/, references/ ve assets/ bulunur. Dosya biçimi yalnız kaptır. Kalite, parçaların birlikte kurduğu sözleşmeden doğar.

Açıklama bir router'dır

Agent skill'i kullanmadan önce uygunluğunu anlamalıdır. Ad ve açıklama reklam metni değil, routing arayüzüdür. İyi açıklama skill'in hangi sorunu çözdüğünü, ne zaman etkinleşeceğini ve ne zaman etkinleşmemesi gerektiğini söyler.

Çok geniş açıklama yanlış aktivasyon yaratır. „Belgelere yardım eder“ tüm belge skill'leriyle yarışır. Çok dar açıklama varyantları kaçırır. Gözlenebilir sınır daha iyidir: „Çok dilli DOCX çalışma kâğıtları oluşturur, her sayfayı render eder, layout ve erişilebilirliği denetler; spreadsheet veya sunum için kullanılmaz.“

Routing test edilir. Pozitif istek, zor sınır ve açık negatif örnek gerekir. İki skill aynı isteği sahiplenirse öncelik, kompozisyon veya soru mekanizması kullanılmalıdır. Sessiz rastgele seçim sağlam değildir.

Progressive disclosure bağlamı korur

Agent her başlangıçta bütün skill talimatlarını, referanslarını ve script'lerini yüklemek zorunda değildir. Agent Skills spesifikasyonu üç düzey önerir: keşif için metadata, aktivasyonda çekirdek talimat, gerektiğinde destek dosyası.

Progressive disclosure yalnız token tasarrufu değildir; etkileşimi azaltır. Hukuki inceleme akışı görüntü işini gereksiz yere etkilemez. Nadir API referansı mevcut kullanıcı girdisini dışarı itmez. Ayrıntı görev istediğinde erişilebilir kalır.

Çekirdek talimat bütün el kitabını kopyalamak yerine yönlendirmelidir. Sıra, seçim kuralı, kalite gate'i ve referans yollarını tanımlar. Uzun tablo, alan bilgisi, şablon ve örnek korpus ayrı tutulur. Her referans odaklı ve doğrudan erişilebilir olmalıdır.

Skill bir iş sözleşmesi ister

Üretim skill'i en az dokuz soruyu yanıtlar:

1 · Trigger: Hangi amaç ve girdi etkinleştirir?

2 · Önkoşul: Hangi dosya, yetki, program veya veri gerekir?

3 · Prosedür: Adımlar hangi sırayla çalışır?

4 · Karar: Model nerede yargılar, deterministik kural nerede geçerlidir?

5 · Tool: Hangi işlev hangi kapsamda kullanılabilir?

6 · Output: Hangi dosya, alan, format ve kalite beklenir?

7 · Doğrulama: Bitirmeden hangi testler geçmelidir?

8 · Hata: Ne zaman retry, rollback, eskalasyon veya stop yapılır?

9 · Sınır: Skill açıkça ne yapmamalıdır?

Bu sözleşme örtük deneyimi sınanabilir yapar. „İyi belge oluştur“ yerine dosya türü, dil, uzunluk, kaynak kuralı, render kontrolü, izinli tool ve kabul kriteri yazılır. Birden çok çözümün yararlı olduğu yerde esneklik; güvenlik sınırı ve output şemasında istikrar korunur.

Prosedürel bilgi değişken olgudan ayrılır

Skill esas olarak prosedürel bilgiyi, yani işin nasıl yapıldığını taşır. Model listesi, fiyat, mevzuat, benchmark ve ürün özelliği sürekli değişir. Çekirdek talimata gömülürse skill görünmeden yaşlanır.

Değişken olgular tarihli referans, database veya doğrulanabilir retrieval içinde tutulur. Her kayıt kaynak, tarih, kapsam ve güncelleme sahibi taşır. Skill verinin nasıl seçileceğini ve kontrol edileceğini açıklar; saklanan bilginin sonsuza dek güncel olduğunu varsaymaz.

Bu durum model routing için kritiktir. „Analiz için X, extraction için Y kullan“ hızla eskir. Context kapasitesi, tool desteği, gecikme, gizlilik, maliyet ve ölçülmüş kalite içeren yetenek matrisi daha sağlamdır. Router güncel değerlendirmeyi kullanır ve kanıt yetersizse güvenli fallback'e döner.

Determinizmi script taşır

Her adım doğal dilde kalmamalıdır. Dosya adı ve şema doğrulama, hash hesaplama, tablo genişliği ayarlama ve test çalıştırma deterministik işlemlerdir. Script bunları tekrar üretilebilir biçimde yapar ve açık hata döndürür.

Model adımın ne zaman gerektiğini ve sonucu nasıl yorumlayacağını belirler. Script mekanik işlemi garanti eder. Bu ayrım uydurmayı azaltır ve çalıştırmaları karşılaştırılabilir yapar.

Script de mühendislik ister: belgelenmiş bağımlılık, sınırlı girdi, anlaşılır hata, idempotence, test ve güvenli varsayılan. Skill rastgele kod çalıştırma izni değildir. Yürütülebilir dosya saldırı yüzeyini büyütür ve yazılım gibi incelenmelidir.

Tool yetkisini runtime kontrol eder

Skill ihtiyaç duyduğu tool'u belirtebilir; fakat kendine yetki veremez. Hangi işlevin açık olduğunu, hangi veriye eriştiğini ve ne zaman insan onayı gerektiğini host belirler.

MCP resource, prompt ve executable tool'u ayırır. Tool rehberi girdi doğrulama, erişim kontrolü, rate limiting, çıktı denetimi, timeout ve audit log ister. Hassas eylem görünür ve onaylanabilir olmalıdır. Bunlar skill içindeki iyi niyet cümlesi değil runtime enforcement konusudur.

Asgari yetki uygulanır. Araştırma skill'i okuma ister, silme değil. Belge skill'i sınırlı output klasörü ister, tüm filesystem değil. Deployment skill'i önce preview üretir, yayın yetkisini onaydan sonra alır. Model, prompt veya kaynak manipüle edilse bile etki alanı sınırlı kalır.

Skill yazılım tedarik zinciri öğesidir

Üçüncü taraf skill talimat, script ve bağımlılık getirir. Masum açıklama gerçek davranıştan farklı olabilir. Referans dolaylı prompt injection, script veri gönderme veya dosya değiştirme içerebilir. Kurulum bir güven kararıdır.

Köken, lisans, dosya içeriği, ağ erişimi, bağımlılık, tool gereksinimi ve değişiklik geçmişi incelenir. Sürüm sabitlenir; hash veya imzalı release bütünlüğü destekleyebilir. Güncelleme doğrudan production'a girmez. Kritik skill'in owner'ı, review zorunluluğu ve rollback yolu olur.

OWASP Excessive Agency riskini, LLM sisteminin fazla işlev, yetki veya özerklik alması olarak ele alır. İyi yazılmış skill bu riski yalnız runtime gerçekten sınırlıysa azaltır. İyi metin sandbox değildir.

Kalite uzunluktan değil evaluation'dan gelir

Skill görevlerle değerlendirilir. Test kümesi normal vaka, sınır, eksik girdi, çelişkili kaynak, geçersiz format, tool hatası ve saldırı içerir. Aktivasyon, sonuç kalitesi, kural takibi, tool seçimi, maliyet, süre ve güvenli hata ölçülür.

Katmanlar ayrılır. Routing evaluation doğru skill'i; process evaluation sıra ve tool kullanımını; artifact evaluation sonucu; security evaluation yetki sınırı ve manipüle girdiyi test eder. Regression test, değişikliğin önceki yeteneği bozmadığını doğrular.

Uzun skill öncelikleri belirsizleştiriyorsa kısa skill'den kötü olabilir. Kısa skill hata durumunu saklıyorsa yetersizdir. Ölçüt satır sayısı değil, sözleşmedeki duruma gerçek koşullarda ne kadar güvenilir ulaşıldığıdır.

Versioning öğrenmeyi kontrollü yapar

Skill tool, veri ve gereksinimle değişir. Her release changelog, uyumlu runtime, bilinen sınır ve bağlı evaluation sonucu taşımalıdır. Büyük değişiklik önce kayıtlı vakalarda çalışır. Güvenlik ve saklama izin veriyorsa eski sürüm tekrar üretilebilir kalır.

Her hata raporu çekirdek talimatın sonuna yeni uyarı olarak eklenmemelidir. Hata katmanı bulunur: yanlış trigger, eksik referans, belirsiz kural, bozuk tool, zayıf test veya yanlış yetki. En küçük uygun katman değiştirilir. Çekirdek talimat tarihsel istisnalar mezarlığına dönüşmez.

Skill, başka agent veya ekip onu anlayabildiğinde, çalıştırabildiğinde, doğrulayabildiğinde ve güvenle reddedebildiğinde olgundur. Tek başarılı promptu saklamaz; çalışma biçimini taşınabilir yapar.

Çalışma kâğıdı: Skill sözleşmesi kur

Tekrarlanan görev seç ve skill'i sekiz adımda tasarla.

1. Scope belirle. Amaç, pozitif trigger, sınır ve non-goal yaz.

2. Girdi tanımla. Zorunlu veri, format, yetki ve doğrulamayı belirt.

3. Süreci parçala. Model yargısı, deterministik script ve insan onayını ayır.

4. Resource düzenle. Değişken olgu, referans ve asset'i çekirdek talimattan çıkar.

5. Tool sınırla. Her adıma yalnız gerekli en küçük işlev ve erişimi ver.

6. Output sözleşmesi yaz. Artifact, şema, kalite ve bitiş durumunu tanımla.

7. Hata yolu kur. Retry, stop, rollback, abstention ve eskalasyonu belirt.

8. Evaluation oluştur. Pozitif, negatif, sınır, hata ve saldırı vakaları topla.

İndirilecek tüm materyaller — konu özeti ve çalışma kâğıdı:

Kapsam: „Skill" terimi platformlara göre farklı uygulanır. Bu yazı açık Agent Skills dosya modelini somut referans olarak kullanır ve yeniden kullanılabilir prosedürel iş modüllerinin genel mimarisini ele alır. Bir skill model kalitesini veya güvenli yürütmeyi garanti etmez; runtime, yetki sistemi ve host ayrı kontrol katmanlarıdır.