SKILL.md formatı nedir?

SKILL.md, bir agent skill'inin açık dosya formatıdır: YAML frontmatter (name + description) ve ardından markdown talimatlar. Claude, Codex ve Gemini CLI / Antigravity arasında paylaşılır.

Agent skill'leri birden fazla AI modelinde çalışır mı?

Evet. Aynı SKILL.md Claude, OpenAI Codex ve Gemini CLI / Antigravity'de çalışır. Tek fark, her aracın kurulu skill'leri nerede aradığıdır.

SKILL.md, Azure skillset'i veya Gemini Gem ile aynı mı?

Hayır. Azure AI Search skillset'i bir arama indeksleme hattıdır, Gemini Gem ise kod gerektirmeyen bir sohbet botudur. Hiçbiri kurulabilir bir agent SKILL.md'si değildir.

SKILL.md dosyasını nasıl oluştururum?

Bir klasör aç, frontmatter'da name ve description olan bir SKILL.md ekle, sonra talimatları yaz. Ya da ücretsiz Skill Builder ile anında üret.

Agent Skill Nedir ve SKILL.md Nasıl Oluşturulur?

Agent skill'leri, herhangi bir AI agent'a tek bir SKILL.md dosyasıyla yeniden kullanılabilir bilgi vermenin açık bir yoludur. Bu rehber formatı, nasıl çalıştığını, herhangi bir araç için nasıl oluşturulacağını ve yaygın benzerlerinden nasıl ayrılacağını anlatır.

Agent Skills nedir? (açık standart)

Agent Skills, bir AI agent'a küçük bir klasör (içinde SKILL.md dosyası) olarak verdiğin yeniden kullanılabilir yeteneklerdir. Agent her skill'in adını ve açıklamasını baştan okur, tam talimatları yalnızca görev eşleştiğinde yükler — böylece context'i şişirmeden bir agent'a çok sayıda skill verebilirsin.

Bu bir açık standarttır, tek bir üreticinin özelliği değil: aynı SKILL.md Claude, OpenAI Codex ve Gemini CLI / Antigravity'de çalışır.

SKILL.md dosyasının anatomisi

YAML frontmatter — name (küçük harf, kebab-case, klasörle aynı) ve description (skill ne yapar + ne zaman tetiklenir).
Markdown gövde — asıl talimatlar; net, emir kipinde adımlar.
İsteğe bağlı paketli kaynaklar — skill'in işaret edebileceği script, referans veya şablonlar.

Progressive disclosure nasıl çalışır

Skill'ler ucuz kalır çünkü agent, kurulu her skill'in yalnızca hafif adını + açıklamasını hep görür. Tam gövdeyi context'e yalnızca görev eşleştiğinde çeker, paketli dosyaları da yalnızca talimatlar isterse okur. Dev bir system prompt'un ölçeklenemeyeceği yerde skill'leri ölçeklenebilir kılan budur.

SKILL.md nasıl oluşturulur (araçtan bağımsız)

Aşağıdaki adımlar herhangi bir uyumlu agent için geçerlidir.

Tek SKILL.md; Claude, Codex ve Gemini / Antigravity'de

Dosya aynıdır; yalnızca kurulum konumu değişir:

Claude Code — ~/.claude/skills/<ad>/SKILL.md
OpenAI Codex — ~/.agents/skills/<ad>/SKILL.md
Gemini CLI / Antigravity — ~/.gemini/config/skills/<ad>/SKILL.md

İşte minimal, taşınabilir bir örnek:

---
name: pr-review
description: Bir pull request'i hata, güvenlik ve stil açısından inceler. Kullanıcı kod veya PR incelemesi istediğinde kullan.
---

# PR Review

1. Yorum yapmadan önce diff'in tamamını oku.
2. Önce doğruluk hatalarını, sonra güvenliği, sonra stili işaretle.
3. file:line referanslarıyla somut geri bildirim ver.
4. Onayla veya değişiklik-iste ile bitir.

SKILL.md, Azure AI Search skillset'i veya Gemini Gem değildir

İki sık karışıklık:

Azure AI Search "skillset"i, arama indeksleme için bir zenginleştirme hattıdır — agent SKILL.md dosyalarıyla ilgisizdir.
Gemini "Gems", gemini.google.com'daki kod gerektirmeyen özel sohbet botlarıdır — kurulabilir SKILL.md skill'leri değildir.

Bir agent yeteneğini dosya olarak oluşturmak için buradaysan, aradığın şey agent skills / SKILL.md'dir.

Araca göre skill'ini oluştur

Adım adım rehber için agent'ını seç:

Ya da temelleri agent skill nedir yazısında öğren ve bir SKILL.md şablonu al.

İlk agent skill'ini hemen oluştur

Ücretsiz Skill Builder ile boilerplate'i atla ya da hazır skill'lere göz atıp saniyeler içinde birini kur.