Ajan becerileri (Agent Skills) nedir?

Kısaca

Ajan becerileri (Agent Skills), bir ajana belirli bir işi nasıl yapacağını öğreten talimat, betik ve kaynak dosyalarından oluşan klasörlerdir. Her becerinin merkezinde bir SKILL.md dosyası vardır ve ajan beceriyi yalnızca görev onu gerektirdiğinde yükler.

Yapısı

Bir beceri, adını taşıyan bir klasördür. SKILL.md dosyasının YAML başlığında name ve description alanları, gövdesinde adım adım talimatlar bulunur. Klasöre betikler, şablonlar ya da referans belgeler de konabilir.

Claude Code’da kişisel beceriler ~/.claude/skills/, projeye ait olanlar .claude/skills/ altında durur.
Codex de skill’leri destekler: proje skill’leri .agents/skills, kişisel olanlar ~/.codex/skills altında durur.
Eklentiler (plugin) de beraberinde beceri getirebilir.

Neden kademeli yükleniyor?

Başlangıçta modelin bağlamına her becerinin yalnızca adı ve kısa açıklaması girer. Görev bir beceriyle eşleşince model SKILL.md’nin tamamını, gerekirse yanındaki dosyaları okur. Böylece onlarca beceri kurulu olsa da bağlam şişmez; ama açıklaması belirsiz bir beceri doğru anda devreye girmez.

Skill, MCP, alt ajan ve hook

Bu dört kavram sık karıştırılır; her biri farklı bir ihtiyaca cevap verir.

Skill: bir işin nasıl yapılacağını anlatan bilgi ve betikler; ne zaman kullanılacağına model karar verir.
MCP: ajana yeni araçlar ve dış servis bağlantıları ekler.
Alt ajan: işi ayrı bir bağlamda yürüten yardımcı ajan.
Hook: belirli bir olayda her seferinde çalışan komut; modelin kararına bağlı değildir.

İyi beceri yazmak

Bir becerinin değeri, doğru anda tetiklenmesine ve kısa kalmasına bağlıdır.

description alanına becerinin ne yaptığını ve ne zaman kullanılacağını açıkça yaz.
SKILL.md’yi kısa tut, uzun referansları ayrı dosyalara koy.
Tekrarlanan, kesin adımları betiğe dönüştür; model her seferinde yeniden yazmasın.
Başkasının becerisini kurmadan önce oku; betikler senin bilgisayarında çalışır.

AgentVera’da beceriler

AgentVera’nın Skill galerisi bu bilgisayardaki Claude Code ve Codex skill’lerini tek listede toplar; bağlam profilleri de becerilerin ilk isteğe kattığı yükü kontrol etmeni sağlar.

Proje Detaylar → Otomasyon → Skill’ler: Claude Code ve Codex skill’lerini oluştur, aç, kapat, düzenle ya da başka ajana kopyala.
Galeriden kurulan skill’lerin dosyaları SHA-256 ile doğrulanır ve kurulmadan önce bu bilgisayarda taranır; betikler çalıştırılabilir yapılmaz.
Kendi skill’ini organizasyonunla ya da herkese açık galeride paylaşmak Pro ve Team planlarında; herkese açık skill’ler moderatör onayından geçer.
Yalın bağlam profili kullanıcı eklentilerini, hook’ları, becerileri ve harici MCP’yi kapatır; Claude Code’un ilk isteği yaklaşık 34,4 bin token’dan 13,3 bine iner.

Sık sorulanlar

Skill ile MCP arasındaki fark nedir?

MCP ajana yeni araçlar ve bağlantılar ekler; skill ise ajana bir işi nasıl yapacağını öğretir. Bir beceri, işi yaparken MCP araçlarını kullanmayı da tarif edebilir.

Beceriler her istekte token harcar mı?

Her istekte yalnızca adları ve açıklamaları bağlamdadır. Tam içerik, model beceriyi kullanmaya karar verince yüklenir.

Beceriyi nasıl kullandırırım?

Çoğu zaman bir şey yapman gerekmez; görev açıklamayla eşleşince model beceriyi kendisi yükler. İstersen mesajında beceriyi adıyla anıp kullanmasını isteyebilirsin.

Başkasının yazdığı beceriyi kurmak güvenli mi?

İçeriğine bağlı. Beceriler talimat ve betik içerir, betikler de senin bilgisayarında çalışır. Kurmadan önce SKILL.md’yi ve betikleri oku.