SKILL.md に封じ込め、Agent が必要なときだけ読み込む仕組みです。本稿は開発者と生産性ツール利用者向けに、① Skill と Rule・MCP の分担、② agentskills.io 準拠のディレクトリと frontmatter、③ 発見→活性化→実行の三段階ロード、④ 六ステップ作成と Runbook 移行、⑤ 2026 エコシステムの数値と Mac 7×24 ホスト選定を整理します。
2026 年に Agent Skill が必要な理由:従来 Prompt の三つの限界
AI Agent の進化は明快です。チャットボットからタスクアシスタントへ、そしてドメイン固有ワークフローを持つエージェントへ。Anthropic は 2025 年末に Agent Skills をオープン標準として公開し、Cursor 2.4 以降、Claude Code、Codex、Gemini CLI などが同一の SKILL.md パターンをサポートしています。Cursor で書いた Skill は、Copilot や Codex へ移してもパスを変える程度で済むことが多いです。
繰り返し作業:毎セッションで多段階フロー(コミット、プッシュ、PR 説明文)を説明し直すと、手順漏れやバージョン不一致が起きやすくなります。
コンテキスト汚染:デプロイ手順全体を Rule に書くと、常に Token を占有し、コードと diff の余地を圧迫します。
再利用不能:チャット履歴は Git 管理できず、チームで「Agent 操作マニュアル」をコードのように共有できません。
Skill の解:フローを独立フォルダに分割し、description がルーティングを担い、本文は関連タスク時のみロードされます。スクリプトは scripts/ で実行され、スクリプト本体はコンテキストを消費せず、出力だけが Agent に渡ります。
一言定義:Skill は Agent 向けの「操作マニュアル」であり、適切なタイミングで正しいことをさせます。Hermes の「タスク後に Skill を自動生成する」複利発想と同根ですが、Cursor 側は人間が規範を書き、Git で協調する点を強調します。
2026 年初頭時点で、コミュニティディレクトリは Marketplace や第三者集約サイトを含め三万件超のインストール可能 Skill として引用されることが増えています。標準は Anthropic 発、Apache 2.0 コードと CC-BY-4.0 ドキュメントライセンスで、ベンダーロックインリスクを下げています。
Agent Skill と Rule、MCP の分担:比較マトリクス
| 観点 | Rule(ルール) | Skill(スキル) | MCP |
|---|---|---|---|
| ロードタイミング | 毎会話デフォルト | 関連タスク時に必要時ロード | ツール呼び出し時に Server 接続 |
| 適用場面 | 命名規則、禁止事項、ブランドトーン | デプロイ、PR、セキュリティ監査、Runbook | GitHub API、DB、ブラウザ |
| コンテキストコスト | 固定占有 | 活性化時のみ全文 | ツール schema に応じて課金 |
| 比喩 | 入社オリエンテーション | 専門操作マニュアル | 電話帳 + API コンセント |
| MESHLAUNCH 側 | リポジトリ .cursor/rules/ | .cursor/skills/ または .agents/skills/ | CI や Issue ツールを任意接続 |
Rule は「Agent が常に守るべきこと」、Skill は「この種のタスクでどの手順を踏むか」、MCP は「どの外部能力を呼べるか」に答えます。
Cursor 公式はRule は短く高品質に保つこと、たまにしか使わないフローは Skill へ移すことを推奨しています。組み込み /migrate-to-skills(2.4+)で、過去の dynamic rules や slash commands を Skill 形式へ移行でき、Rule の肥大化を防げます。
SKILL.md ファイル構造と三段階プログレッシブロード
標準ディレクトリ(プロジェクト級の例):
.cursor/skills/deploy-app/
├── SKILL.md
├── scripts/
│ ├── validate.py
│ └── deploy.sh
├── references/
│ └── REFERENCE.md
└── assets/
└── config-template.json
Monorepo では apps/web/.cursor/skills/ のようなネストパスが使え、そのサブツリーでファイル編集時のみ Skill が surfaced します。frontmatter の paths Glob 限定と同様の挙動です。
--- name: deploy-app description: >- ユーザーがアプリのデプロイ、本番リリース、 staging/production 切替を依頼したときに使う。 paths: apps/web/** disable-model-invocation: false --- # アプリをデプロイする ## 実行手順 1. `scripts/validate.py` で環境変数の完整性を確認 2. `scripts/deploy.sh <environment>` を実行 3. ヘルスチェックエンドポイントが 200 を返すことを検証
三段階ロード(agentskills.io と Cursor ドキュメント一致):Level 1 発見——起動時は全 Skill の name + description のみ読む;Level 2 活性化——タスク一致時に SKILL.md 全文を読む;Level 3 必要時——実行中に references/ を読み、scripts/ を走らせる(出力はコンテキストへ、スクリプトソースは Token 非消費)。トリガーは自動ルーティング、ダイアログの /skill-name、または @skill-name 添付;disable-model-invocation: true なら手動スラッシュコマンドのみです。
| 発見パス | スコープ |
|---|---|
.cursor/skills/ | Cursor プロジェクト級 |
.agents/skills/ | Claude Code / Codex / Gemini CLI |
~/.cursor/skills/ | ユーザー全局(Cursor) |
~/.agents/skills/ | ツール横断全局 |
ベストプラクティス:description には要約ではなくトリガー条件を書く。単一責任。SKILL.md は約 500 行以内、詳細は references/ へ。手順には「なぜ」を書き Agent の応用を促す。用語は統一(「デプロイ」と「リリース」を混在させない)。
最初の Agent Skill を作る:六ステップ Runbook
最速ルート:Cursor Agent で /create-skill を入力し、自然言語でワークフローを説明。ウィザードで命名し .cursor/skills/ に保存します。
手動作成:.cursor/skills/your-skill-name/ を mkdir し SKILL.md を新規作成。name はフォルダ名と一致(小文字・数字・ハイフン)。
description を書く:ユーザーが言いそうな動詞と場面(「PR を開く」「マージリクエスト」「gh pr create」)を列挙。自動ルーティングの核心です。
スクリプト分割:反復コマンドは scripts/ へ。本文にはいつ走らせ、失敗時どうロールバックするかだけ。パスはスラッシュ scripts/deploy.sh で統一。
旧ルール移行:/migrate-to-skills を実行し dynamic rules と旧 slash commands を Skill 化。Settings → Rules で一覧を確認します。
検証:実タスクでトリガーを試す。Agent がロードしなければ本文を伸ばすより description を直す。Gather → Act → Verify:git status を読み、実行し、テストか HTTP で検証。
2026 年コミュニティでよく見る Skill タイプ(抜粋、推奨ではありません):開発効率——Prompt Lookup、Skill Installer、Ralph 式自律テストループ;フロント——Vercel 系 React/Next の性能・アクセシビリティ監査;ワークフロー——PR Skill、TDD Skill、Skill Writer。OpenClaw の ClawHub とは異なり、Cursor Skill はIDE 内コーディングセッションに近い位置づけです。Hermes の自動 Skill 蓄積とは異なり、ここでは人間レビュー + Git PR が品質ゲートになります。
2026 エコシステムデータと Mac クラウド 7×24 ホスト:引用可能な硬情報
オープン標準:agentskills.io が frontmatter、Markdown 本文、発見パスを定義。Anthropic エンジニアリング文書は Skills が「手続き知識」を移植可能フォルダに梱包する仕組みを説明しています。
クロスプラットフォーム:同一 Skill を Cursor、VS Code Copilot、Codex CLI などでロード可能。Microsoft Agent Framework は SkillsProvider による発見と run_skill_script を提供(2026 エコシステム報道)。
ホストと複利:Skill が launchd、Xcode 署名、macOS ブラウザ自動化、Telegram Gateway(Hermes メモリ編参照)に紐づく場合、ノート PC の蓋を閉めると可用性体感は約 60% まで落ち、Skill と Cron の複利が途切れます。M4 アイドル約 4–6W、Gateway 典型 15–25W で、常時起動に向きます。
MESHLAUNCH の業務に近い想定:カスタマーサポートや運用が「機種 + 租期 → 見積」「標準契約ドラフト」「返却チェックリスト」をプロジェクト級 Skill にし、レンタル Mac Mini 上で Cursor Agent と同機実行すれば、個人ノートの権限・スリープ問題を避けられます。純 Linux VPS でも汎用 Skill は動きますが macOS 専用パスは欠けます。Raspberry Pi は I/O とメモリがブラウザ系 Skill に不向きです。
クラウド Mac で Skill + Gateway + ローカルモデルルーティングを 7×24 検証するなら、MESHLAUNCH の Mac Mini M4 裸機月額が通常最適です。Apple Silicon 独占、SSH とローカル同等のディレクトリ構造、解約前に .cursor/skills と Agent 状態ディレクトリをパックして移行可能。レンタル料金で日単位試走、運用境界はヘルプセンターを参照してください。無料クラウド IDE だけでは永続 daemon やカスタム launchd がなく、長時間 Skill 複利には制御可能なホストが依然必要です。
MCP は外部 API とツールを接続します。Skill は操作ガイドで、Agent にいつ・どの手順でそれらを使うかを伝えます。両者は補完関係で、Skill 本文に「まず MCP で Issue を取得し、次に gh pr create」と書けます。
Skill は構造化ガイドであり、モデルは依然自律判断します。description を実際のユーザー言い回しに近づけるほどトリガーが安定します。本番手順には失敗時ロールバックを明記してください。注文ページで隔離環境を借り、破壊的テストが可能です。
汎用ワークフロー(コミット、テスト作成)は ~/.cursor/skills/ へ。リポジトリ固有フローは .cursor/skills/ に置き Git コミット。Cursor 2.4+ で安定サポート、早期機能は Nightly プレビュー。デプロイの詳細はヘルプセンターをご覧ください。