DokümantasyonÖzellikler
Skill'ler
Talimat paketlerini (SKILL.md) GitHub'dan ya da bilgisayarından kur veya kendin yaz, ajanlara ya da takımlara ata.
Skill, bir ajana belirli bir işi ne zaman ve nasıl yapacağını anlatan bir talimat paketidir. Skill’leri bir kez kurar, ajanlara ya da takımlara atarsın; ajanlar iş uygun olduğunda skill’i okur. Skill’ler Agent Skills biçimini izler, bu yüzden yayımlanmış birçok skill olduğu gibi çalışır.
Skill nedir
Skill, kökünde bir SKILL.md dosyası bulunan bir klasördür; isteğe bağlı başvuru dosyaları ve script’ler de içerebilir. SKILL.md, skill’in adını (name) ve açıklamasını (description) tutan kısa bir başlık bloğuyla başlar, ardından talimatlar gelir:
---
name: benim-skillim
description: "Bu skill ne zaman kullanılmalı, bir iki cümleyle."
---
# Benim skill'im
## Ne zaman kullanılır
## Adımlar
1.
En önemli kısım açıklamadır: ajanlar kendilerine atanan her skill’in adını ve açıklamasını görür, skill’in işe uyup uymadığına buna bakarak karar verir. Tam talimatları ancak ondan sonra okur.
Not: Skill’ler, ajan profilindeki Uzmanlık etiketleriyle aynı şey değildir. Uzmanlık etiketleri, liderin görevleri ajanlarla eşleştirirken baktığı kısa etiketlerdir. Skill’ler ise ajanın çalışırken okuduğu tam talimat paketleridir.
Skill ekle
Organizasyon → Skill’ler’i aç ve Skill ekle’ye tıkla. Pencerede üç sekme var.
GitHub’dan
Bir GitHub adresi yapıştır ve Oku’ya tıkla. Adres şunlardan biri olabilir:
- bir depo (
https://github.com/sahip/depo), - içindeki bir klasör (içindeki birden çok skill otomatik bulunur),
- bir
SKILL.mdya da herhangi bir.mddosyası.
Yalnızca herkese açık depolar çalışır. Özel (private) depolar planlı.
Bilgisayardan
Klasör seç ya da .zip / .md seç’e tıkla veya öğeyi pencereye sürükleyip bırak. Bir skill klasörü (içinde SKILL.md), bir ya da birden çok skill içeren bir .zip ya da tek bir .md dosyası ekleyebilirsin. .md dosyasında başlık bloğu yoksa ad dosya adından, açıklama ilk paragraftan alınır.
Yeni yaz
SKILL.md’yi doğrudan Agentbits’te yaz ve Skill oluştur’a tıkla. name ve description içeren başlık bloğu zorunludur.
Kurmadan önce önizleme
Hiçbir şey kurulmadan önce Agentbits bulduklarını gösterir: her skill’in adı, açıklaması, dosya sayısı ve boyutu, program dosyası içerip içermediği ve kurulu olanın yerine geçer durumu (aynı adlı bir skill varsa). Her birinin SKILL.md’sini SKILL.md’yi göster ile açabilirsin.
Skill’de Talimatları geçersiz kılmaya benzeyen satırlar varsa (ör. “önceki talimatları yok say”) uyarı olarak listelenir. Skill’i kurmadan ya da atamadan önce bunları oku.
İstediğin skill’leri seç ve kurulum düğmesine tıkla (ör. 2 skill kur). Var olan bir skill’le aynı adı taşıyan bir skill kurmak onu yerinde günceller ve atamalarını korur.
Önizleme ve kurulum sırasında kaynaktaki hiçbir şey çalıştırılmaz. Boyut sınırları: indirme ya da arşiv için 50 MB, skill başına 10 MB, dosya başına 2 MB ve en fazla 300 dosya; daha büyükler atlanır ve not edilir.
Skill ata
Ajanlar yalnızca kendilerine atanan skill’leri görür. Skill’in sayfasında Kimler kullanabilir altında Ata…’ya tıkla ve seç:
- tek tek Ajanlar, ya da
- Takımlar ve birimler altından bir takım, departman ya da şirket. Tüm üyeleri skill’i alır; alt birimlerin üyeleri de dahil. Organizasyona (Herkes) atamak skill’i tüm ajanlara verir.
Organizasyon → Ajanlar altında bir ajanın sayfasındaki Skill’ler bölümü, ajanın skill’lerini ve her birinin nereden geldiğini (doğrudan ya da bir takım üzerinden) gösterir. Skill’leri oradan da ekleyebilirsin.
Ajanlar skill’leri nasıl kullanır
Her ajanın talimatlarında atanmış skill’lerinin bir listesi (ad ve açıklama, en fazla 40) bulunur. Bir skill işe uyduğunda ajan içeriğini okur:
- Claude Code CLI, Anthropic API, OpenAI API: skill okuma aracıyla. Ajan yalnızca kendi skill’lerini okuyabilir.
- Codex CLI: çalışma için skill’lerinin geçici bir kopyasını alır ve dosyaları doğrudan okur.
- Demo: göreve en çok uyan atanmış skill’i okur ve raporunda belirtir.
Bir skill’deki script’ler ancak ajan komut çalıştırabiliyorsa çalışabilir. Terminal izni olan bir Claude Code ajanı, script içeren skill klasörlerinin bir kopyasını alır ki onları çalıştırabilsin. Agentbits bu script’lerin ne yaptığını denetlemez; script içeren skill’leri yalnızca güvendiğin kaynaklardan ata. Bkz. İzinler.
Skill’leri yönet
Bir skill’in sayfasında şunları yapabilirsin:
- Talimatları değiştirmek için SKILL.md’yi düzenle. Skill bundan sonra düzenlendi rozetini gösterir.
- Yeniden indirip dosyalarını değiştirmek için Kaynaktan güncelle. Agentbits’te yapılan düzenlemeler kaybolur; atamalar korunur.
- Kullanımda anahtarını kapat. Kapalıyken hiçbir ajan skill’i görmez.
- Sil. Ajanlar erişimini kaybeder; geri alınamaz ama yedeklerde durur.
Listedeki rozetler göz gezdirmeni kolaylaştırır: script, kapalı, kontrol et (uyarısı var), düzenlendi ve atama sayısı.
Skill’ler Agentbits veritabanında saklanır; yedek, geri yükleme ve sıfırlama onları da kapsar. Agentbits GitHub’a yalnızca oradan bir skill kurduğunda ya da güncellediğinde bağlanır.
Yanlış ya da eksik bir şey mi buldun? GitHub'da bildir