結論から
- 1すべてのプロジェクトで使うなら
~/.cursor/skills/（Cloud Agents に同期できる唯一のフォルダでもあります）に、1 つのプロジェクトだけで使うなら.cursor/skills/に Skill を置きます。 - 2
SKILL.mdのnameはフォルダ名と一致させ、小文字、数字、ハイフンだけを使う必要があります。 - 3Customize → Skills で確認できます。
/skill-nameで実行するか、@skill-nameでメッセージに添付します。 - 4すぐに使えるものがほしいなら、コマンド 1 つでインストールできる Cursor Skills をご覧ください。
Cursor が Skill を探す場所
Cursor は自身のフォルダ、共有の ~/.agents/skills/、さらに Claude Code と Codex のフォルダも確認します。すでにほかのエージェントを使っているなら、あなたの Skill はもう Cursor に入っているかもしれません。
| フォルダ | 用途 |
|---|---|
~/.cursor/skills/ | すべてのプロジェクト。Cloud Agents に同期される唯一のフォルダ。 |
~/.agents/skills/ | このコンピューター上のすべてのプロジェクト。Skillry がインストールする場所で、Codex も読み込みます。 |
.cursor/skills/ または .agents/skills/ | 1 つのプロジェクト（リポジトリ内のどこでも）。入れ子のフォルダは、その配下のファイルに適用されます。 |
.claude/skills/、.codex/skills/、および ~ 内の同じフォルダ | Claude Code や Codex の Skill もここで使えるように読み込まれます。 |
Cursor に Skill を追加する方法
Skillry CLI は Cursor が読み込む ~/.agents/skills/ にインストールするので、フラグは不要です。フォルダを手動でコピーする場合は、代わりに ~/.cursor/skills/ に置きましょう。Cloud Agents でも使えるのはこのフォルダです。
- 1
Skillry で Skill を開き、インストール用プロンプトをコピー を選んでから、ダイアログで コピー を選びます。
- 2
Cursor に貼り付けて送信します。エージェントが Skillry のインストール手順を読み、適切なコマンドを自分で実行します。
インストール用プロンプト Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
ブラウザでデバイスコードの承認を求められたら、承認します。
表示されるはずのもの： Cursor が、インストールしたバージョンと、
~/.agents/skills/配下の使用したフォルダを報告します。
- 1
最初に一度だけサインインします。ブラウザのウィンドウが開き、承認用のデバイスコードが表示されます。
ターミナル npx --yes skillry-cli@latest login - 2
インストールします。CLI のデフォルトのフォルダが Cursor の読み込む場所なので、フラグは不要です。
ターミナル npx --yes skillry-cli@latest install <slug>表示されるはずのもの：
Installed <slug> <version> to ~/.agents/skills/<slug>
Skill のページで ZIP をダウンロード を選ぶか、ほかで入手した Skill フォルダを使います。エージェントはその指示に従い、スクリプトを実行できるため、インストールする前に SKILL.md と scripts/ の中身を読んでください。そのうえで、フォルダ全体を移動します：
mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/skills/ZIP を展開すると、my-skill/my-skill/SKILL.md のように階層が 1 つ増えることがよくあります。SKILL.md は Skill のフォルダの直下に置く必要があり、そうでないとエージェントが見つけられません。
Cursor は起動時に Skill を探します。インストール後は新しいチャットを開くかウィンドウを再読み込みし、Customize → Skills の Agent Decides グループを確認してください。
Skill が消えてしまう名前のルール
Cursor は、SKILL.md の name が置かれているフォルダ名と完全に一致する場合にだけ Skill を読み込みます。一致しなくてもエラーは出ず、Skill がただ存在しないことになります。
なぜ消えたのか？
launch-page をダウンロードし、整理のためにフォルダ名を landing に変えたところ、Cursor から消えてしまいました。フォルダと name が一致しなくなったからです。フォルダ名を元に戻すか、name を landing に変更してください。
Cursor が受け付ける名前
- 小文字、数字、ハイフンだけを使う
SKILL.mdが入っているフォルダと同じ名前descriptionとセットで書かれている
Cursor で Skill を実行する方法
チャットで / と Skill の名前を入力し、続けて依頼を書きます：
/launch-page Parcelo, a parcel-tracking dashboard for small online shopsセッション中ずっと Skill を有効にしておくには、/ メニューから Skill を選び、Option+Enter（Mac）または Alt+Enter（Windows）を押すか、Use as Mode を選びます。Skill が Custom Mode になり、終了するまで有効なままになります。
Cloud Agents で Skill を使う
Cloud Agents はあなたのコンピューター上では動かないため、Cursor が同期した Skill しか使えません。設定方法は次のとおりです：
- 1Skill を
~/.cursor/skills/に置きます。プロジェクトの Skill や~/.agents/skills/の Skill は手元のマシンにとどまります。 - 2Settings → Agents → Context and Tools を開き、Sync Skills for Cloud Agents をオンにします。
- 3個人の Skill を代わりにチームと共有するには、Customize → Skills でその Skill を開き、Publish を選びます。
Cursor のルールと Skill の違い
Cursor のルールは、常に、または一致するファイルに対して、Cursor が会話に追加する短いガイダンスです。Skill は、タスクが必要とするときだけエージェントが読み込む手順です。規約にはルールを、複数ステップの作業には Skill を使いましょう。
必要に応じて読み込む手順
SKILL.mdを含むフォルダ- 関係があるとき、または
/nameと入力したときに実行 - 複数ステップの作業、スクリプト、テンプレート
コンテキスト内のガイダンス
.cursor/rules/内の.mdcファイル（通常の.mdファイルは無視されます）- Always Apply、Apply Intelligently、Apply to Specific Files、Apply Manually
- 短い規約。Cursor は
AGENTS.mdとCLAUDE.mdも読み込みます
古いルールを移行したいですか？Cursor に組み込まれている /migrate-to-skills で、“Apply Intelligently” のルールとスラッシュコマンドを Skill に変換できます。
Cursor の Skill が表示されない？これを試そう
まず名前を確認しましょう。name とフォルダの不一致が、Cursor で Skill が見当たらなくなるよくある原因です。
Customize → Skills に表示されない
name がフォルダと一致しているか確認し、新しいチャットを開くかウィンドウを再読み込みします。
Cloud Agents に表示されない
~/.cursor/skills/ に移動し、同期をオンにします。
自動で選ばれない
description が頼み方に合っていないか、paths によって別のファイルに限定されている可能性があります。
よくある質問
Cursor のルールと Skill の違いは何ですか？
ルールは、常に、または一致するファイルに対して、Cursor が会話に追加するガイダンスです。Skill は手順を収めたフォルダで、関係があるときや呼び出したときにエージェントが使います。
Cursor で Claude Skills は使えますか？
使えます。Cursor は ~/.claude/skills/ と .claude/skills/ を読み込みます。ただし、各 Skill の name がフォルダと一致している必要があります。
Cursor の Skill はどこに保存されますか？
すべてのプロジェクト用は ~/.cursor/skills/ または ~/.agents/skills/、1 つのプロジェクト用は .cursor/skills/ または .agents/skills/ です。
Cursor Cloud Agents で Skill は使えますか？
使えるのは ~/.cursor/skills/ にある Skill だけで、Sync Skills for Cloud Agents をオンにした後に限られます。
出典
このガイドは役に立ちましたか？
