Orkas Orkas
Beranda Blog Skill di Codex dan OpenCode
Produk

Cara Memakai Satu Set Skill di Claude Code, Codex, dan OpenCode

Ketiganya memuat format SKILL.md yang sama, tetapi masing-masing mencari di folder yang berbeda. Berikut tempat setiap alat mencari, cara menyimpan satu salinan yang dimuat ketiganya, apa yang tidak ikut terbawa dari Claude Code, dan cara Orkas memberikan skill yang sama ke setiap CLI yang dijalankannya.

Claude Code, Codex, dan OpenCode semuanya memuat skill dalam format yang sama: sebuah folder berisi file SKILL.md. Format ini adalah standar terbuka Agent Skills, yang dibuat oleh Anthropic dan menjadi proyek Linux Foundation pada 4 November 2026. Jadi satu skill bisa berjalan di ketiga alat itu. Masalahnya, setiap alat mencari di folder yang berbeda, dan beberapa field hanya dipahami oleh Claude Code. Panduan ini menunjukkan di mana setiap alat mencari, cara menyimpan satu salinan yang dimuat ketiganya, apa yang tidak ikut terbawa, dan bagaimana Orkas memberikan skill yang sama ke setiap agen coding yang dijalankannya.

Jawaban singkatnya: simpan setiap folder skill di ~/.agents/skills. Codex dan OpenCode sudah membaca folder itu. Claude Code tidak, jadi tambahkan link ke setiap skill di ~/.claude/skills. Batasi frontmatter pada name dan description, dan beri setiap skill nama yang sama dengan foldernya. Diperiksa pada 8 November 2026 dengan Claude Code 2.1.319, Codex 0.167.0, dan OpenCode 2.2.6.

Di mana Claude Code, Codex, dan OpenCode mencari skill

FolderClaude CodeCodexOpenCode
~/.agents/skillsTidakYaYa
.agents/skills di proyekTidakYaYa
~/.claude/skillsYaTidakYa
.claude/skills di proyekYaTidakYa
~/.codex/skillsTidakYa, tetapi sudah usangTidak
~/.config/opencode/skills, .opencode/skillsTidakTidakYa
Cara memanggil skill/skill-name$skill-name atau /skills@skill-name

Ketiganya juga memilih skill sendiri saat permintaan Anda cocok dengan deskripsinya. Untuk folder proyek, setiap alat memeriksa folder tempat Anda menjalankannya dan setiap folder induk hingga root repositori.

  • Hanya Claude Code yang tidak akan menemukan .agents/skills. Dokumentasi skill Claude Code hanya mencantumkan folder .claude, dan dokumentasi memorinya menyebutkan bahwa Claude Code tidak membaca “apa pun di bawah direktori .agents/”. Permintaan untuk mengubahnya, issue #31005, masih terbuka dengan lebih dari 450 upvote.
  • Codex pindah ke .agents/skills. Dokumentasinya mencantumkan .agents/skills di proyek, ~/.agents/skills untuk Anda, dan /etc/codex/skills untuk admin. Folder lama ~/.codex/skills ditandai usang di kode sumber, tetapi masih dimuat. Codex tidak membaca folder .claude mana pun.
  • OpenCode membaca semuanya. Dokumentasinya mencantumkan folder miliknya sendiri serta .claude/skills dan .agents/skills, di kedua tingkat. Ini berlaku untuk lini 2.2 dan juga lini 1.19, yang masih terus dirilis.

Siapkan satu folder bersama

Gunakan ~/.agents/skills sebagai satu-satunya salinan asli. Codex dan OpenCode membacanya tanpa penyiapan apa pun, dan npx skills serta pengimpor Codex sama-sama menulis ke sana. Lalu Claude Code mendapat link ke setiap skill.

  1. Pindahkan skill Anda ke ~/.agents/skills. Untuk setiap skill yang Anda tulis di ~/.claude/skills atau ~/.codex/skills, pindahkan foldernya, misalnya mv ~/.claude/skills/release-notes ~/.agents/skills/. Biarkan ~/.claude/skills/synced di tempatnya: Claude Code menyimpan skill dari akun claude.ai Anda di sana.
  2. Tautkan setiap skill ke folder Claude Code. Di macOS atau Linux, jalankan skrip ini. Skrip ini melewati skill yang sudah punya folder atau link di sana.
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. Di Windows, gunakan junction. Junction tidak memerlukan hak admin. Di PowerShell:
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. Periksa setiap alat. Mulai sesi baru. Di Claude Code, ketik / dan cari skill-nya. Di Codex, jalankan /skills. Di OpenCode, ketik @.

