Ajan becerileri, bir AI ajanına belirli bir görevde yol gösteren, yeniden kullanılabilir talimat paketleri ile isteğe bağlı betikler, başvuru materyalleri ve şablonlardan oluşur. Açık Agent Skills biçiminde her paket, SKILL.md dosyası etrafında oluşturulmuş bir klasördür. Uyumlu ajanlar, tüm yordamları aynı anda konuşmada tutmak yerine becerileri keşfedebilir ve gerektiğinde talimatlarını yükleyebilir. Bu kılavuz biçimi açıklar, uygulamalı örnekler sunar ve ilk becerinizi oluşturup test etme sürecinde size rehberlik eder.
Ajan becerileri nedir?
Agent Skills, uzmanlaşmış bilgileri ve iş akışlarını paketlemeye yönelik hafif, açık bir biçimdir. Bir beceri, adını ve amacını açıklayan YAML ön bilgilerini içeren bir SKILL.md dosyasının ardından Markdown talimatlarından oluşur. Destekleyici dosyalar betikler, başvuru belgeleri ve şablonlar içerebilir.
“AI becerileri” terimi, insanların AI kullanma yeteneği de dahil olmak üzere çeşitli şeyleri ifade edebilir. Bu kılavuzda ajan becerileri ve AI ajan becerileri, özellikle uyumlu ajanlar için yeniden kullanılabilir SKILL.md paketlerini ifade eder.
Örneğin, toplantı özeti becerisi bir ekibin toplantı tutanaklarında yer alacak bölümleri, kararların nasıl kaydedileceğini ve eksik sorumluların veya son tarihlerin nasıl işaretleneceğini tanımlayabilir. Bu kuralları bir kez kaydeder ve yeni toplantı notlarıyla yeniden kullanırsınız. Beceri ajanın çalışmasına rehberlik eder; temel modeli yeniden eğitmez.
Açık spesifikasyon, ön bilgilerde ad ve açıklama bulunmasını zorunlu kılar. Ad 1-64 karakter uzunluğunda olmalı, küçük harfler, rakamlar ve kısa çizgiler kullanmalı ve dizin adıyla eşleşmelidir; kısa çizgiyle başlayamaz veya bitemez ya da art arda kısa çizgiler içeremez. Açıklama 1-1.024 karakter uzunluğunda olmalı ve hem görevi hem de becerinin ne zaman kullanılacağını açıklamalıdır.
Ajan becerileri nasıl çalışır?
Biçim, aşamalı bilgi sunumu için tasarlanmıştır: ajanlar, tam talimatlarını yüklemeden önce bir beceriyi seçmek için yeterli bilgi edinir.
Keşif. Ajan, kullanılabilir becerilerin adlarını ve açıklamalarını alır. Bu meta veriler de bağlam kullanır, ancak tüm yordamlar en baştan yüklenmez.
Etkinleştirme. Ajan ilgili bir beceri seçtiğinde SKILL.md dosyasını okur. Bazı araçlar ayrıca bir beceriyi adıyla çağırmanıza veya otomatik seçimi devre dışı bırakmanıza olanak tanır.
Yürütme. Ajan yordamı izler; gerektiğinde ve izin verildiğinde destekleyici başvuru materyallerini okur veya betikleri çalıştırır.
Bu, etkin olmayan yordamların kullandığı bağlamı azaltır. Gerçek bağlam kullanımı, açıklamaların sayısına ve uzunluğuna, etkin becerilere ve yüklenen kaynaklara bağlıdır. Açık açıklamalar seçime yardımcı olur, ancak etkinleştirme ve çıktı kalitesinin yine de test edilmesi gerekir.
Ajan becerileri, promptlar, MCP ve araçlar
AI araçlarıyla ilgili terminoloji kalabalıktır ve "beceri" buna benzer görünen çeşitli kavramların yanında yer alır. Aralarındaki farklar şöyledir:
| Yetenek | Nedir? | Ne zaman etkin olur? | En uygun kullanım alanı |
|---|---|---|---|
| Prompt | Bir konuşmada sağlanan talimatlar; ayrıca kaydedilebilir | Konuşma bağlamında tutulduğu sürece | Tek seferlik talimatlar |
| Her zaman etkin talimatlar (AGENTS.md, QWEN.md gibi) | Proje bilgileri ve kısıtlamaları | Ajanın proje kapsamına ve yükleme kurallarına göre | Proje genelindeki kurallar |
| Ajan becerisi | Sürümlenmiş talimat ve kaynak klasörü | İlgili olduğunda istek üzerine yüklenir | Tekrarlanabilir iş akışları ve prosedürler |
| MCP sunucusu / aracı | Eylemleri ve verileri sunan çalışan bir entegrasyon | Yapılandırıldığında, bağlandığında ve izin verildiğinde | Eylem gerçekleştirme, canlı verilere erişme |
| Alt ajan | Kendi bağlam penceresine sahip ayrı bir çalışan | Başlatıldığında | Yalıtılmış veya paralel çalışma |
Beceriler ve promptlar. Prompt, bir konuşmada talimat verir; beceri ise keşfedilmek veya açıkça çağrılmak üzere yeniden kullanılabilir bir yordamı ve destekleyici kaynakları depolar. Promptlar da kaydedilip yeniden kullanılabilir. Tekrarlanan bir görev; bakımı yapılan bir iş akışı, örnekler, başvuru materyalleri veya betikler gerektirdiğinde beceri yararlı hâle gelir.
Beceriler ve MCP. MCP, bir ajana yetenekler, yani canlı araçlara ve verilere bağlantılar sağlar. Beceri ise ajana bilgi sağlar: bir görevin nasıl iyi gerçekleştirileceği, hangi sırayla yürütüleceği ve hangi doğrulama adımlarının uygulanacağı. İkisi birbirini tamamlar. Kod inceleme becerisi kapsamlı bir incelemenin ne olduğunu tanımlarken, bir GitHub MCP sunucusu ajanın gerçek pull request'i okumasını sağlar.
Beceriler ve proje talimatları. AGENTS.md gibi dosyalar, ajanın yükleme ve kapsam kurallarına tabi proje rehberliği sağlar. Geniş ölçüde uygulanabilir kuralları burada tutun; ilgili olduğunda yüklenmesi gereken göreve özgü yordamlar için ise becerileri kullanın. Kesin davranış araca bağlıdır.
Ajan becerileri neden önemlidir?
Yeniden kullanılabilir uzmanlık: Göreve özgü yöntemleri, kontrol listelerini ve şablonları kaydedin; böylece bunları her seferinde açıklamak zorunda kalmazsınız.
Daha tutarlı yordamlar: Tekrarlanan görevlerde ajanlara aynı adımları ve inceleme ölçütlerini verin. Sonuçların yine de doğrulanması gerekir.
Bağlam verimliliği: Her yordamı sürekli yüklü rehberliğe koymak yerine ayrıntılı talimatları gerektiğinde yükleyin.
Araçlar arası yeniden kullanım: Kullanmadan önce araç erişimini, bağımlılıkları ve platforma özgü alanları kontrol ederek temel SKILL.md biçimini uyumlu ajanlar arasında paylaşın.
Ekip bakımı: Paylaşılan bir iş akışındaki değişikliklerin incelenebilmesi için beceri klasörlerini sürüm kontrolünde tutun.
Hangi AI araçları ajan becerilerini destekliyor?
Ajan becerileri; Claude Code, OpenAI Codex, Cursor, GitHub Copilot ve Kimi Code dahil olmak üzere giderek daha geniş bir AI aracı yelpazesi tarafından desteklenmektedir. Bu araçlar, ajanlara göreve özgü talimatlar, iş akışları ve destekleyici kaynaklar sağlamak için yeniden kullanılabilir beceri paketlerinden yararlanır.
Paylaşılan SKILL.md biçimi, kurulum yolları ve çağırma yöntemleri ürüne göre değişse de becerilerin uyumlu araçlar arasında yeniden kullanılmasını kolaylaştırır. Bir beceri betiklere veya harici araçlara dayanıyorsa, bu bağımlılıkların kullanmayı planladığınız ortamda mevcut olduğunu kontrol edin.
Ajan becerisi örnekleri ve kullanım alanları
Yararlı bir beceri, tekrarlanan bir görevi ekibinize özgü kılan kuralları içerir. Bu örnekler, nelerin paketleneceğini ve sonuçta nelerin kontrol edileceğini gösterir:
| Beceri | Girdi | Yeniden kullanılabilir kurallar | Doğrulanacak çıktı |
|---|---|---|---|
| Toplantı özeti | Toplantı notları veya transkript | Kararları tartışmalardan ayırın; görev sorumlularını ve son tarihleri ekleyin; eksik ayrıntıları işaretleyin | Özet, Kararlar ve Eylem Maddeleri içeren toplantı tutanağı |
| Marka içeriği incelemesi | Bir taslak ve marka yönergeleri | Onaylı terminolojiyi, üslubu, yasaklı ifadeleri ve zorunlu mesajları kontrol edin | Önerilen düzenlemeleri içeren sorun listesi |
| Kod incelemesi | Bir pull request farkı | Hata işlemeyi, testleri, bağımlılık değişikliklerini ve proje kurallarını kontrol edin | Zorunlu düzeltmeleri önerilerden ayıran bir rapor |
| Haftalık rapor | İlerleme notları ve metrikler | Sabit bir raporlama dönemi ve bölümler kullanın; tamamlanan işleri, riskleri ve sonraki adımları birbirinden ayırın | Sağlanan metrikleri koruyan ve eksik verileri işaretleyen bir rapor |
Belge işleme ve tekrarlayan veri analizi de iyi adaylardır, ancak çoğu zaman SKILL.md'nin ötesinde araçlar veya betikler gerektirir. Dar kapsamlı bir iş akışıyla başlayın, çıktılarını doğrulayın ve bağımlılıkları yalnızca görev gerektirdiğinde ekleyin.
Kimi AI ile ajan becerilerini kullanma
Görevinize uygun ortamı seçin. Yukarıdaki oluşturma yöntemleri, doğal dilde hazırlamayı ve yerel, dosya tabanlı bir iş akışını kapsar.
Kimi Code'da ajan becerileri
Kimi Code CLI, proje dizinlerindeki .agents/skills/ ve .kimi-code/skills/ ile kullanıcı dizinlerindeki ~/.agents/skills/ ve ~/.kimi-code/skills/ konumlarında becerileri bulur. Kimi'ye özgü kullanıcı dizini KIMI_CODE_HOME ile değiştirilebilir. Bir beceriyi /skill:<name> ile çağırın veya modelin açıklamasına ve desteklenen tetikleyici alanlarına göre seçmesine izin verin. Otomatik seçim, tek tek beceriler için devre dışı bırakılabilir. Yolları veya platforma özgü alanları yapılandırırken güncel CLI belgelerine bakın.
Kimi'de günlük işler için ajan becerileri
Her şeyi sıfırdan kurmanıza gerek yok. Masaüstünde veya webde Kimi'yi açın, Beceri Mağazası'na göz atın ve tek tıklamayla bir beceri yükleyerek Kimi'de kullanmaya başlayın. Araştırma ve yazımdan kodlama ve veri analizine kadar Kimi Beceri Mağazası, geniş bir görev yelpazesi için beceriler sunar. Kimi'nin masaüstü veya web uygulamasında mağazaya göz atın, tek tıklamayla bir beceri yükleyin ve Kimi'de kullanmaya başlayın.
Kendi ajan becerinizi nasıl oluşturursunuz?
Bir AI aracına iş akışını açıklayarak veya SKILL.md dosyasını kendiniz yazarak bir beceri oluşturabilirsiniz. Toplantı tutanakları gibi tekrarlanan tek bir görev ve kolayca kontrol edebileceğiniz bir çıktıyla başlayın.
Yöntem 1: Kimi ile ajan becerisi oluşturma
Kimi'de, becerileri keşfetmek veya yüklemek için Beceriler panelini açın. Kendi becerinizi oluşturmak için bir prosedür yükleyin ya da beceri oluşturma sohbetinde ne istediğinizi açıklayın. /skill-creator komutunu da kullanabilirsiniz. Güncel erişim noktaları için Kimi'nin Beceriler rehberine bakın.
1. Adım: Kimi'nin Beceri mağazasını açın ve "customize" > "Create with Kimi" seçeneğine tıklayın.
2. Adım: İhtiyacınız olan beceriyi açıklayın.
Kimi'ye görevi, beklenen girdiyi, çıktı yapısını ve eksik bilgilerle ilgili kuralları verin.
Örneğin:
Sonuçta bir kural eksikse Kimi'den o kuralı düzeltmesini isteyin ve testi tekrarlayın. Mevcut bir SOP için hangi bölümlerin talimat, hangilerinin arka plan materyali olduğunu belirtin; pakete eklemeden önce ilgisiz veya hassas içerikleri kaldırın. Beceri oluşturulduğunda, onu hemen Kimi ile kullanabilirsiniz.
Yöntem 2: Ajan becerilerini kendiniz yazma
Bu örnekte yalnızca metin talimatları kullanılır ve ek betik gerekmez. Kurulum ve çağırma işlemlerini göstermek için Kimi Code CLI kullanılır; diğer ajanlar farklı yollar ve komutlar kullanabilir.
1. Adım: Klasörü oluşturun. Kimi Code CLI'da kullanıcı düzeyinde bir beceri için ~/.agents/skills/meeting-summary/ klasörünü oluşturun. Ekiple paylaşılan depo düzeyinde bir beceri için bunun yerine depo kökünün altında .agents/skills/meeting-summary/ kullanın.
2. Adım: SKILL.md dosyasını kaydedin. ~/.agents/skills/meeting-summary/SKILL.md dosyasını oluşturun ve aşağıdakileri yapıştırın. Açıklama görevi tanımlar; gövde ise çıktıyı ve eksik bilgi kurallarını belirler.
3. Adım: Yeni bir oturum başlatın ve çağırın. Dosyayı kaydettikten sonra yeni bir Kimi Code CLI oturumu başlatın. Sohbet girişine şu komutu yazın:
4. Adım: Sonucu kontrol edin. Aşağıdaki, kaydedilmiş bir ürün çalıştırması değil, örnek bir beklenen çıktıdır. İfade biçimi değişebilir; bölümler, karar, sorumlular ve son tarihler beceriye uygun olmalıdır.
5. Adım: Otomatik seçimi ve sınırları test edin. Yeni bir sohbette eğik çizgi komutunu kullanmadan “Bu toplantı notlarını tutanağa dönüştür” isteğinde bulunun ve aynı notları sağlayın. Arayüzün etkinlik kaydından, varsa, ajanın beceriyi yükleyip yüklemediğini ve çıktının kurallarına uyup uymadığını kontrol edin. Ardından “Python'da özyinelemeyi açıkla” gibi ilgisiz bir istek deneyin; meeting-summary becerisi etkin kalmamalıdır. Ayrıca not olmadan çağırın: girdi istemelidir.
Bir ajan becerisi çalışmazsa ne yapmalısınız?
| Belirti | Kontrol edilmesi gerekenler |
|---|---|
| Beceri bulunamıyor | Tarama dizinini, SKILL.md dosya adının tam olarak doğru olduğunu, geçerli YAML frontmatter'ı ve eşleşen klasör/ad bilgisini kontrol edin. Ekledikten sonra yeni bir oturum başlatın. |
| Manuel çağırma çalışıyor, ancak otomatik seçim çalışmıyor | Açıklamayı hedeflenen göreve daha özel hâle getirin. Otomatik çağırmanın devre dışı olup olmadığını kontrol edin; yeni bir konuşmada yeniden deneyin. |
| Beceri, ilgisiz isteklerde etkinleşiyor | Açıklamayı daraltın ve ilgisiz istekleri olumsuz örnekler olarak test edin. |
| Çıktıda bir kural eksik | Kuralı açıkça belirtin, bir girdi/çıktı örneği ekleyin ve eksik bilgi içeren durumlarla yeniden test edin. |
| Bir betik veya entegrasyon başarısız oluyor | Gerekli paketleri, izinleri, ağ erişimini ve yapılandırılmış araçları kontrol edin. Bir beceri tüm bağımlılıkları otomatik olarak yüklemez. |
Betikler, uzun başvurular veya şablonlar için gerektiğinde scripts/, references/ ya da assets/ ekleyin ve bunlara SKILL.md içinden bağlantı verin. Güncel yollar ve çağırma seçenekleri için Kimi Code CLI Beceriler belgelerine bakın.
Ajan becerilerini kullanma ve oluşturma için en iyi uygulamalar
Açık bir tetikleyici tanımlayın: hem görevi hem de becerinin ne zaman kullanılacağını açıklayın. Kullanıcıların doğal olarak kullandığı terimleri ekleyin; ilgili ve ilgisiz istekleri test edin.
Talimatları odaklı tutun: belirtim, ana dosya için 500 satırdan ve 5.000 token'dan az olmasını önerir. Bunlar, satırdan token'a dönüşüm anlamına gelmeyen ayrı yönergelerdir. Ayrıntılı başvuruları destekleyici dosyalara taşıyın.
Gözlemlenebilir çıktılar belirtin: gerekli bölümleri, örnek girdileri ve çıktıları ve eksik bilgiler için kuralları ekleyin.
Bağımlılıkları belgelendirin: gerekli araçları ve paketleri belirleyin; uygun olduğunda uyumluluk meta verilerini kullanın. Platforma özgü uzantıları taşınabilir çekirdekten ayrı tutun.
Sonuç doğuran eylemleri denetleyin: mesaj gönderen veya değişiklikleri dağıtan iş akışları için açık çağırma ve uygun onay kuralları kullanın. Yalnızca manuel çağırma, izin kontrollerinin yerini tutmaz.
Üçüncü taraf paketleri inceleyin: kurulumdan önce, kullandıkları veri ve izinler de dâhil olmak üzere talimatları ve paketle gelen betikleri inceleyin.
Sonuç
Ajan becerileri, tekrarlanan görevleri uyumlu AI ajanlarının gerektiğinde yükleyebileceği yeniden kullanılabilir iş akışlarına dönüştürür. Becerinin ne zaman kullanılacağını ve ne üretmesi gerektiğini tanımlayan odaklı bir SKILL.md ile başlayın. Yalnızca görev gerektirdiğinde betikler veya başvurular ekleyin; ardından becerinin ne zaman etkinleştiğini ve çıktısının kalitesini test edin.