Skill’ler, bir kodlama ajanına varsayılan olarak iyi yapmadığı bir şeyi öğretmenin en kolay yolu: bir tasarım standardı, bir inceleme kontrol listesi, token tasarrufu için bir yöntem. Bu rehberde Claude Code ve Codex için skill’lerin nerede durduğunu, elle nasıl kurulduğunu ve komut satırına girmeden nasıl yönetileceğini anlatıyoruz.
Skill nedir?
Skill, içinde SKILL.md dosyası bulunan bir klasördür: en üstte kısa bir ad ve açıklama, altında Markdown ile yazılmış talimatlar, yanında da ihtiyaç duyduğu betikler ya da referans dosyaları. Ajan, kurulu skill’lerinizin yalnızca açıklamalarını okur ve bir skill’in tam talimatlarını ancak görev gerektirdiğinde yükler. Bu yüzden kurulu skill’ler kullanılana kadar bağlamdan neredeyse hiç yer yemez.
my-skill/
├── SKILL.md
└── scripts/
└── check.sh
Claude Code ve Codex skill’leri nerede arar?
| Ajan | Kişisel skill’ler (tüm projeler) | Proje skill’leri |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ |
repodaki .claude/skills/<name>/ |
| Codex | ~/.codex/skills/<name>/ veya ~/.agents/skills/<name>/ |
Codex dokümantasyonuna göre |
CLAUDE_CONFIG_DIR ya da CODEX_HOME ayarladıysanız kişisel klasörler de onlarla birlikte taşınır.
Skill’i elle kurmak
- Skill’in reposunu ve içinde
SKILL.mdbulunan klasörü bulun. - O klasörü skill dizininize kopyalayın:
git clone https://github.com/owner/repo /tmp/repo
cp -R /tmp/repo/skills/my-skill ~/.claude/skills/- Ajanın skill’i görmesi için yeni bir oturum başlatın.
Güncellemek, kopyalamayı tekrarlamak demek; yeni sürüm sorun çıkarırsa geri alma yolu da yok. Bu yüzden eski klasörün bir yedeğini saklayın.
Yalnızca güvendiğiniz skill’leri kurun. Bir skill, ajanın sizin yetkilerinizle çalıştırabileceği betikler içerebilir. Önce SKILL.md dosyasını ve betikleri okuyun.
Kendi skill repolarınızı Vibe Console ile yönetin
Vibe Console’un Skill’ler panelinde güvendiğiniz bir GitHub reposunu owner/repo ya da https://github.com/owner/repo biçiminde ekleyin. Kartı için bir bölüm seçin, ardından Claude Code ya da Codex için hangi skill’leri kuracağınızı belirleyin. Liste Mac’inizde saklanır; skill dosyalarını Vibe Console sağlamaz. Herhangi bir kartı, daha önce kurduklarınızı kaldırmadan listeden silebilirsiniz.
Geri dönüşlü güvenli güncellemeler
Vibe Console, kurulu skill’lerin güncellemelerini denetler ve bunları Güncelleme mevcut olarak, diskteki dosyalar kaynakla artık eşleşmiyorsa Kaynak farklı — değişiklikleri inceleyin olarak işaretler. Güncelleme, önceki dosyaların bir yedeğini tutar. Yeni sürüm sorun çıkarırsa Geri Döndür’e basın ya da eski dosyalara bakmak için Yedeği aç’ı kullanın.
Sık sorulan sorular
Skill’ler hem Claude Code’da hem Codex’te çalışır mı?
SKILL.md biçimi ikisinde de çalışır, ama her ajan skill’leri kendi klasöründen yükler. Skill’i kullandığınız her ajan için ayrı kurun.
Kurulu skill’ler ajanı yavaşlatır mı?
Neredeyse hiç. Ajanlar, bir görev gerektirene kadar her skill’in yalnızca kısa açıklamasını okur.
Bir skill’i nasıl kaldırırım?
Klasörünü skill dizininden silin, ardından yeni bir oturum başlatın.
Skill’ler panelini 14 gün ücretsiz deneyin: Vibe Console’u indirin.