2026 Cursor Agent Skill 完全ガイド：SKILL.md 形式、三段階ロードと Mac クラウド 7×24 実践（意思決定マトリクス付き）
毎回の会話で「先にテストを走らせてからデプロイ」「社内規範どおり PR を書く」と繰り返すなら、従来の Prompt はコンテキストを圧迫しプロジェクト横断で再利用できません。Agent Skill はその手順をバージョン管理可能な SKILL.md に封じ込めます。本記事は Cursor / Claude Code 開発者向けに agentskills.io オープン標準、Skill と Rule の違い、三段階段階ロード機構を説明し、五段作成 Runbook と「ノート PC vs Linux VPS vs Mac クラウド」常駐ハード意思決定マトリクスを提示します。
目次
1. 三つの痛点：Agent Skill が必要な理由
- Prompt は再利用しにくい。 Runbook を毎回貼り、知識がチャットに閉じる。
- Rule がコンテキストを圧迫。 全規範の常駐は Token 浪費。
- Skill と常駐環境が乖離。 Gateway は 7×24 必須——Hermes 三層メモリ参照。
Skill は Agent 向け操作マニュアルで、按需ロードして正しい作業をさせる。
2. Skill とは：Rule との核心比較
| 比較軸 | Rule（ルール） | Skill（スキル） |
|---|---|---|
| ロードタイミング | セッション開始時に常駐 | 関連タスク出現時に按需ロード |
| 適用場面 | 命名規約、コードスタイル、ブランドトーン | 多段階ワークフロー（デプロイ、監査、PR 作成） |
| コンテキスト占有 | 固定占有 | 動的で効率的、scripts 出力は本文 Token を消費しない |
| 比喩 | 新人入社オリエンテーション | 専門操作マニュアル |
Skill はスラッシュコマンドとスクリプトを封装でき、MCP と連動する。MCP がツールを提供し、Skill が手順と条件を編成する。
3. SKILL.md ファイル構造と形式規範
標準ディレクトリ（Cursor、Claude Code、Codex、Gemini CLI 互換）：
最小構成の SKILL.md 例（agentskills.io オープン標準準拠）：
description はルーティングキーであり要約ではない。 誤り：「この skill はデプロイ関連指令を含む」。正解：いつロードするか（トリガー語、場面、ファイルパス）を明記する。
4. 三段階段階ロード機構
- 発見：
name+descriptionのみ読み、関連性を判定。 - 活性化： 完全な
SKILL.mdをロードし手順を実行。 - 按需：
references/を取得。scripts/は出力のみ返し、ソースは Token を消費しない。
パス：.cursor/skills/、.agents/skills/、~/.cursor/skills/。Cursor 2.4+ は /create-skill と /migrate-to-skills をサポート。
5. 常駐ハード意思決定マトリクス：Skill を書いたら、どこで動かす？
| 実行環境 | 7×24 常開 | ネイティブ macOS / Xcode | Skill スクリプト沙箱 | 適した場面 |
|---|---|---|---|---|
| MacBook ローカル | ❌ 蓋を閉じると切断 | ✅ | ✅ | 個人試験、短セッション |
| Linux VPS | ✅ | ❌ Apple ツールチェーンなし | ✅ | 純 CLI Agent、Metal 不要 |
| VPSMAC Mac クラウドノード | ✅ launchd | ✅ ベアメタル SSH | ✅ | OpenClaw/Hermes Gateway、チーム Skill リポジトリ |
agentskills.io はクロスプラットフォームオープン標準。チームはプロジェクト級 Skill を Git に含め、Mac クラウドで Gateway を検収すべき——OpenClaw skill-browser デプロイを参照。
6. 五段 Runbook：ゼロから最初の本番 Skill へ
ステップ 1 — トリガー場面を定義
高頻度の反復タスクを選び、ユーザー発話とファイル Glob を description に書く。
ステップ 2 — SKILL.md を作成
mkdir -p .cursor/skills/my-skill、name はディレクトリ名と一致させる。
ステップ 3 — references / scripts を分割
詳文と実行可能チェックを階層化し、手順に「なぜ実行するか」を記載。
ステップ 4 — スモークテスト
自動トリガー、/my-skill 手動トリガー、disable-model-invocation 動作を検証。
ステップ 5 — Mac クラウドへデプロイ
skills を VPSMAC へ rsync、launchd で Gateway を常駐——Mac クラウド Agent ノードを参照。
7. 引用可能な技術要点（2026）
- オープン標準： agentskills.io、最小フィールド
name+description。 - Cursor：
/create-skill、/migrate-to-skills（2.4+）。 - セキュリティ： 第三者 Skill は
exec監査——OpenClaw 本番強化参照。
8. FAQ
Skill vs MCP？ MCP は API 接続、Skill はフロー編成。硬直化する？ いいえ、Model は依然として自律判断。置き場所は？ 汎用は ~/.cursor/skills/、プロジェクトは .cursor/skills/ に置き Git へコミット。
9. 結論：Skill は「どうやるか」、Mac クラウドは「ずっとやる」
Prompt を積むか Rule で埋めると Token を浪費しバージョン管理が難しい。ノート PC は蓋を閉じると切断、Linux VPS には Apple ツールチェーンがない。Skill はフローを SKILL.md に封じ、VPSMAC Mac クラウドをレンタルすれば月額でベアメタル macOS と launchd 7×24 を得られ、Gateway と Skill が本当に常開する。