2026 Cursor Agent Skill 完全ガイド：SKILL.md からクラウド Mac Agent ワークフローへ

Agent の進化は チャット → タスク実行 → ドメイン手順を持つエージェント です。コード変更、CI 操作、Telegram ゲートウェイまで任せる段階では、モデル能力より コンテキスト内の安定した規程 がボトルネックになります。

巨大プロンプトには三つの欠点があります。毎セッション同じ説明、無関係な履歴がウィンドウを圧迫、チーム横断の再利用ができない。Skill はフォルダ単位でメタデータ付き手順を梱包します。起動時は各 Skill の name と description だけ（おおよそ数十トークン）を読み、タスクが一致したら SKILL.md 全文を展開し、実行中に references/ や scripts/ の出力だけを取り込みます。スクリプト本体は通常コンテキストに入りません。

• 定義：Skill は Agent 向けの現場手順書で、適切なタイミングで正しい操作を促します。
• エコシステム：2026 年初時点でコミュニティ Skill は数万規模。Cursor Marketplace では Rule・Skill・MCP をまとめて導入できます。
• NUKCLOUD 文脈：クラウド Mac 上の Hermes、OpenClaw、自ホスト Copilot コーディング Agent では、.cursor/skills/ と AGENTS.md を同じリポジトリでバージョン管理し、ローカルだけ Skill が揃う状態を避けてください。

すべての規約を .cursor/rules に押し込むと、毎回の会話で静的テキストが丸ごと載ります。次の表で選び方を整理します。

Skill でできること：/deploy のようなスラッシュコマンド、コミットから PR までの多段フロー、ドメイン知識の注入、Bash / Python / Node スクリプト、Hooks や MCP との連携。MCP は「何を呼べるか」、Skill は「そのタスクをどの順で進めるか」を定義します。代替関係ではありません。

Cursor プロジェクト例：

.cursor/skills/deploy-app/
├── SKILL.md
├── scripts/
│   ├── validate.py
│   └── deploy.sh
├── references/
│   └── REFERENCE.md
└── assets/
    └── config-template.json

description は自動ルートの要です。いつ使うかを書き、記事要約は書きません。悪い例：「デプロイに関する skill」；良い例：「アプリのデプロイ、本番・staging 切替、リリース作業の依頼時に使用」。

• 必須：name（小文字・ハイフン、フォルダ名と一致）、description
• 任意：paths、disable-model-invocation: true（手動 /skill-name のみ）、metadata
• 探索パス：プロジェクト .cursor/skills/、ユーザー ~/.cursor/skills/、Claude Code は .claude/skills/、Monorepo はパッケージ配下にネスト可能

公式：Cursor Agent Skills、標準：agentskills.io。

agentskills.io のロードモデルは次の三層です。

1. L1
   発見（起動時）：各 Skill の name + description のみ。関連しそうか判定。
2. L2
   有効化（一致時）：SKILL.md 全文を読み、手順に従って実行。
3. L3
   オンデマンド（実行中）：references/ を取得；scripts/ を実行し出力だけをコンテキストへ（ソースは通常不要）。

トリガー：デフォルトは自動；/skill-name で手動；@skill-name で参照添付。disable-model-invocation: true なら従来のスラッシュコマンド同様、明示呼び出しのみです。

最短：Cursor Agent で /create-skill を実行し、自然言語でワークフローを説明すると SKILL.md 付きディレクトリが生成されます。

手動：.cursor/skills/your-skill-name/SKILL.md を作成 → frontmatter と手順を記述 → Settings → Rules で検出を確認 → 実タスクで description の自動一致を検証。

移行：Cursor 2.4+ の /migrate-to-skills で dynamic rules と旧 slash commands を Skill パッケージへ統合し、二重管理を防ぎます。

同一 SKILL.md を Claude Code から Cursor の .cursor/skills/ へコピーするだけで動く事例が増えています。開発効率、フロント監査（Vercel React/Next）、PR/TDD ワークフロー、Remotion 動画などカテゴリは多様です。

Skill は会話内の規程を整えますが、24 時間稼働・永続メモリ・Telegram には常時オンの Mac が要ります。Hermes 三層メモリ、OpenClaw ローカル Agent が扱う領域です。.cursor/skills/ を Git に入れ、専有クラウド Mac で同じリポジトリを clone すれば、Agent と CI Runner が同じ Skill 資産を共有します。

• 採用数：2025 年末公開の標準は 16+ 製品が対応（Cursor、Claude Code、Codex、Gemini CLI など）。
• バージョン：Cursor 2.4+ で安定。それ以前は Nightly プレビュー。
• セキュリティ：第三者 Skill の scripts/ は npm パッケージと同様にサプライチェーン確認が必要です。

ノート PC で Skill を書くのは快適ですが、蓋を閉じればゲートウェイは落ちます。共有 macOS VPS では帯域のぶれ、オーバーセル、長時間接続の切断が典型です。Hermes、自ホスト Runner、ローカル推論を Skill で回すなら、実行面を NUKCLOUD 多リージョン裸機 Mac へ移し、コンソール Runbook と揃えてください。

1. 01
   ワークフロー棚卸し：Skill 化候補（デプロイ、PR、テスト、見積など）を列挙。Rule に残す静的ルールと Skill に移す多段手順を分離。
2. 02
   リポジトリに .cursor/skills/：/create-skill または手書きで SKILL.md。実タスク文で description の自動トリガーを検証し Git 共有。
3. 03
   注文ページで専有 Apple Silicon を選択：Agent 要件に合わせて統一メモリを指定（ローカル推論は ds4 記事 の 96GB 目安）。共有プールのオーバーセルは避ける。
4. 04
   コンソールで常駐化：コンソール から SSH。launchd でゲートウェイを保活。ノート PC と同じ Xcode / Node / Python バージョンに揃える。
5. 05
   GitHub Agent 平面と接続：自ホスト macOS Runner で Copilot コーディング Agent / gh-aw を動かすとき、AGENTS.md と Skills を同梱。Branch Protection で人間レビューを維持。
6. 06
   72 時間 Soak Test：Skill ヒット率、スクリプト終了コード、長接続の安定性を記録。共有 VPS で断続していたなら、専有ノードの P95 と比較してから拡張または Mac Mini 購入を判断。

分課金の共有 macOS プールは、テナント境界の監査とAgent 長接続を同時に満たしにくいです。Skill を本番能力として扱うチームには、NUKCLOUD クラウド Mac が自前 Mac と同じ CLI を保ちつつ、故障交換を任せられます。まず 料金ページ で時間課金を試し、必要なら購入を検討してください。手順の詳細は ヘルプ も参照できます。