Agent skill (SKILL.md) nedir ve biri nasıl denetlenir

Bir skill, kodlama ajanınızın aradığı yerde duran, içinde SKILL.md dosyası bulunan bir klasördür. Ajan dosyayı yalnızca isteğiniz onunla eşleştiğinde okur. O ana kadar skill yaklaşık yüz token tutar; oysa bir prompt, yapıştırdığınız her mesajla birlikte taşınır.

Bu kelimeyle muhtemelen bir README'de karşılaştınız: "skill'i kurun, sonra ajandan şunu isteyin...". Gizemli bir şey yok. Aşağıda: içinde ne var, bağlam penceresine ne zaman girer ve makinenize almadan önce bir skill'e nasıl bakılır.

Skill nedir ve prompt'tan farkı ne#

Anthropic'in Agent Skills belgeleri (30 Ekim 2026'da kontrol edildi) bir skill'i yeniden kullanılabilir, dosya sistemine dayalı bir kaynak olarak tanımlar: içinde SKILL.md dosyası bulunan bir dizin, ayrıca isteğe bağlı betikler, şablonlar ve referans dosyaları. SKILL.md küçük bir YAML başlığıyla (bir ad ve bir açıklama) başlar ve düz talimatlarla devam eder.

Yeni bir iş arkadaşını düşünün. Prompt, sandalyesinin arkasında durup her sabah kuralları tekrarlamanızdır. Skill ise rafta, sırtında etiketi olan bir klasördür: "Commit mesajı stili. Biri senden commit yapmanı istediğinde oku." Klasörü yalnızca gerektiğinde indirirler.

İki başlık alanı zorunludur ve formatın kuralları vardır. Claude'un Skills formatında name en fazla 64 karakterdir: küçük harfler, rakamlar ve tireler; "anthropic" veya "claude" kelimelerini içeremez. description boş olamaz, 1.024 karakterle sınırlıdır ve hem skill'in ne yaptığını hem de ne zaman kullanılacağını söylemek zorundadır.

Bir skill bağlam penceresine nasıl girer#

Belgeler buna aşamalı açığa çıkarma der: ajan bir skill'i üç aşamada okur ve her aşama yalnızca ona ulaşılırsa bedeli ödenir.

• Seviye 1, her zaman yüklenir. Kurulu her skill'in adı ve açıklaması, skill başına yaklaşık 100 token.
• Seviye 2, tetiklendiğinde. SKILL.md gövdesi, 5.000 token'ın altında.
• Seviye 3, yalnızca gerektiğinde. Paketlenmiş dosyalar ve betikler. Ajan bir betiği çalıştırdığında betiğin kodu bağlama girmez, yalnızca çıktısı girer.

Token rakamları belgelerin yaklaşık değerleridir, kesin sayımlar değil.

İşte bunun faturanız için önemi. 20 skill kurduğunuzu varsayalım. 20 × 100 = 2.000 token ilk mesajdan itibaren yanınızda taşınır. Bir ajan her adımda bağlamını yeniden gönderir (20 adımlı örnek nedenini gösterir), yani 50 adımlı bir oturum 50 × 2.000 = 100.000 girdi token'ı skill etiketi taşır. DeepSeek-V4-Flash'te bu, mevcut fiyatlarla $0.0015 eder.

Şimdi tersini düşünün. O yirmi skill tek bir büyük prompt olarak yapıştırılsaydı, her gövde her istekte yer alırdı: oturum başına değil, istek başına 20 × 5.000 = 100.000 token'a kadar. Bu fark, talep üzerine yüklemenin tüm amacıdır. "Bağlam penceresi" terimi hâlâ belirsizse, bu açıklama onu neyin doldurduğunu ele alıyor.

