Codex Skill Oluşturma: OpenAI Codex SKILL.md Rehberi

OpenAI Codex Skills nedir?

Codex Skills, OpenAI Codex'i göreve özel bilgiyle genişleten yeniden kullanılabilir iş akışı paketleridir. Her skill, bir SKILL.md dosyası (frontmatter + talimatlar) içeren bir klasördür; böylece Codex tekrarlayan bir işi (sürüm kontrol listesi, migration, inceleme) her seferinde aynı yapar ve görevi tanıdığında otomatik çağırır.

Codex Skills, Claude ile aynı açık Agent Skills SKILL.md formatını kullanır. Kavrama yeniyseniz önce agent skill nedir yazısını okuyun.

Codex Skills vs AGENTS.md, plugin ve Claude Skills

• SKILL.md (skill) — Codex'in ilgili olduğunda yüklediği, göreve özel, ihtiyaç anında talimatlar.
• AGENTS.md — Codex'in o projede nasıl davranacağına dair repo geneli, her zaman açık rehber. Skill ise dar kapsamlı ve yalnızca gerektiğinde yüklenir.
• Plugin — skill'leri ve araçları dağıtım için paketler.
• Claude Skills — aynı açık standart; iyi yazılmış bir SKILL.md büyük ölçüde Codex ile Claude arasında taşınabilir.

Codex SKILL.md anatomisi

Frontmatter iki alan ister:

• name — küçük harf, kebab-case, klasörle aynı.
• description — skill'in ne yaptığı ve ne zaman tetikleneceği (Codex kullanıp kullanmayacağına buna bakar).

Markdown gövde emir kipinde talimatları taşır. ~500 satırın altında tutun ve deterministik davranış gerekmedikçe script yerine talimatı tercih edin.

Codex skill oluşturmanın dört yolu

1. Yerleşik $skill-creator — Codex, skill'in ne yaptığını ve ne zaman tetikleneceğini sorarak iskeletini kurar. 2. Record & Replay — bir iş akışını bir kez göster; Codex adımlardan yeniden kullanılabilir bir skill taslağı çıkarır. 3. Manuel — klasörü oluşturup SKILL.md'yi kendin yaz (aşağıda). 4. Skill Builder — ProfessorGPT'nin ücretsiz sihirbazıyla temiz bir SKILL.md üret, ayar gerekmez.

Adım adım: ilk Codex SKILL.md'in

Bir skill oluşturup etkinleştirmek için aşağıdaki adımları izleyin.

Codex skill'leri nerede durur ve nasıl çağrılır

Codex kişisel skill'leri $HOME/.agents/skills/, repo skill'lerini ise proje içindeki .agents/skills/ klasöründe bulur. Klasör + SKILL.md ekleyin:

mkdir -p ~/.agents/skills/release-notes
# ~/.agents/skills/release-notes/SKILL.md ekleyin

Codex değişiklikleri yeniden başlatınca alır ve görev eşleştiğinde skill'i otomatik çağırır. Ayrıca $skill-name ile açıkça çağırabilir veya /skills ile kurulu skill'leri listeleyebilirsin.

Kopyalayabileceğin tam bir Codex SKILL.md

---
name: release-notes
description: Son etiketten bu yana merge edilmiş pull request'lerden sürüm notları hazırlar. Kullanıcı changelog veya sürüm notu istediğinde kullan.
---

# Release Notes

1. En son git etiketinden bu yana merge edilmiş PR'ları listele.
2. Bunları Özellikler, Düzeltmeler ve İşler olarak grupla.
3. Her değişiklik için kullanıcı odaklı, kısa bir madde yaz.
4. GitHub release'e yapıştırmaya hazır geçerli Markdown üret.

Kurulumla uğraşmadan Codex skill oluştur

Boilerplate'i atla: Skill Builder, Codex, Claude ve Gemini CLI'de çalışan standart bir SKILL.md üretir ya da hazır skill'lere göz at.