Skill vs Rule · 三段階ロード · SKILL.md 仕様 · 6ステップ Runbook · Mac 7×24 実践
Cursor で毎回「PR 作成 + テスト + CHANGELOG 更新」の長いプロンプトを貼り付けていませんか？Agent Skill は複雑なフローを再利用可能なRunbookに落とし込み、Rule との役割分担と三段階の段階的ロードにより、2026 年の Agent を一度きりのチャットではなく SOP 付きの同僚のように動かせます。本記事は複雑な Prompt を繰り返す開発者向けです。Skill vs Rule の比較、SKILL.md 構造と agentskills.io エコシステム（コミュニティスキル 31000+）、6 ステップ Runbookで最初の Skill を作る手順、そして Mac Mini M4 月額 が 7×24 Agent と Skill 複利を支える方法を解説します。
2024–2025 年の「AI コーディング助手」は本質的に会話型補完で、毎回コンテキスト・制約・手順を説明し直す必要がありました。2026 年の Cursor Agent（2.4 以降 Skills 強化）はタスク完結へ：リポジトリを読み、複数ファイルを変更し、ツールを呼び、チーム規約どおりに納品します。知識はチャット履歴だけに留まらず、バージョン管理可能な Skill パッケージとして外置きする必要があります。
Agent Skill は .cursor/skills/ またはユーザー級 ~/.cursor/skills/ 配下のフォルダです。中核は SKILL.md（YAML frontmatter + Markdown 本文）で、scripts/、references/、テンプレート、チェックリストを添付できます。Agent は発見段階で name と description のみ読み、タスク一致後に活性化して全文と必要な附属ファイルをオンデマンドロードします。50 ページの Runbook を一度に Context へ入れることを避けます。
.cursor/rules で「コメント禁止」「pnpm 必須」と書いているなら、それは全体ガードレールです。同じ「リリース + Code Review + ドキュ更新」が週 3 回繰り返されるなら、Rule を伸ばし続けると毎会話で token を多く払い、同僚と共有しにくくなります。Skill はフロー再利用、Rule は行動境界——次節の表で対照します。
長い Prompt はバージョン管理できない：優れた指示は Notion 等に散在し、Agent は読めない。一箇所の変更がチーム全体に届かない。
コンテキスト膨張：Runbook 全文を会話に貼るとコードと diff の余地を奪い、長タスクが途中で切れる。
トリガー不安定：構造化された description ルーティング句がなく、どのマニュアルを開くべきか Agent が判断できない。
段階的開示ができない：長いスクリプトと API 文書が常駐し、単純なサブタスクでもフル token を支払う。
チームで再利用できない：個人 Chat の成功体験を Git のように review・マージ・ロールバックできない。
Rule はフロントガラスに貼った交通規則；Skill は車載マニュアル——故障箇所まで全ページをめくる必要はない。
Cursor Rules（.cursor/rules/*.mdc またはプロジェクト Rules）はセッション開始時に設定どおり常時または glob で注入され、コーディングスタイル、セキュリティ紅線、リポジトリ構造の約束に向きます。Agent Skills は agentskills.io オープン標準（2025 年以降複数ツールが相互認証）に従い、既定でオンデマンドの三段階ロード。多段ワークフロー、ドメイン知識、実行可能スクリプトに適します。
| 観点 | Rule | Agent Skill |
|---|---|---|
| ロードタイミング | セッション開始またはパス一致時に注入 | 発見 → 活性化 → references/scripts をオンデマンド |
| 典型シーン | コメント禁止、コミット規約、フレームワーク選定 | PR 作成、デプロイチェック、ドメイン API 連携、/slash ワークフロー |
| コンテキスト占有 | 常駐。条数が多いと継続的に占有 | 未トリガー時は metadata のみ。トリガー後に段階展開 |
| たとえ | 社員ハンドブック / コンプライアンス条項 | 役割 SOP + ツールボックス（スクリプト、テンプレ、外部ドキュ） |
references/ に置きオンデマンド読取。scripts/validate.sh を Agent がサンドボックスで呼び、結果を会話へ返す。コミュニティには create-hook、create-rule、babysit（PR マージと CI）、split-to-prs などの公式/準公式 Skill があります。MCP との関係：MCP が外部システムに接続し、Skill が Agent にいつ・どの順でツールを使うか教える——併用であり排他ではありません。
以下は Cursor 2.4+ で検証済みです。組み込み /create-skill で骨格を生成し、チーム規約に合わせて収束させます。目標は「3 回目でようやく書けた Prompt」をリポジトリで review 可能なフォルダにすることです。
Agent 会話で /create-skill を入力：タスク種別、トリガー語、入出力、禁忌を記述し、初版 SKILL.md とディレクトリツリーを生成させる。
スコープを選ぶ：プロジェクト級 .cursor/skills/<skill-name>/ は Git で共有。個人級 ~/.cursor/skills/ は横断リポジトリの習慣用（秘密鍵はコミットしない）。
frontmatter の description を書く：これは要約ではなくルーティングキー。「USE when user asks to …」「DO NOT use for …」と書き、発見段階の一致精度を上げる。
本文は段階的開示：核心手順は SKILL.md に。長文、OpenAPI、サンプル JSON は references/、スクリプトは scripts/ へ。
トリガーをテスト：正例 prompt 3 件（活性化すべき）と反例 2 件（活性化しない）を新セッションで検証。Context に必要ファイルだけが載るか確認。
旧資産を移行：肥大した Rules や一度きり Commands は /migrate-to-skills（または手動分割）でフロー型を Skill へ。Rule は短い紅線のみ残す。
--- name: release-pr-runbook description: USE when the user asks to open a release PR, ship a version bump, or run the pre-merge checklist. DO NOT use for hotfix without changelog or for dependency-only bumps. --- # Release PR Runbook ## Gather - Read package.json version and recent git tags. - List open PRs targeting main. ## Act - Bump version per semver. - Update CHANGELOG.md with user-facing bullets. ## Verify - Run test suite and lint. - Confirm CI green before requesting review.
| パス / フィールド | 役割 |
|---|---|
SKILL.md | 必須。frontmatter + 主 Runbook（< 500 行推奨） |
name | 小文字ハイフン ID。フォルダ名と一致 |
description | トリガールーティング句。USE when / DO NOT を含む |
scripts/ | 実行可能な検証・ジェネレータ。Agent がオンデマンド呼出 |
references/ | 長文ドキュ、API 説明。活性化後に読取 |
assets/ | テンプレ、図、サンプル設定（任意） |
Cursor の Skills 実装は agentskills.io と一致し、次の三段階に整理できます。token 請求と安定性に直結します。
発見（Discovery）：起動またはスキャン時に各 Skill の name + description のみ（Skill あたり数十 token 程度）をロードし、「利用可能マニュアル目録」を形成。
活性化（Activation）：ユーザー意図またはキーワード一致後、SKILL.md 全文を注入（通常数百〜千数百 token）。
オンデマンド（On-demand）：本文リンクが references/*.md を指す、または scripts/* を呼ぶときだけロード/実行。「厚い一冊を毎回全開」しない。
Skill 設計では決定木を本文前半に（先にシーン A/B を判定）、厚い資料は references へ。スクリプト出力が大きい場合、Skill で Agent に重要行だけ要約して返すよう求め、全文を Context に貼り戻さない。
ポイント：description をマーケ要約のように書くと誤トリガーが増えます。ルーティング規則（条件 + 除外）として書いて初めて L1 の価値が出ます。公式 create-skill はトリガー語を繰り返し聞いてくる——時間をかける価値があります。
高品質 Skill は四つの原則に従います。description をルート、段階的開示、単一責任（1 Skill 1 タスク種）、gather-act-verify の三段構成。Rule と重複させない——Rule は「テスト必須」、Skill は「本リポジトリで統合テストを回し失敗ログを読む手順」。
| Skill / 方向 | 向くシーン | 要点 |
|---|---|---|
| Prompt Lookup | 重複 Prompt の最適化、コミュニティテンプレ対照 | 車輪の再発明を減らし記述形式を揃える |
| React Best Practices | コンポーネント、RSC、性能と a11y | Vercel/チーム規約をマニュアルとして外置き |
| babysit / PR skill | PR コメント、CI 失敗、マージ競合 | GitHub CLI、CI ログと連携 |
| create-rule / create-skill | Cursor 設定そのもののガバナンス | メタ Skill。チームの足場を統一 |
| sdk | Cursor SDK / Agent API 統合 | バックエンドやパイプラインから Agent をプログラム呼出 |
| loop | 定時パトロール、cron 型 Agent | 安定ホスト 7×24 が必要。第 6 節参照 |
SKILL.md。/create-skill、/migrate-to-skills を既定ワークフローに組み込み。description は記事要約ではなくルーティング述語——公式ドキュと create-skill ガイドが強調。留意：秘密鍵や顧客 PII を description に書かない（L1 で常時可視）。スクリプトは環境変数を使う。references/ の機密付録は gitignore し、Skill 本文で取得方法を説明する。
スキルエコシステムは単一 IDE に閉じません。agentskills.io が規格、検証の考え方、索引入口を提供し、チームは内部 Skill をサブモジュール化して公開できます（内部 npm に近い）。個人開発者の現実的ルートは、コミュニティから近い Skill を fork → description と references/ を調整 → PR で diff を review です。
Skill が「コーディング補助」から7×24 自動化へ広がると——/loop による定時リポジトリスキャン、Telegram/Slack で /mac-quote 型見積フロー、サーバー側で Cursor SDK が Agent を常駐実行——ホスト選定が Skill の複利を左右します。
~/.cursor/skills を「組織記憶」として長期育てるチーム向け。典型構成：月額 Mac にプロジェクト clone と Skills リポジトリ submodule を固定し、merge 後 Hook で scripts/verify.sh を自動実行。IM Bot は意図の配送のみ、重処理は Mac 上で Skill 実行——Hermes Gateway 7×24、永続メモリと同じ「Agent をインフラ化」思想で、Cursor Skills は日常 IDE ワークフローに近いです。
ノートと低価格 VPS はSkill 作成と単発検証には足りますが、スリープ、macOS ネイティブ自動化経路の欠如、~/.cursor 状態の長期常駐では 7×24 体験が弱まります。純 API Skill はクラウドでも動きますが、Runbook がローカルスクリプト、キーチェーン、Apple エコツールに依存すると移行コストが跳ね上がります。Agent Skill を「常駐同僚」にし、トリガー曲線と token 節約を週をまたいで累積させたいチームには、VpsMesh Mac Mini M4 クラウドレンタルが uptime、リモート KVM、固定月額を予測可能 OpEx にまとめます。料金は Mac Mini M4 レンタル料金、構築の疑問は ヘルプセンター、申込は 注文ページから。
MCP（Model Context Protocol） は外部世界への接続層です。データベース、GitHub API、ブラウザ、内部マイクロサービスを Server 経由で tools/resources として公開します。Agent Skill は MCP を置き換えず、Markdown の Runbook としてどのタスクで先に何を gather し、どの MCP ツールをどの順で呼び、どう verify するかを規定します。たとえ：MCP はコンセントとケーブル、Skill は機器説明書の起動手順です。
「コードを書くたびに守る」短い規則は Rule（コメント禁止、指定パッケージマネージャ必須など）。「たまに行い、手順が多く、スクリプトと付録が要る」フローは Skill。経験則：同じ長い Prompt が 3 回目に出たら /create-skill で Skill 化。Rule の総数は少なく、L0 でセッションが埋まらないようにする。肥大 Rule のフロー部分は /migrate-to-skills で Skill へ移せます。
必須ではありません。純クラウド API、macOS 非依存の Skill は Linux VPS 上で Cursor CLI / SDK からスケジュールできます。Apple エコ自動化、ローカル Keychain、~/.cursor/skills を Gateway と同様に蓋閉めで止めたくないなら Mac Mini M4 月額 が楽です。まず 1 か月レンタルでトリガーと token 曲線を検証してください。料金は Mac Mini M4 レンタル料金、申込は 注文ページです。