Skill'ler bağlamda yaşar, dolayısıyla ajanın arkasındaki modelin onlara yer ayırması gerekir. CheapTokens'teki DeepSeek-V4-Flash (id deepseek-ai/DeepSeek-V4-Flash-0731) 380K bağlam penceresine ve yanıt başına 32.768'e kadar çıktı token'ına sahiptir, günün her saatinde tek fiyat ve OpenAI ile Anthropic uyumlu bir API sunar. Terminal ajanı için Claude Code'u CheapTokens'e nasıl bağlayacağınızı izleyin; diğer araçlar için belgelerden başlayın. Modelin kendi sayfası burada.

İki dakikada minimal bir skill yazın#

Bir tane yazdıktan sonra okumak daha kolaydır. Bu skill, ajanın commit mesajlarını sabit bir formatta yazmasını sağlar. Claude Code'da kişisel skill'ler ~/.claude/skills/ içinde, proje skill'leri .claude/skills/ içinde yaşar, böylece bir proje skill'i depoyla birlikte taşınabilir.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Bunu dosyaya yapıştırın:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Şimdi ajanı hazırlanmış değişiklikleri olan bir depoda açın ve sorun: "hazırladığım değişiklikler için bir commit mesajı yaz". Ajan açıklamayı görür, eşleştiğine karar verir, dört kuralı okur ve onlara uyar. Skill'i yok sayarsa önce description alanına bakın: durumu, burada "commit"i, gerçekte kullanacağınız kelimelerle adlandırmalıdır.

Bir uyarı: skill'ler claude.ai, API ve Claude Code arasında senkronize olmaz. Bir yerde oluşturduğunuz skill diğerlerine ayrıca eklenmelidir.

Skill, AGENTS.md, MCP: hangisi hangisi#

Bu üçü sürekli karıştırılır. AGENTS.md veya CLAUDE.md gibi bir kurallar dosyası oturumun başında okunur ve proje hakkındaki gerçekleri tutar (o dosyanın bir Downloads klasöründe nasıl yanlış gidebileceği). Bir MCP sunucusu ajana ulaşabileceği yeni araçlar ve veriler verir (sade bir dille MCP). Bir skill ise bir prosedürdür: bir tür işin nasıl yapılacağı, o iş ortaya çıktığında yüklenir.

Kurmadan önce üçüncü taraf bir skill'i denetleyin#

Bir skill, ajanın uyduğu metin ve bazen ajanın çalıştırdığı koddur. Belgeler skill'leri yalnızca güvenilir kaynaklardan kullanmanızı, paketlenmiş her dosyayı (SKILL.md, betikler, kaynaklar) denetlemenizi ve beklenmedik ağ çağrıları veya dosya erişimi aramanızı söyler. Harici URL'lerden içerik çeken skill'ler daha risklidir. Claude Code'da bir skill, bilgisayarınızdaki herhangi bir programla aynı ağ erişimine sahiptir, dolayısıyla kurulumu yazılım kurmak gibi ele alın.

İyi bir örnek universal-modder, bir oyun modlama araç setidir. README'si (30 Ekim 2026'da kontrol edildi) Agent Skills formatında MIT lisanslı bir skill setini, um adlı bir Python CLI'sını, fal üzerinden varlık üretimi için bir MCP sunucusunu ve saha notlarından oluşan paylaşılan bir bilgi tabanını tanımlar. Ana skill mod-any-game keşif, tersine mühendislik, varlık üretimi, oyun içi test ve paketlemeyi kapsar. README, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot ve OpenCode'u desteklenen araçlar olarak listeler ve araç setinin anti-cheat veya DRM'i atlamayı reddettiğini söyler. Claude Code'da /plugin marketplace add rehan-remade/universal-modder ile kurulur ve varlık üretimi ayrı bir fal API anahtarı gerektirir.

O listenin ne içerdiğine dikkat edin: skill'ler, bir komut satırı programı ve bir sunucu. Tek bir SKILL.md okumak, kurduğunuz şeyin yalnızca bir dilimini kapsar. Öyleyse parçaları gözden geçirin:

Kilit kural bir API anahtarını güvenle nasıl saklayacağınızda. Depo sayfası son commit'in tarihini göstermiyor, dolayısıyla ona güvenmeden önce projenin ne kadar yakın zamanda güncellendiğini kontrol edin.