distribute-skill-to-all-agents

すべてのエージェントにスキルを配布する

すべてのエージェントが検出できるようにするには、ユーザーの Mac 上にある 5 か所すべてに、直接またはシンボリックリンク経由でグローバルスキルを配置する必要があります。

スキルの場所

• Codex / OpenAI Agents: ~/.agents/skills/ が正規の場所です。まずここでスキルを作成します。
• Claude Code: ~/.claude/skills/ → ~/.agents/skills/。自動的に対応します。
• Pi Agent: ~/.pi/agent/skills/ → ~/.agents/skills/。自動的に対応します。ネストされた /agent/ が必須であり、~/.pi/skills/ ではありません。
• Hermes Agent: ~/.hermes/skills/ は独立したコピーです。コピーが必要なのは Hermes だけです。
• Cursor (IDE + CLI): ~/.cursor/skills/ は実フォルダーで、~/.agents/skills/ を確実には読み込みません。スキルごとにシンボリックリンクを追加します。Cursor の組み込みスキルが格納されている ~/.cursor/skills-cursor/ は絶対に使用しないでください。

ワークフロー

1. effective-agent-skills に従って、~/.agents/skills/<skill-name>/SKILL.md にスキルを作成します。
2. Claude のシンボリックリンクを確認します（初回のみ）：

   ls -la ~/.claude/skills
   # Expect: ~/.claude/skills -> ~/.agents/skills
   

   実ディレクトリの場合はコピーが分岐しています。変更する前に確認してください。
3. Hermes にコピーします。Claude と Pi はシンボリックリンクで対応済みです：

   SKILL=<skill-name>
   cp -r ~/.agents/skills/$SKILL ~/.hermes/skills/
   

4. Cursor にシンボリックリンクを作成します（すでに存在する場合はスキップ）：

   [ -e ~/.cursor/skills/$SKILL ] || ln -s ~/.agents/skills/$SKILL ~/.cursor/skills/$SKILL
   

   Cursor に実コピーがあり、内容が異なる場合は、バージョンを比較してから置き換える前に確認してください。
5. 5 か所すべてでバイト数が一致することを確認します：

   for p in ~/.agents/skills/$SKILL ~/.claude/skills/$SKILL ~/.pi/agent/skills/$SKILL ~/.hermes/skills/$SKILL ~/.cursor/skills/$SKILL; do
     echo "$p: $(wc -c < $p/SKILL.md) bytes"
   done
   

   5 つの数値がすべて一致している必要があります。Claude、Pi、Cursor のいずれかが異なる場合は、続行する前にシンボリックリンクを調査してください。

既存のスキルを更新する

~/.agents/skills/ から ~/.hermes/skills/ に再コピーします。Claude、Pi、およびシンボリックリンクされた Cursor のスキルは自動的に更新されます。cp -r はデフォルトで上書きします。ネストされたファイルが削除されている可能性がある場合は、rsync -a --delete を使用します：

rsync -a --delete ~/.agents/skills/$SKILL/ ~/.hermes/skills/$SKILL/

注意点

• ~/.pi/skills/ はグローバルな場所として誤りです。 Pi は ~/.pi/agent/skills/ から読み込みます。前者にあるスキルは認識されない孤立ファイルになります。削除する前にユーザーに確認してください。
• Claude または Pi のシンボリックリンク先にはコピーしないでください。 これらはすでに ~/.agents/skills/ を参照しており、そこへコピーすると「are identical」というエラーが発生します。独立しているのは Hermes だけです。ユーザーから依頼がない限り、Hermes をシンボリックリンクに置き換えないでください。
• プロジェクト固有のスキルは、名前が重複するとグローバルスキルより優先されることがあります（後から検出されたものが優先）。リポジトリ内の ./.pi/agent/skills/ や .pi/skills/ も対象です。このワークフローで扱うのはグローバル配布のみです。
• Hermes と Cursor はセッション開始時にスキルを読み込みます。 新たに配布したスキルを認識させるには、実行中のセッションを再起動してください。
• 大文字と小文字を区別するボリュームでは、ファイル名の大文字・小文字が重要です。 SKILL.md を大文字で使用してください。

このスキルを使用しない場合

• プロジェクト固有のスキル： リポジトリ内の ./.claude/skills/、./.pi/agent/skills/ などを使用します。
• 単一エージェント向けの編集（例：Hermes のみ）：他へ反映せず、そのファイルを直接修正します。
• グローバルな削除： 削除は取り消せないため、まずユーザーに確認してください。~/.agents/skills/（Claude と Pi に適用）、~/.hermes/skills/、および ~/.cursor/skills/ のシンボリックリンクから rm -rf で削除します。