Cursor で毎日「デプロイ手順」「PR チェックリスト」「テストコマンド」を貼り付け続け、Agent が手順を覚えられずコンテキストが溢れると感じている開発者向けに、2026 年版の Agent Skill 実践ガイドです。得られるもの:Skill と Rule / MCP の境界、SKILL.md の標準書き方、最初の Skill を作る八ステップ、そして Agent を 7×24 クラウド Mac に載せる選定結論です。構成:六つの痛点 → 比較表 → 三階層ロード → 八ステップ → エコシステム数値 → 常駐ホスト行列 → FAQ です。
2025 年末に Anthropic が Agent Skills をオープン標準として公開し、2026 年には Cursor 2.4+、Claude Code、Gemini CLI、GitHub Copilot など 16 以上のツールが同一の SKILL.md を読めるようになりました。それでも現場では次のような落とし穴が残ります。
一言で言えば、Skill は Agent 向けの再利用可能な「操作マニュアル」です。関連タスクが現れたときだけ全文を読み込み、毎回起動時にコンテキストへ詰め込む Rule とは役割が異なります。
| 観点 | Rule(ルール) | Skill(スキル) | MCP |
|---|---|---|---|
| 読み込みタイミング | セッション中ずっと有効 | metadata 検出 → マッチ後に本文ロード | ツール呼び出し時にサービス接続 |
| 典型コンテンツ | 命名規約、ブランド、Git 安全ルール | 多段階ワークフロー、領域 Runbook | 外部 API、DB、ブラウザ自動化 |
| コンテキストコスト | 固定で占有 | 段階的開示で Token 節約 | 呼び出し結果のみ返却 |
| たとえ | 入社時の共通ルール | 専門作業の手順書 | 電話帳と外勤ツール |
Cursor と agentskills.io 仕様は、次の三段階に整理できます。
name と description だけを読み、現在タスクとの関連を判定します。SKILL.md 全文を読み込み、手順どおりに実行します。references/ を追加参照し、scripts/ 実行時は通常出力だけをコンテキストへ戻します。スクリプト本体は Token を消費しません。一般的な配置パスは .cursor/skills/(プロジェクト)、~/.cursor/skills/(ユーザー全体)、.agents/skills/(Claude Code / Codex / Gemini CLI 横断)です。会話で /skill-name を入力して手動トリガーするか、@skill-name でコンテキストを添付することもできます。
最小構成は次のとおりです。
.cursor/skills/deploy-app/ ├── SKILL.md # 必須 ├── scripts/ # 任意:deploy.sh、validate.py ├── references/ # 任意:詳細 Schema、コンプライアンス条文 └── assets/ # 任意:テンプレート、設定サンプル
--- name: deploy-app description: >- ユーザーがアプリのデプロイ、本番リリース、 staging / production 切替、CI/CD 設定を依頼したときに使用する。 paths: - "apps/web/**" disable-model-invocation: false --- # アプリをデプロイする ## 実行手順 1. デプロイ前に `scripts/validate.py` で環境変数を検証し、起動失敗を防ぐ。 2. `scripts/deploy.sh <environment>` を実行する。 3. ヘルスチェック URL で検証し、失敗時は Rollback 節に従う。 ## 注意事項 - production は二次確認が必要 - パスは正斜杠 `scripts/deploy.sh` で統一
ヒント:Cursor Agent ダイアログで /create-skill を入力すると、仕様に沿った骨格を生成できます。Cursor 2.4+ では /migrate-to-skills により旧 dynamic rules と slash commands を Skill 形式へ移行できます。
.cursor/skills/your-skill-name/。フォルダ名と name は一致(小文字 + ハイフン)させます。~/.cursor/skills/ に置きます。カスタマーサポートや運営が繰り返す「機種見積」「契約ドラフト」は、例えば /mac-quote(型番 + 期間 → 見積表)や /contract-draft(標準条項の骨格)として Skill 化できます。Skill はフローと検証ポイントを記述するだけに留め、機密価格は内部 API / MCP 経由とします。クラウド Mac 双 Agent 構築記 と組み合わせる場合、OpenClaw がチャネルと Gateway を担い、Cursor Skill がリポジトリ内の納品規約を担う、という役割分担が整理しやすくなります。
| ホスト | 7×24 | Skill 向きシナリオ | 弱点 |
|---|---|---|---|
| 個人 MacBook | フタ閉めで断 | 日中の Skill 執筆・ローカルデバッグ | 無人 Hook / cron が不安定 |
| Linux VPS | 高い | 純 CLI、macOS 非依存スクリプト | Xcode 等 Apple ツールチェーン欠如 |
| Mac mini M4 レンタル | データセンター級オンライン | Cursor SSH Remote、launchd、Agent Gateway 共存 | 月額とデータ移行の計画が必要 |
本稿の八ステップに従えば、多くのチームは 1〜2 時間 で最初の Skill をトリガー可能な状態まで持っていけます。反復 Prompt を日常会話から外し、手順の一貫性を上げられるはずです。代替案の限界もはっきりしています。(a) 超長 Rule だけに頼るとコンテキストが継続的に削られます。(b) コミュニティ Skill を入れるだけで description の回帰をしないと、発火率は依然として不安定です。(c) ノート PC 上で定期実行スクリプトを回すと、スリープとフタ閉めで自動化が途切れます。
Skill で納品フローを固定化でき、かつ SSH 数分で立ち上がる固定月額、解約前にプロジェクトと .cursor/skills/ をまとめて持ち出せる macOS 環境が必要なら、MACCOME 専有 Mac mini M4 クラウドノードが現実的な選択肢になることが多いです。実機 Apple Silicon は Cursor リモート開発や launchd 常駐 Agent と完全互換です。リージョンとメモリは Mac mini レンタル料金ページ で比較し、運用面の疑問は ヘルプセンター をご参照ください。
よくある質問
Agent Skill と MCP の違いは何ですか?
MCP は外部能力(API、DB、ブラウザ)を接続します。Skill は Agent にいつ・どの手順でそれらを使うかを教えます。ベストプラクティスは、Skill 内で MCP ツール名を参照し、MCP でフロー文書を置き換えないことです。
グローバル Skill とプロジェクト Skill はどう使い分けますか?
コミット、テスト、PR などリポジトリ横断の手順は ~/.cursor/skills/ に置きます。単一プロダクト固有のデプロイ / リリースはプロジェクト .cursor/skills/ に置き、Git レビュー対象に含めます。
Cursor のどのバージョンから Skill に対応していますか?
Cursor 2.4+ で安定対応しています。それ以前は Nightly プレビューのみでした。アップグレード後は /migrate-to-skills を実行し、トリガー語句の回帰テストを行ってください。