Becerileri kurma ve yönetme

Bu kılavuz, bir çalışma alanını GitHub’dan gelen becerilerle nasıl dolduracağınızı gösterir: bir depoyu kaynak olarak ekleyin, istediğiniz becerileri oradan kurun ve zaman içinde güncel tutun.

Başlamadan önce bilmeniz gereken önemli şey: bir kaynak deposu güvenilmezdir. Adı, açıklaması ve yıldız sayısı onu sahiplenen kişi tarafından yazılır. Control Center’ın güvendiği tek güvenlik sinyali, her kurulumun diske ya da bir ajan istemine ulaşmadan önce geçtiği antivirüs tarama kararıdır. Gerekçesini istiyorsanız ajan modelinin beceriler bölümünü okuyun; bu sayfa işin nasıl yapıldığında kalır.

Beceriler Ayarlar → Çalışma alanı → Beceriler altında yaşar (/workspaces/<id>/settings/workspace/skills). Çalışma alanı kapsamındadırlar: burada kurduğunuz beceriler yalnızca bu çalışma alanına aittir. Sayfada iki sekme vardır: Yüklü (yerel beceriler ve bir Yeni beceri düzenleyicisi) ve Kaynaklar (GitHub katalogları). Her iki yazma işlemi de aynı tarama kapısından geçer.

Beceri deposu ekleme

Ayarlar → Çalışma alanı → Beceriler yolunu açın ve Kaynaklar sekmesine geçin.
Depo ekle düğmesine basın.
Bir GitHub depo URL’si yapıştırın, örneğin https://github.com/anthropics/skills, ve onaylayın.

Sunucu, deponun var olduğunu ve kimlik bilgileriyle görünür olduğunu denetler, ardından depoyu sol kenar çubuğuna ekler. Arada seçilmiş bir mağaza yoktur: her GitHub deposu işe yarar; bu da itibarı değerlendirmenin size kaldığı anlamına gelir — yıldız sayısı bir kanıttır, asla bir garanti değil.

Bir deponun becerileri, SKILL.md içeren dizinlerdir (en fazla üç düzey derinlik, artı Claude eklenti pazarı düzeni plugins/<plugin>/skills/<skill>; bağımlılık ve satıcı ağaçları atlanır). Izgara daha sonra deponun hiç becerisi olmadığını söylüyorsa anlamı şudur: içindeki hiçbir dizin beceri kuralına uymuyor.

Kurmadan önce bir beceriyi inceleme

Kenar çubuğundan bir depo seçin; becerileri sağda bir ızgara olarak görünür ve üstündeki filtre alanı kataloğu ada, açıklamaya ya da slug’a göre daraltır. Ayrıntı görünümünü açmak için bir karta tıklayın. Üç şey gösterir:

README — markdown olarak işlenir; beceri dizinindeki README.md ya da README yoksa SKILL.md gövdesi.
Tarama önizlemesi — karar (pass, warn ya da quarantine), beceri içeriğinin beyan ettiği yetenekler (kabuk çalıştırır, dosya yazar, ağ erişimi…) ve tarayıcının kaydettiği her bulgu.
Dosya sayısı — bir kurulum, becerinin yalnızca SKILL.md dosyasını değil tüm dizinini yazar.

Önizleme, bir kurulumun yazacağı baytların aynısını tarar; yani gördüğünüz karar, kurulumun alacağı karardır; hiçbir şey arkanızdan yeniden değerlendirilmez.

Beceri kurma

Becerinin ayrıntı görünümünü açın.
Tarama kararını okuyun. warn ya da pass kararında Yükle düğmesine basın.
quarantine kararında, Riski anlıyorum — yine de yükle seçeneğini işaretleyene kadar yükleme devre dışı kalır. Bu geçersiz kılma kaydedilir, varsayılmaz.

Kurulum, becerinin dizinini çalışma alanına yazar, skills-lock.json içine bir pin kaydeder (kaynak depo, yol, geldiği commit ve bir içerik hash’i) ve beceri çalışma alanındaki ajanların kullanımına sunulur. Ad kullanımda olarak işaretlenmiş bir kart, yerelde o adı başka bir becerinin zaten kullandığı anlamına gelir — önce onun yüklemesini kaldırın.

Becerileri zaman içinde güncelleme

Yüklü becerilerin kartları rozet taşır: Yüklü ya da depo pinlediğiniz commit’i geçtiğinde Güncelleme var. Ayrıntı görünümünü açın ve yeni commit’te yeniden almak için Güncelle düğmesine basın. Bir güncelleme, kurulumla aynı tarama kapısından geçer — yeni sürümü karantinaya alınan bir beceri reddedilir ve elinizdeki sürüm yerinde kalır. Eski sürümün hash’i, kilit içinde bir geri alma referansı olarak saklanır.

Bir becerinin yüklemesini kaldırma, bir depoyu kaldırma

Yüklemeyi kaldır (yüklü bir becerinin ayrıntı görünümünde ya da Yüklü sekmesinde silme), becerinin dizinini ve kilit pinini birlikte kaldırır — yüklemesi kaldırılan bir beceri ardında hiçbir şey bırakmaz.

Bir depoyu kenar çubuğundan kaldırmak yalnızca kataloğu kaldırır: ondan kurduğunuz beceriler yüklü kalır ve güncellenmeye devam eder, çünkü bir pin depoyu kaynak girdisine referansla değil adıyla kaydeder. Tekrar göz atmak isterseniz depoyu yeniden ekleyin.

Beceri çağırma

Beceriler kendi ad alanları altında çağrılır, böylece yerleşik slash komutlarıyla (/plan, /goal, /loop, /compact) asla çakışmazlar:

/skill:<name> — bu çalışma alanında kurulu ya da ajana bağlı bir beceri
/skill:<repo>:<name> — bu alanda çalışma kopyası hazırlanmış bir deponun sunduğu beceri

Ön eksiz, yerleşik olmayan bir ad hâlâ çözümlenir; bu, ad alanı var olmadan önce yazılmış mesajlar içindir. plan adlı bir beceriye ulaşan şey /skill:plan’dır; /plan her zaman yerleşiktir.

Depo kapsamlı beceriler

Çalışma kopyası hazırlanmış bir depo kendi becerilerini .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ ya da skills/ altında sunabilir. Bunlar bu sayfa üzerinden kurulmaz. Bir ajan yalnızca o anda çalıştığı deponun becerilerini taşır; ajan taşındığında beceriler de değişir. Composer bu şekilde kapsamlanmaz: /skill:<repo>:<name> alandaki her depoya ulaşır.

Depo becerileri, frontmatter’ları bir isteme ulaşmadan önce aynı başarısızlıkta-kapalı taramadan geçer (pass / warn / quarantine). warn kabul edilir; quarantine alıkonur ve bu yolda operatör geçersiz kılması yoktur.

Bkz. Depo kapsamlı beceriler ve Slash komutları.

İlgili kılavuzlar

İlgili kavramlar

Ajan modeli