結論から
- 1フォルダ:
~/.claude/skills·~/.agents/skills(+ 旧~/.codex/skills)·~/.cursor/skills - 2実行:
/name(Claude Code、Cursor)·$name(Codex)· Cursor では@nameで添付 - 3インストール済みを確認:
/skills· Customize → Skills - 4インストール:
npx --yes skillry-cli@latest install <slug>、Claude Code なら--agent claude-codeを追加
エージェントごとの Skills フォルダ
個人用の Skill は、開くすべてのプロジェクトで使えます。プロジェクト用の Skill はリポジトリ内に置かれるため、クローンした全員が使えます。
| エージェント | 個人用 | プロジェクト用 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/(旧:~/.codex/skills/) | .agents/skills/、起動したフォルダからリポジトリのルートまで |
| Cursor | ~/.cursor/skills/、~/.agents/skills/ | .cursor/skills/、.agents/skills/ |
各エージェントが読み込むすべてのフォルダと、同じ名前が 2 つあるときにどちらが優先されるかは、Skill の保存場所をご覧ください。
Claude Code・Codex・Cursor の Skill コマンド
Skill を名前で呼び出すのが、インストールを確認する一番の近道です。実行されれば、エージェントはその Skill を認識しています。
| 操作 | Claude Code | Codex | Cursor |
|---|---|---|---|
| Skill の一覧 | /skills | /skills | Customize → Skills |
| 実行する | /name | $name | /name、@name |
| プラグインの Skill | /plugin:name | プラグイン経由 | プラグイン経由 |
| 常に有効にする | — | — | Option/Alt+Enter(Custom Mode) |
| 編集した後 | すぐ反映。新しいフォルダなら /reload-skills | すぐ反映。されなければ再起動 | 新しいチャットかウィンドウの再読み込み |
SKILL.md の frontmatter フィールド
各 Skill には SKILL.md ファイルがあり、設定は先頭の 2 本の --- 行の間に書かれます。エージェントによる扱いを変えるのは、次のフィールドです。
| フィールド | 制限/効果 | Claude Code | Codex | Cursor |
|---|---|---|---|---|
name | 64 文字以内。a–z、0–9、ハイフン。フォルダ名と一致させる | 任意 | 必須 | 必須 |
description | 1,024 文字以内。何をするのか、いつ使うのかを書く | 推奨 | 必須 | 必須 |
allowed-tools | 確認なしで使えるツール(仕様上は実験的) | 対応 | — | — |
paths | 一致するファイルパターンでのみ自動実行される | 対応 | — | 対応 |
Skillry CLI コマンド
Skillry CLI は Skillry から Skill をダウンロードし、エージェントに合ったフォルダに配置します。
| コマンド | 機能 |
|---|---|
skillry-cli login | デバイスコードを使い、ブラウザ経由でサインインします |
skillry-cli status | サインイン中のアカウントを表示します |
skillry-cli install <slug> | ~/.agents/skills/<slug>/ にインストールします |
--agent claude-code | …代わりに ~/.claude/skills/<slug>/ にインストールします |
--target <dir> | …任意の Skills フォルダ(例:.claude/skills)にインストールします |
--force | 既存のコピーを置き換え、バックアップを残します |
skillry-cli logout | サインアウトし、セッションを無効にします |
各コマンドの先頭には npx --yes skillry-cli@latest を付けてください。macOS または Windows と Node.js 22+ で動作します。--agent と --target は同時に使えません。
よくある質問
Claude Code で Skill を扱うコマンドは?
/skills で Skill を一覧表示、/skill-name で実行、/plugin-name:skill-name でプラグインに含まれる Skill を実行、/reload-skills で新しく作った Skills フォルダを読み込みます。
エージェントごとの違いはどこで解説されていますか?
エージェント比較で、同じ内容を具体例付きで解説しています。
出典
このガイドは役に立ちましたか?