Untuk proyek yang dipakai bersama tim, lakukan hal yang sama di dalam repositori: simpan skill di .agents/skills dan tautkan masing-masing dari .claude/skills dengan link relatif seperti ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.

Beberapa hal yang perlu diperhatikan:

  • Tautkan setiap skill, bukan seluruh folder. Jika ~/.claude/skills sendiri menunjuk ke ~/.agents/skills, folder synced dan .trash milik Claude Code akan masuk ke folder bersama, dan Codex serta OpenCode mungkin ikut memuat skill hasil sinkronisasi. Konsekuensinya, Anda perlu menjalankan loop lagi setelah menambahkan skill.
  • Tautkan folder, bukan file SKILL.md. Codex mengikuti folder skill yang ditautkan, tetapi mengabaikan SKILL.md yang dirinya sendiri adalah link. OpenAI menutup permintaan itu sebagai tidak direncanakan.
  • Jangan commit link jika ada rekan tim yang memakai Windows. Secara default, Git for Windows melakukan checkout link sebagai file teks kecil. Buat link dengan skrip penyiapan, atau commit salinan asli.
  • OpenCode melihat setiap skill dua kali dan menyimpan satu. OpenCode membaca link di ~/.claude/skills sekaligus folder di ~/.agents/skills. Versi 2.2 menggabungkannya tanpa pemberitahuan. Versi 1.19 mencatat peringatan duplikat di log; atur OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 agar OpenCode berhenti membaca folder Claude.

Tulis skill yang bisa dimuat ketiganya

SKILL.md ini dimuat dengan cara yang sama di Claude Code, Codex, dan OpenCode. Letaknya di ~/.agents/skills/release-notes/SKILL.md, dengan folder references dan folder scripts di sebelahnya.

---
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
---

# Catatan rilis

1. Cari tag terakhir: git describe --tags --abbrev=0
2. Daftar commit sejak tag itu: git log <tag>..HEAD --oneline --no-merges
3. Kelompokkan commit ke dalam Added, Changed, dan Fixed, mengikuti references/format.md di folder skill ini.
4. Untuk menyimpan file, jalankan scripts/write_notes.sh dari folder skill ini.
  • Beri skill nama yang sama dengan foldernya. Gunakan huruf kecil, angka, dan tanda hubung, maksimal 64 karakter. Codex berpatokan pada name, OpenCode 2.2 pada nama folder, dan Claude Code menerima keduanya. Jika keduanya berbeda, Anda memanggil skill yang sama dengan nama berbeda di setiap alat. Codex melewati skill yang namanya lebih dari 64 karakter.
  • Buat deskripsi kurang dari 1.024 karakter dan taruh kata-kata yang akan dipakai orang di bagian depan. Itu batas dari standarnya, dan Codex memotong deskripsi yang lebih panjang hingga panjang itu di daftar skill-nya.
  • Beri tanda kutip pada setiap nilai yang mengandung titik dua yang diikuti spasi. Jika tidak, frontmatter mungkin gagal di-parse. Codex memperbaiki sebagian besar kasus ini, Claude Code memuat skill seolah-olah tidak ada frontmatter, dan OpenCode bisa melewati skill tanpa error.
  • Buat skrip menemukan foldernya sendiri. Alat-alat ini menjalankan perintah dari folder proyek Anda, bukan dari folder skill. Skrip yang diawali cd "$(dirname "$0")" bisa berjalan dari mana saja.
  • Jangan pakai “claude” di nama jika Anda mungkin mengunggah skill ke claude.ai atau Claude API. Keduanya menolak nama yang mengandung “claude” atau “anthropic”.

Apa yang tidak ikut terbawa dari Claude Code

Codex hanya membaca name, description, dan deskripsi singkat di bawah metadata. OpenCode 2.2 juga membaca metadata dan disable-model-invocation. Keduanya mengabaikan semua field lain tanpa error, jadi skill Claude Code tetap dimuat tetapi berperilaku berbeda.

