Orkas Orkas
Ana sayfa Blog Codex ve OpenCode'da skill'ler
Ürün

Claude Code, Codex ve OpenCode'da tek bir skill seti nasıl kullanılır?

Üçü de aynı SKILL.md formatını yükler, ama her biri farklı klasörlere bakar. Burada her aracın nereye baktığını, üçünün de yüklediği tek bir kopyayı nasıl tutacağınızı, Claude Code'dan nelerin taşınmadığını ve Orkas'ın çalıştırdığı her CLI'a aynı skill'leri nasıl verdiğini bulacaksınız.

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örClaude CodeCodexOpenCode
~/.agents/skillsHayırEvetEvet
Projedeki .agents/skillsHayırEvetEvet
~/.claude/skillsEvetHayırEvet
Projedeki .claude/skillsEvetHayırEvet
~/.codex/skillsHayırEvet, ama kullanımdan kaldırıldıHayır
~/.config/opencode/skills, .opencode/skillsHayırHayırEvet
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/skills klasörünü bulamayan araç Claude Code. Skill belgeleri yalnızca .claude klasö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/skills klasörüne geçti. Belgeleri projede .agents/skills, sizin için ~/.agents/skills ve yöneticiler için /etc/codex/skills klasörlerini listeliyor. Eski ~/.codex/skills klasörü kaynak kodda kullanımdan kaldırıldı olarak işaretli, ama hâlâ yükleniyor. Codex hiçbir .claude klasörünü okumuyor.
  • OpenCode her şeyi okur. Belgeleri kendi klasörlerinin yanı sıra .claude/skills ve .agents/skills klasö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.

  1. Skill'lerinizi ~/.agents/skills içine taşıyın. ~/.claude/skills veya ~/.codex/skills içinde yazdığınız her skill'in klasörünü taşıyın; örneğin mv ~/.claude/skills/release-notes ~/.agents/skills/. ~/.claude/skills/synced klasörünü yerinde bırakın: Claude Code, claude.ai hesabınızdaki skill'leri orada tutar.
  2. 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
  1. 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 }
}
  1. 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/skills klasörünün kendisi ~/.agents/skills klasörünü gösterirse Claude Code'un synced ve .trash klasö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/skills içindeki bağlantıyı hem de ~/.agents/skills iç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çin OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 ayarlayı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 name alanı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'indeClaude CodeCodexOpenCode 2.2
allowed-toolsÇalışırYok sayılırYok sayılır
disable-model-invocation: trueÇalışırYok sayılır; agents/openai.yaml kullanınÇalışır
context: fork, agent, model, hooks, argument-hintÇalışırYok sayılırYok sayılır
Metindeki $ARGUMENTS ve $1Argümanlarınızla değiştirilirMetin olarak kalırMetin olarak kalır
Metindeki !`command`Claude skill'i okumadan önce çalışırMetin olarak kalırMetin olarak kalır
${CLAUDE_SKILL_DIR}Skill'in klasörüyle değiştirilirMetin olarak kalırMetin 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; $ARGUMENTS kullanmak 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.yaml ekleyin ve allow_implicit_invocation: false değerini policy altına yazın. Skill'i yine de $skill-name ile çağırabilirsiniz.
  • allowed-tools, Codex'in veya OpenCode'un yapabileceklerini sınırlamaz. npx skills uyumluluk 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şırNelere 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 /importSkill'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, orkas adlı 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/skills ve ~/.codex/skills iç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/skills klasörünü doğrudan okumaz; bu yüzden yukarıdaki kurulumla skill'lerinizi ~/.claude/skills iç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.

Orkas'tan çalıştırın Claude Code, Codex ve OpenCode'a tek bir uygulamadan aynı skill'leri verin. Orkas, macOS ve Windows'ta ücretsizdir. Zaten sahip olduğunuz CLI'ları kendi oturum açma bilgilerinizle çalıştırır.
Orkas'ı ücretsiz indirin

Hangi kurulumu seçmelisiniz?

DurumunuzYapmanız gereken
Bu araçlardan ikisini veya üçünü tek bir bilgisayarda kullanıyorsunuzSkill'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 kuruyorsunuzAynı 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ıyorsunuzSkill 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.