最近 Claude Code と Codex を両方使うようになって、スキルの管理が面倒になってきた🐧
どちらも skills ディレクトリを持っていて、同じ内容をそれぞれにクローンして持っていたんだけど、片方を更新すると片方が古くなる問題が地味にストレスだった。
解決策はシンプルで、~/.codex/skills を ~/.claude/skills へのシンボリックリンクにするだけ。
調べたら同じことをやっている人はいたし、やること自体は数コマンドで終わる。
まず結論
rm -rf ~/.codex/skills
ln -s ~/.claude/skills ~/.codex/skills
# 確認
ls -la ~/.codex/skills
# lrwxrwxrwx ... ~/.codex/skills -> ~/.claude/skillsこれだけ！！
あとは ~/.claude/skills/ を正として管理すれば、Codex 側でも同じスキルが自動的に使える。
何が問題だったか
Claude Code のスキルは ~/.claude/skills/ に置く。
Codex のスキルは ~/.codex/skills/ に置く。
最初は両方に同じ Git リポジトリをクローンしていた。
「どちらか一方で更新して push → もう一方で pull」という運用を想定していたんだけど、これが案の定面倒になった。
スキルをちょっと直したいとき、Claude Code のセッション中に編集して……push するの忘れる。
しばらく後に Codex で作業したら古いスキルが動いてる、みたいな状況が続いた。
解決策：symlink にする
発想はシンプル。
どうせ同じ中身なら、片方をもう片方への参照にしてしまえばいい。
Claude Code の方がよく使うので ~/.claude/skills/ を正として、~/.codex/skills をそこへの symlink にした。
こうすると「どちらで作業しているか」を気にせず、スキルを編集すれば即座に両方に反映される。
手順
1. 既存の ~/.codex/skills を確認する
ls ~/.codex/skills~/.claude/skills/ と同じ内容なら迷わず削除。
2. 削除して symlink を貼る
rm -rf ~/.codex/skills
ln -s ~/.claude/skills ~/.codex/skills3. 確認
ls -la ~/.codex/
# lrwxrwxrwx 1 user user 20 Feb 17 15:25 skills -> ~/.claude/skillsskill-builder への記載
この構成にしたことで「Codex でスキルを作ろうとしても Claude Code の skill-builder が使われる」という状態になる。
セッションをまたいだ時に忘れないよう、skill-builder の SKILL.md に一言添えておいた。
**Codex と Claude Code のスキルは同一ディレクトリ:**
`~/.codex/skills` は `~/.claude/skills` へのシンボリックリンク。
→ Codex でスキルを作る場合も、同じ配置先・ワークフローに従う。
どちらのツールで作業していても、個人スキルは `~/.claude/skills/` に統合される。AI が「あ、そういう構成なんだ」と理解してくれるので、スキル追加のときにいちいち説明しなくて済む。
まとめ
~/.codex/skillsを削除してln -s ~/.claude/skills ~/.codex/skillsで symlink にする- Claude Code を正として管理すれば Codex でも即反映
- Git 管理が不要になったので
.gitも削除してスッキリ - skill-builder にこの構成の旨を記載しておくと AI が迷わない
以上！！
誰かのお役に立てれば嬉しいです🐧