Di skill Claude CodeClaude CodeCodexOpenCode 2.2
allowed-toolsBerfungsiDiabaikanDiabaikan
disable-model-invocation: trueBerfungsiDiabaikan; pakai agents/openai.yamlBerfungsi
context: fork, agent, model, hooks, argument-hintBerfungsiDiabaikanDiabaikan
$ARGUMENTS dan $1 di teksDiganti dengan argumen AndaTetap sebagai teksTetap sebagai teks
!`command` di teksDijalankan sebelum Claude membaca skillTetap sebagai teksTetap sebagai teks
${CLAUDE_SKILL_DIR}Diganti dengan folder skillTetap sebagai teksTetap sebagai teks
  • Tulis langkah yang berjalan tanpa fitur-fitur ini. Tulis “jalankan scripts/check.sh dari folder skill ini” alih-alih memakai ${CLAUDE_SKILL_DIR}, dan minta detail yang kurang dengan kata-kata biasa alih-alih memakai $ARGUMENTS. Claude Code tetap mengikuti instruksi yang sama dengan baik.
  • Agar Codex tidak memanggil skill dengan sendirinya, tambahkan agents/openai.yaml ke folder skill dengan allow_implicit_invocation: false di bawah policy. Anda tetap bisa memanggilnya dengan $skill-name.
  • allowed-tools tidak membatasi apa yang bisa dilakukan Codex atau OpenCode. Tabel kompatibilitas npx skills mencantumkannya sebagai didukung di keduanya, tetapi loader skill di kedua alat itu tidak membaca field tersebut. Atur batasan di pengaturan izin masing-masing alat.

Alat yang memasang skill untuk beberapa agen

