Claude Code, Codex ve OpenCode, skill'leri aynı formatta yükler: içinde SKILL.md dosyası bulunan bir klasör. Bu format, Anthropic'in oluşturduğu ve 4 Kasım 2026'da bir Linux Foundation projesi hâline gelen açık Agent Skills standardıdır. Yani tek bir skill üç araçta da çalışabilir. İşin püf noktası şu: Her araç farklı klasörlere bakıyor ve bazı alanları yalnızca Claude Code anlıyor. Bu rehber her aracın nereye baktığını, üçünün de yüklediği tek bir kopyayı nasıl tutacağınızı, nelerin taşınmadığını ve Orkas'ın çalıştırdığı her kodlama ajanına aynı skill'leri nasıl verdiğini gösteriyor.
Kısa cevap: Her skill klasörünü ~/.agents/skills içinde tutun. Codex ve OpenCode bu klasörü zaten okuyor. Claude Code okumuyor; bu yüzden ~/.claude/skills içine her skill için bir bağlantı ekleyin. Frontmatter'da yalnızca name ve description bırakın ve her skill'e klasörüyle aynı adı verin. 8 Kasım 2026'da Claude Code 2.1.319, Codex 0.167.0 ve OpenCode 2.2.6 ile kontrol edildi.
Claude Code, Codex ve OpenCode skill'leri nerede arar?
| Klasör | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | Hayır | Evet | Evet |
Projedeki .agents/skills | Hayır | Evet | Evet |
~/.claude/skills | Evet | Hayır | Evet |
Projedeki .claude/skills | Evet | Hayır | Evet |
~/.codex/skills | Hayır | Evet, ama kullanımdan kaldırıldı | Hayır |
~/.config/opencode/skills, .opencode/skills | Hayır | Hayır | Evet |
| Skill nasıl çağrılır | /skill-name | $skill-name veya /skills | @skill-name |
Üçü de isteğiniz bir skill'in açıklamasıyla eşleştiğinde o skill'i kendiliğinden de seçer. Proje klasörlerinde her araç, onu başlattığınız klasörü ve deponun köküne kadar her üst klasörü kontrol eder.
.agents/skillsklasörünü bulamayan araç Claude Code. Skill belgeleri yalnızca.claudeklasörlerini listeliyor; bellek belgeleri ise Claude Code'un “.agents/dizini altındaki hiçbir şeyi” okumadığını söylüyor. Bunu değiştirme talebi olan #31005 numaralı issue, 450'den fazla oyla hâlâ açık.- Codex,
.agents/skillsklasörüne geçti. Belgeleri projede.agents/skills, sizin için~/.agents/skillsve yöneticiler için/etc/codex/skillsklasörlerini listeliyor. Eski~/.codex/skillsklasörü kaynak kodda kullanımdan kaldırıldı olarak işaretli, ama hâlâ yükleniyor. Codex hiçbir.claudeklasörünü okumuyor. - OpenCode her şeyi okur. Belgeleri kendi klasörlerinin yanı sıra
.claude/skillsve.agents/skillsklasörlerini her iki düzeyde listeliyor. Bu, 2.2 serisi için de, hâlâ yeni sürümleri çıkan 1.19 serisi için de geçerli.
Tek bir ortak klasör kurun
Tek gerçek kopya olarak ~/.agents/skills klasörünü kullanın. Codex ve OpenCode onu hiçbir kurulum gerekmeden okur; npx skills ve Codex içe aktarıcısı da oraya yazar. Ardından Claude Code her skill için bir bağlantı alır.
- Skill'lerinizi
~/.agents/skillsiçine taşıyın.~/.claude/skillsveya~/.codex/skillsiçinde yazdığınız her skill'in klasörünü taşıyın; örneğinmv ~/.claude/skills/release-notes ~/.agents/skills/.~/.claude/skills/syncedklasörünü yerinde bırakın: Claude Code, claude.ai hesabınızdaki skill'leri orada tutar. - Her skill'i Claude Code'un klasörüne bağlayın. macOS veya Linux'ta şunu çalıştırın. Betik, orada zaten bir klasörü veya bağlantısı olan skill'leri atlar.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
n=$(basename "$d")
[ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done- Windows'ta junction kullanın. Junction'lar yönetici hakları gerektirmez. PowerShell'de:
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
$link = "$HOME\.claude\skills\$($_.Name)"
if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}- Her aracı kontrol edin. Yeni bir oturum başlatın. Claude Code'da
/yazıp skill'i arayın. Codex'te/skillsçalıştırın. OpenCode'da@yazın.
Ekibin paylaştığı bir projede aynısını deponun içinde yapın: Skill'leri .agents/skills içinde tutun ve her birini .claude/skills içinden ln -s ../../.agents/skills/release-notes .claude/skills/release-notes gibi göreli bir bağlantıyla bağlayın.
Doğru yapılması gereken birkaç nokta:
- Klasörün tamamını değil, her skill'i ayrı ayrı bağlayın.
~/.claude/skillsklasörünün kendisi~/.agents/skillsklasörünü gösterirse Claude Code'unsyncedve.trashklasörleri ortak klasöre düşer ve Codex ile OpenCode senkronize edilmiş skill'leri de yükleyebilir. Bunun bedeli, bir skill ekledikten sonra döngüyü yeniden çalıştırmanız gerekmesidir. - SKILL.md dosyalarını değil, klasörleri bağlayın. Codex bağlantılı bir skill klasörünü takip eder, ama kendisi bağlantı olan bir SKILL.md dosyasını yok sayar. OpenAI bu talebi “planlanmıyor” olarak kapattı.
- Windows kullanan ekip arkadaşlarınız varsa bağlantıları commit etmeyin. Git for Windows bağlantıları varsayılan olarak küçük metin dosyaları şeklinde checkout eder. Bağlantıları bir kurulum betiğiyle oluşturun veya gerçek kopyaları commit edin.
- OpenCode her skill'i iki kez görür ve birini tutar. Hem
~/.claude/skillsiçindeki bağlantıyı hem de~/.agents/skillsiçindeki klasörü okur. 2.2 sürümü bunları sessizce birleştirir. 1.19 sürümü günlüğe bir yinelenme uyarısı yazar; OpenCode'un Claude klasörlerini okumasını durdurmak içinOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1ayarlayın.
Üçünün de yükleyebileceği bir skill yazın
Bu SKILL.md; Claude Code, Codex ve OpenCode'da aynı şekilde yüklenir. ~/.agents/skills/release-notes/SKILL.md konumunda durur ve yanında bir references ile bir scripts klasörü vardır.
---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---
# Sürüm notları
1. Son etiketi bul: git describe --tags --abbrev=0
2. O etiketten sonraki commit'leri listele: git log <tag>..HEAD --oneline --no-merges
3. Commit'leri bu skill'in klasöründeki references/format.md dosyasına göre Added, Changed ve Fixed olarak grupla.
4. Dosya kaydetmek için bu skill'in klasöründen scripts/write_notes.sh çalıştır.- Skill'e klasörüyle aynı adı verin. Küçük harf, rakam ve kısa çizgi kullanın; en fazla 64 karakter. Codex
namealanına, OpenCode 2.2 klasör adına bakar, Claude Code ise ikisini de kabul eder. İkisi farklıysa aynı skill'i her araçta farklı bir adla çağırırsınız. Codex, adı 64 karakterden uzun olan bir skill'i atlar. - Açıklamayı 1.024 karakterin altında tutun ve insanların kullanacağı kelimeleri başa koyun. Bu, standardın sınırıdır; Codex da daha uzun açıklamaları skill listesinde bu uzunluğa kırpar.
- İki nokta üst üste ve ardından boşluk içeren her değeri tırnak içine alın. Aksi hâlde frontmatter ayrıştırılamayabilir. Codex bu durumların çoğunu onarır, Claude Code skill'i hiç frontmatter yokmuş gibi yükler, OpenCode ise skill'i hata vermeden atlayabilir.
- Betiklerin kendi klasörlerini bulmasını sağlayın. Araçlar komutları skill'in klasöründen değil, proje klasörünüzden çalıştırır.
cd "$(dirname "$0")"ile başlayan bir betik her yerden çalışır. - Skill'i claude.ai'a veya Claude API'ye yükleme ihtimaliniz varsa adına “claude” koymayın. İkisi de “claude” veya “anthropic” içeren adları reddeder.
Claude Code'dan neler taşınmaz?
Codex yalnızca name, description ve metadata altındaki kısa bir açıklamayı okur. OpenCode 2.2 bunlara ek olarak metadata ve disable-model-invocation alanlarını da okur. İkisi de diğer tüm alanları hata vermeden yok sayar; yani bir Claude Code skill'i yüklenir ama farklı davranır.
| Claude Code skill'inde | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | Çalışır | Yok sayılır | Yok sayılır |
disable-model-invocation: true | Çalışır | Yok sayılır; agents/openai.yaml kullanın | Çalışır |
context: fork, agent, model, hooks, argument-hint | Çalışır | Yok sayılır | Yok sayılır |
Metindeki $ARGUMENTS ve $1 | Argümanlarınızla değiştirilir | Metin olarak kalır | Metin olarak kalır |
Metindeki !`command` | Claude skill'i okumadan önce çalışır | Metin olarak kalır | Metin olarak kalır |
${CLAUDE_SKILL_DIR} | Skill'in klasörüyle değiştirilir | Metin olarak kalır | Metin olarak kalır |
- Bu özellikler olmadan da çalışan adımlar yazın.
${CLAUDE_SKILL_DIR}kullanmak yerine “scripts/check.sh dosyasını bu skill'in klasöründen çalıştır” deyin;$ARGUMENTSkullanmak yerine eksik bilgileri sade bir dille isteyin. Claude Code da aynı talimatları sorunsuz izler. - Codex'in bir skill'i kendiliğinden çağırmasını engellemek için skill klasörüne
agents/openai.yamlekleyin veallow_implicit_invocation: falsedeğerinipolicyaltına yazın. Skill'i yine de$skill-nameile çağırabilirsiniz. allowed-tools, Codex'in veya OpenCode'un yapabileceklerini sınırlamaz.npx skillsuyumluluk tablosu bu alanı ikisinde de destekleniyor olarak gösteriyor, ama iki aracın skill yükleyicisi de bu alanı okumuyor. Sınırları her aracın kendi izin ayarlarında belirleyin.
Skill'leri birden fazla ajana kuran araçlar
| Araç | Skill'leri nasıl paylaşır | Nelere dikkat etmeli |
|---|---|---|
npx skills (Vercel, 38.500 yıldız) | Bir skill'i .agents/skills içine kopyalar ve her ajanın klasörünü ona bağlar. Windows'ta junction kullanır. --copy ayrı kopyalar oluşturur. | Bu rehberle aynı düzen. npx skills add owner/repo çalıştırın; kullanıcı klasörünüz için -g ekleyin. |
| skillshare (2.900 yıldız) | Tek bir kaynak klasör tutar ve onu her aracın klasörüne bağlar; Windows'ta junction kullanır. | 6 Kasım 2026'da güncellendi. Homebrew veya bir kabuk betiğiyle kurulur. |
Codex /import | Skill'leri .claude/skills içinden .agents/skills içine kopyalar. | Kopyalar zamanla orijinallerden ayrışır. Ayrıca metindeki “claude” kelimesini, dosya yollarının içinde bile, “Codex” olarak değiştirir (açık issue #40147). |
| openskills (10.800 yıldız) | Skill'leri .claude/skills içine kopyalar ve AGENTS.md'de listeler. | Ocak 2026'dan beri yeni sürüm yok. --universal seçeneği .agent/skills klasörüne yazar; üç araçtan hiçbiri bu klasörü okumaz. |
Peki CLAUDE.md ve AGENTS.md?
Codex ve OpenCode AGENTS.md dosyasını okur; OpenCode, projede AGENTS.md yoksa CLAUDE.md'ye geri döner. 2.1.277 sürümünden beri Claude Code da AGENTS.md'yi okuyor, ama yalnızca CLAUDE.md veya CLAUDE.local.md bulunmayan bir projede. İki dosyayı birden tutuyorsanız Claude Code'da /config açın ve Project instructions ayarını ikisini de yükleyecek şekilde değiştirin. Her ajanın uyması gereken kuralları AGENTS.md'ye koyun, CLAUDE.md'yi ise yalnızca Claude Code'un ihtiyaç duyduğu şeyler için kullanın.
Aynı skill'leri Orkas'tan kullanın
Orkas; Claude Code, Codex, OpenCode, OpenClaw ve Hermes'i tek bir sohbette ajan olarak çalıştıran bir masaüstü uygulamasıdır. Bilgisayarınızda kurulu kopyaları ve kendi oturum açma bilgilerinizi kullanır. Skill'leriniz bu ajanlara şöyle ulaşır.
- Ortak klasör çalışmaya devam eder. Orkas her CLI'ı başlattığında CLI yine kendi skill klasörlerini okur; yani yukarıdaki kurulum değişmeden çalışır. Orkas sizin MCP sunucularınızın yerine geçmez, onların yanına kendi MCP sunucusunu ekler.
- Orkas'ta eklediğiniz skill'ler her CLI'a ulaşır. Orkas'ın başlattığı her CLI,
orkasadlı bir MCP sunucusu alır. Bu sunucu Orkas skill'lerinizi listeler, görev eşleştiğinde birini yükler ve skill'le birlikte gelen betikleri çalıştırır. Claude Code'dan bir skill'i adıyla kullanmasını isteyin ya da doğru olanı kendisinin bulmasına izin verin. - Orkas, Claude Code ve Codex skill'lerinizi de okur.
~/.claude/skillsve~/.codex/skillsiçindeki skill'ler Beceriler ▸ Genel klasörler altında görünür ve Commander bunları kendi görevlerinde kullanabilir. Orkas bu klasörleri yalnızca okur, asla değiştirmez.~/.agents/skillsklasörünü doğrudan okumaz; bu yüzden yukarıdaki kurulumla skill'lerinizi~/.claude/skillsiçindeki bağlantılar üzerinden bulur.
GitHub'dan bir skill paketi eklemek için depo bağlantısını Commander ile bir sohbete yapıştırın ve paketi kurmasını isteyin. Paketin bağımlılık kurması gerekiyorsa Orkas önce size sorar. Skill'ler Beceriler ▸ Harici paketler altında görünür. Bundan sonra Claude Code, Codex ve OpenCode'u Orkas'tan çalıştırdığınızda hepsi bu skill'leri kullanabilir; üç klasöre hiçbir şey kopyalamanız gerekmez. Başlamak için kenar çubuğunda Ajanları bağla seçeneğini seçin ve kurulu CLI'larınızı işaretleyin. İkisini yan yana çalıştırmanın ayrıntılı anlatımı için Claude Code ve Codex Birlikte Nasıl Çalıştırılır? yazısına bakın.
Hangi kurulumu seçmelisiniz?
| Durumunuz | Yapmanız gereken |
|---|---|
| Bu araçlardan ikisini veya üçünü tek bir bilgisayarda kullanıyorsunuz | Skill'leri ~/.agents/skills içinde tutun ve her birini ~/.claude/skills içine bağlayın |
| Bir ekip skill'leri bir depoda paylaşıyor | .agents/skills klasörünü commit edin; .claude/skills bağlantılarını bir kurulum betiğiyle oluşturun |
| Sık sık GitHub'dan skill kuruyorsunuz | Aynı bağlantıları sizin için kuran npx skills add |
| Yalnızca Claude Code ve OpenCode kullanıyorsunuz | ~/.claude/skills kullanmaya devam edin; OpenCode onu zaten okuyor |
| CLI'ları Orkas'tan çalıştırıyorsunuz | Skill paketlerini Orkas'ta bir kez kurun; Orkas'ın başlattığı her CLI bunları kullanabilir |
Sorular
Claude skill'lerini Codex'te kullanabilir miyim?
Evet. Codex aynı SKILL.md formatını okur, ama ~/.claude/skills içinde değil, ~/.agents/skills ve .agents/skills içinde arar. Skill klasörlerini oraya taşıyıp Claude Code için geri bağlayın ya da kopyalamak için Codex'te /import çalıştırın. allowed-tools gibi alanlar ve $ARGUMENTS gibi özellikler yalnızca Claude Code'da çalışır.
OpenCode, Claude Code skill'lerini okur mu?
Evet. OpenCode ~/.claude/skills ve .claude/skills klasörlerini, ayrıca ~/.agents/skills ve kendi klasörlerini okur; bu yüzden Claude Code skill'leri hiçbir kurulum gerekmeden görünür. Bunu kapatmak için OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 ayarlayın.
Claude Code .agents/skills klasörünü okur mu?
Hayır. Kasım 2026 itibarıyla Claude Code skill'leri yalnızca .claude klasörlerinden okur ve belgeleri, .agents dizini altındaki her şeyi yok saydığını söylüyor. Bunu ekleme talebi olan issue #31005 hâlâ açık. O zamana kadar her skill'i ~/.claude/skills içinden bağlayın.
Codex bağlantılı skill'imi neden görmüyor?
Codex bağlantılı bir skill klasörünü takip eder, ama kendisi bağlantı olan bir SKILL.md dosyasını yok sayar. Bunun yerine klasörün tamamını bağlayın. Göreli bir bağlantı, bulunduğu klasöre göre çözümlenir; bu yüzden yolun oradan bakıldığında doğru olduğunu kontrol edin.
Bir skill neden iki kez görünüyor?
Genellikle aracın okuduğu klasörlerde iki kopya olduğu için. Codex, ~/.agents/skills klasörünün yanı sıra eski ~/.codex/skills klasörünü de hâlâ okur ve aynı adlı bir skill'in iki kopyasını da listeler. ~/.agents/skills içinde bir kopya tutun, diğerini silin.
Üç aracı skill'lerin ötesinde karşılaştırmak için Claude Code, Codex ve OpenCode sayfasına bakın.