Claude Code・Codex・Cursor・OpenCode にスキルを同期する方法

各ツールが読む場所

各ツールのドキュメントより（2026 年 11 月 4 日に確認）。どのフォルダーも、スキルごとにフォルダーを 1 つ置き、その中に SKILL.md を入れます。

2 つのフォルダーで 4 つとも届きます。~/.claude/skills（Claude Code、Cursor、OpenCode）と ~/.agents/skills（Codex、Cursor、OpenCode）です。

自分のパソコンでコピーを 1 つに：シンボリックリンク

本物のファイルは 1 つのフォルダーに置き、2 つの場所からそこを指します。macOS か Linux なら、次のとおりです。

mkdir -p ~/skills
# 先に既存のスキルを移してから:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

どちらかのフォルダーがすでにあるなら、中身を ~/skills に移し、空になったフォルダーを消してからリンクします。Cursor と OpenCode は両方の場所を読むので、同じファイルに 2 つの道筋でたどり着きます。同じスキルが 2 つ表示されても、ファイルは 1 つです。直すのは ~/skills の 1 か所だけです。

リポジトリでも、.claude/skills と .agents/skills で同じようにし、本物のフォルダーをコミットします。クローンした人は全員、そのスキルを持てます。

チームでコピーを 1 つに：MCP サーバー

シンボリックリンクとリポジトリは、開発者には効きます。でも、ブラウザの Claude や ChatGPT で仕事をする同僚には届かず、新しい版にするには git pull が要ります。4 つのコーディング用の AI は、リモートの MCP サーバーにもつなげます。

• Claude Code：claude mcp add --transport http <name> <url>
• Codex：設定ファイルに、url = "…" を書いたサーバーの項目を足す（Streamable HTTP）。
• Cursor：MCP の設定に、Streamable HTTP のサーバーを足す。
• OpenCode：設定ファイルに、"type": "remote" のサーバーを足す。

チームのスキルを持つサーバーが 1 つあれば、コーディング用の AI も、Claude も ChatGPT も、同じ最新のコピーを読みます。pull することも、リンクし直すこともありません。

ツールがスキルを読めているか確かめる

1. 形を確かめる。<フォルダー>/<スキル名>/SKILL.md になっていて、スキルのフォルダーの名前が name と同じか。
2. フロントマターを確かめる。name は半角の小文字、数字、ハイフンで 64 文字まで。description は空にしない。SKILL.md 変換ツールなら、両方を書いてくれます。
3. 新しいセッションを始める。エージェントに、どんなスキルがあるか聞くか、説明に書いた作業を頼んでみます。

よくある質問

Claude Code のスキルを Claude のデスクトップや claude.ai とそろえるには？

Claude Code はディスクのフォルダーを読み、Claude のデスクトップと claude.ai はアップロードしたスキルをアカウントに持ちます。同じフォルダーを ZIP にして Customize → Skills からアップロードするか、スキルを配る 1 つの MCP サーバーに両方をつなぎます。

Claude Code が .agents/skills のフォルダーを読まないのはなぜ？

Claude Code が読むのは ~/.claude/skills と .claude/skills で、.agents/skills は読みません。上のシンボリックリンクの手順のように、フォルダーを ~/.claude/skills にリンクしてください。