AlatCara berbagi skillYang perlu diperhatikan
npx skills (Vercel, 38.500 bintang)Menyalin skill ke .agents/skills dan menautkan folder setiap agen ke sana. Memakai junction di Windows. --copy membuat salinan terpisah.Tata letaknya sama dengan panduan ini. Jalankan npx skills add owner/repo, dengan -g untuk folder pengguna Anda.
skillshare (2.900 bintang)Menyimpan satu folder sumber dan menautkannya ke folder setiap alat; memakai junction di Windows.Diperbarui 6 November 2026. Dipasang lewat Homebrew atau skrip shell.
Codex /importMenyalin skill dari .claude/skills ke .agents/skills.Salinannya lama-lama berbeda dari aslinya. Alat ini juga mengubah “claude” menjadi “Codex” di teks, termasuk di dalam path file (issue terbuka #40147).
openskills (10.800 bintang)Menyalin skill ke .claude/skills dan mencantumkannya di AGENTS.md.Tidak ada rilis sejak Januari 2026. Opsi --universal menulis ke .agent/skills, yang tidak dibaca oleh satu pun dari ketiga alat.

Bagaimana dengan CLAUDE.md dan AGENTS.md?

Codex dan OpenCode membaca AGENTS.md, dan OpenCode beralih ke CLAUDE.md jika proyek tidak punya AGENTS.md. Sejak versi 2.1.277, Claude Code juga membaca AGENTS.md, tetapi hanya di proyek yang tidak punya CLAUDE.md atau CLAUDE.local.md. Jika Anda menyimpan kedua file, buka /config di Claude Code dan atur Project instructions agar memuat keduanya. Taruh aturan yang harus diikuti setiap agen di AGENTS.md, dan gunakan CLAUDE.md untuk hal-hal yang hanya dibutuhkan Claude Code.

Pakai skill yang sama dari Orkas

Orkas adalah aplikasi desktop yang menjalankan Claude Code, Codex, OpenCode, OpenClaw, dan Hermes sebagai agen dalam satu chat. Orkas memakai salinan yang terpasang di komputer Anda dan login Anda sendiri. Begini cara skill Anda sampai ke agen-agen itu.

  • Folder bersama tetap berfungsi. Setiap CLI tetap membaca folder skill-nya sendiri saat Orkas menjalankannya, jadi penyiapan di atas berjalan tanpa perubahan. Orkas menambahkan server MCP-nya sendiri di samping milik Anda, bukan menggantikannya.
  • Skill yang Anda tambahkan di Orkas sampai ke setiap CLI. Setiap CLI yang dijalankan Orkas mendapat server MCP bernama orkas. Server ini menampilkan daftar skill Orkas Anda, memuat salah satunya saat tugasnya cocok, dan menjalankan skrip yang disertakan skill tersebut. Minta Claude Code memakai skill berdasarkan namanya, atau biarkan Claude Code menemukan yang tepat.
  • Orkas juga membaca skill Claude Code dan Codex Anda. Skill di ~/.claude/skills dan ~/.codex/skills muncul di Keterampilan ▸ Folder global, dan Komandan bisa memakainya dalam tugasnya sendiri. Orkas hanya membaca folder ini dan tidak pernah mengubahnya. Orkas tidak membaca ~/.agents/skills secara langsung, jadi dengan penyiapan di atas, Orkas menemukan skill Anda lewat link di ~/.claude/skills.

Untuk menambahkan paket skill dari GitHub, tempelkan link repositori ke chat dengan Komandan dan minta Komandan memasang paket itu. Jika paket perlu memasang dependensi, Orkas akan bertanya kepada Anda terlebih dahulu. Skill-nya muncul di Keterampilan ▸ Paket eksternal. Sejak itu, Claude Code, Codex, dan OpenCode semuanya bisa memakainya saat Anda menjalankannya dari Orkas, tanpa menyalin apa pun ke tiga folder. Untuk memulai, pilih Agen penghubung di sidebar lalu pilih CLI yang sudah Anda pasang. Untuk panduan lengkap menjalankan dua di antaranya berdampingan, lihat Cara Menjalankan Claude Code dan Codex Bersama-sama.

Jalankan dari Orkas Berikan skill yang sama ke Claude Code, Codex, dan OpenCode dari satu aplikasi. Orkas gratis di macOS dan Windows. Orkas menjalankan CLI yang sudah Anda punya, dengan login Anda sendiri.
Unduh Orkas — gratis

Penyiapan mana yang sebaiknya Anda pilih?

Situasi AndaLakukan ini
Anda memakai dua atau tiga alat ini di satu komputerSimpan skill di ~/.agents/skills dan tautkan masing-masing ke ~/.claude/skills
Tim berbagi skill di repositoriCommit .agents/skills; buat link .claude/skills dengan skrip penyiapan
Anda sering memasang skill dari GitHubnpx skills add, yang menyiapkan link yang sama untuk Anda
Anda hanya memakai Claude Code dan OpenCodeTetap pakai ~/.claude/skills; OpenCode sudah membacanya
Anda menjalankan CLI dari OrkasPasang paket skill sekali di Orkas; setiap CLI yang dijalankannya bisa memakainya

Pertanyaan

Bisakah saya memakai skill Claude di Codex?

Bisa. Codex membaca format SKILL.md yang sama, tetapi mencari di ~/.agents/skills dan .agents/skills, bukan di ~/.claude/skills. Pindahkan folder skill ke sana dan tautkan kembali untuk Claude Code, atau jalankan /import di Codex untuk menyalinnya. Field seperti allowed-tools dan fitur seperti $ARGUMENTS hanya berfungsi di Claude Code.

Apakah OpenCode membaca skill Claude Code?

Ya. OpenCode membaca ~/.claude/skills dan .claude/skills serta ~/.agents/skills dan folder miliknya sendiri, jadi skill Claude Code muncul tanpa penyiapan apa pun. Untuk mematikannya, atur OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.

Apakah Claude Code membaca .agents/skills?

Tidak. Per November 2026, Claude Code hanya membaca skill dari folder .claude, dan dokumentasinya menyebutkan bahwa Claude Code mengabaikan semua isi direktori .agents. Permintaan untuk menambahkannya, issue #31005, masih terbuka. Sampai saat itu, tautkan setiap skill dari ~/.claude/skills.

Kenapa Codex tidak melihat skill yang saya tautkan?

Codex mengikuti folder skill yang ditautkan, tetapi mengabaikan file SKILL.md yang dirinya sendiri adalah link. Tautkan seluruh foldernya saja. Link relatif di-resolve dari folder tempat link itu berada, jadi periksa apakah path-nya benar dari sana.

Kenapa sebuah skill muncul dua kali?

Biasanya karena ada dua salinan di folder yang dibaca alat tersebut. Codex masih membaca folder lama ~/.codex/skills selain ~/.agents/skills, dan menampilkan kedua salinan skill dengan nama yang sama. Simpan satu salinan di ~/.agents/skills dan hapus yang lain.

Untuk membandingkan ketiga alat di luar soal skill, lihat Claude Code vs Codex vs OpenCode.