はじめに
Claude Code には ~/.claude/skills/ に、Codex には ~/.codex/skills/ に、それぞれ skills を置く仕組みがある。
どちらも同じ SKILL.md 形式だが、置き場所が別々。手動で両方を同期していると、片方だけ更新してもう片方が古いままになりやすい。
これを、ソース元を一本化する仕組みでよしなにしているけど、便利。
使ってる仕組み
Claude Code 側はもともと自前の CLI で DB から展開する仕組みをすでに作っていた。Codex も同じ仕組みで対応できるはずなんだけど、追加するのが面倒くさくてずっと後回しにしてた。
DB を skills のソース元にして、CLI で両方のディレクトリに展開するようにした。
[DB（skills の定義）]
↕ MCP ツールで更新
[エージェント / Web UI]
↓ CLI で同期
~/.claude/skills/ ← Claude Code が読む
~/.codex/skills/ ← Codex が読む定義は DB で一元管理していて、MCP ツールでどこからでも更新できる。展開は CLI を実行するだけ。
ローカルの skill は直接編集しない
各ディレクトリに展開されたファイルは生成物扱いなので、直接は編集しない。
更新したいときは DB 側を MCP ツールで更新して CLI で再展開するだけ。ソース元が1箇所なのでずれる心配もない。
付随ファイルも同じ仕組みで展開できる
skills には references/ や assets/ などのサブディレクトリも置ける。
skills に付随するファイルも DB で一緒に管理できて、CLI を実行するだけで参照ファイルも含めてまとめて展開できる。
おわり
プロジェクトスコープの skills はあまり使ってないので今のところ対応してないけど、この辺りも設定を追加すれば同じ仕組みで便利に使えそう。改善の余地あり。
🔧