2026 Agent Skill 完全ガイド:Cursor SKILL.md、agentskills.io オープン標準と Mac クラウド 7×24 常駐実践

約15分で読了 · MACCOME

Cursor で毎日「デプロイ手順」「PR チェックリスト」「テストコマンド」を貼り付け続け、Agent が手順を覚えられずコンテキストが溢れると感じている開発者向けに、2026 年版の Agent Skill 実践ガイドです。得られるもの:Skill と Rule / MCP の境界、SKILL.md の標準書き方、最初の Skill を作る八ステップ、そして Agent を 7×24 クラウド Mac に載せる選定結論です。構成:六つの痛点 → 比較表 → 三階層ロード → 八ステップ → エコシステム数値 → 常駐ホスト行列 → FAQ です。

六つの痛点:なぜ「長い Prompt」では本番 Agent が持たないのか

2025 年末に Anthropic が Agent Skills をオープン標準として公開し、2026 年には Cursor 2.4+、Claude Code、Gemini CLI、GitHub Copilot など 16 以上のツールが同一の SKILL.md を読めるようになりました。それでも現場では次のような落とし穴が残ります。

  1. 毎回ゼロから教える:デプロイ、PR 作成、テスト実行の SOP がセッションを跨いで再利用できず、オンボーディングコストが線形に増えます。
  2. 無関係な Rule がコンテキストを占有:200 行の手順をグローバル Rule に詰めると、本来のコーディング用トークンが削られます。
  3. OpenClaw Skills と Cursor Skill の混同:前者は Gateway / ClawHub エコシステム(当サイトの OpenClaw MCP / ClawHub 実践記 参照)で、後者はエディタ側の「操作マニュアル」であり、ディレクトリとトリガー機構が異なります。
  4. description を要約にしてしまう:Agent のルーティングが失敗し、「Skill が壊れた」と誤解されやすくなります。
  5. 万能 Skill に詰め込みすぎ:デプロイ・セキュリティ・テストを一フォルダに入れると、保守コストが逆に上がります。
  6. Skill だけ整備し常駐機を置かない:Hook やスクリプトを 7×24 で回す必要がある場合、ノート PC のフタ閉めで処理が止まります(Hermes Gateway インストール記 と同様の課題です)。

一言で言えば、Skill は Agent 向けの再利用可能な「操作マニュアル」です。関連タスクが現れたときだけ全文を読み込み、毎回起動時にコンテキストへ詰め込む Rule とは役割が異なります。

Skill vs Rule vs MCP:役割分担を表で整理

観点 Rule(ルール) Skill(スキル) MCP
読み込みタイミング セッション中ずっと有効 metadata 検出 → マッチ後に本文ロード ツール呼び出し時にサービス接続
典型コンテンツ 命名規約、ブランド、Git 安全ルール 多段階ワークフロー、領域 Runbook 外部 API、DB、ブラウザ自動化
コンテキストコスト 固定で占有 段階的開示で Token 節約 呼び出し結果のみ返却
たとえ 入社時の共通ルール 専門作業の手順書 電話帳と外勤ツール

三階層の段階ロード:発見 → 有効化 → 必要に応じた追加取得

Cursor と agentskills.io 仕様は、次の三段階に整理できます。

  • Level 1 発見:起動時に各 Skill の namedescription だけを読み、現在タスクとの関連を判定します。
  • Level 2 有効化:マッチした Skill の SKILL.md 全文を読み込み、手順どおりに実行します。
  • Level 3 必要時:実行中に references/ を追加参照し、scripts/ 実行時は通常出力だけをコンテキストへ戻します。スクリプト本体は Token を消費しません。

一般的な配置パスは .cursor/skills/(プロジェクト)、~/.cursor/skills/(ユーザー全体)、.agents/skills/(Claude Code / Codex / Gemini CLI 横断)です。会話で /skill-name を入力して手動トリガーするか、@skill-name でコンテキストを添付することもできます。

SKILL.md の形:ディレクトリ構成と frontmatter

最小構成は次のとおりです。

text
.cursor/skills/deploy-app/
├── SKILL.md          # 必須
├── scripts/          # 任意:deploy.sh、validate.py
├── references/       # 任意:詳細 Schema、コンプライアンス条文
└── assets/           # 任意:テンプレート、設定サンプル

description はルーティングキーであり、要約ではありません

markdown
---
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` で統一
info

ヒント:Cursor Agent ダイアログで /create-skill を入力すると、仕様に沿った骨格を生成できます。Cursor 2.4+ では /migrate-to-skills により旧 dynamic rules と slash commands を Skill 形式へ移行できます。

八ステップで最初の Skill を動かす

  1. 単一責務を決める:例として「PR 作成だけ」に絞り、「デプロイ」と混在させないでください。
  2. フォルダを作成する:プロジェクト内 .cursor/skills/your-skill-name/。フォルダ名と name は一致(小文字 + ハイフン)させます。
  3. SKILL.md を書く:YAML frontmatter を埋め、本文は Gather → Act → Verify(情報収集 → 実行 → 検証)の順に整理します。
  4. (任意)scripts/ を追加:確定的な処理は Bash / Python に寄せ、モデルの幻覚を減らします。
  5. (任意)references/ を追加:長文ドキュメントや API Schema はここへ。本文は 500 行未満を目安にします。
  6. Settings → Rules で検出を確認:Skill 一覧と description プレビューが表示されることを確認します。
  7. 実タスクで回帰テスト:チームがよく使う言い回し(例:「staging に上げて」)でトリガーし、description を微調整します。
  8. Git にコミット:プロジェクト Skill はリポジトリで共有し、個人の汎用手順は ~/.cursor/skills/ に置きます。

2026 エコシステム:引用できる三つの数値

  • オープン標準のタイムラインagentskills/agentskills リポジトリは 2025-12-16 に公開、Apache-2.0 ライセンス。仕様サイト agentskills.io/specification は 2026 年 5 月時点でも更新が続いています。
  • コミュニティ規模(2026 年初頭):第三者ディレクトリと Marketplace の集計では、公開 Skill エントリが 31,000 件超(fork 重複を含むため、選定時はメンテナと stars を確認してください)。
  • 人気カテゴリ(エンジニア向け):Vercel 系 React Best Practices(40 以上の性能ルール)、Web Design Audit(アクセシビリティ / UX チェック)、PR / TDD ワークフロー Skill など。クリエイティブ向けに Remotion 動画編集もありますが、チームのスタックに合わせて選び、「入れたが一度も発火しない Skill」を増やさないことが重要です。

MACCOME 視点:レンタル業務向け Skill の例

カスタマーサポートや運営が繰り返す「機種見積」「契約ドラフト」は、例えば /mac-quote(型番 + 期間 → 見積表)や /contract-draft(標準条項の骨格)として Skill 化できます。Skill はフローと検証ポイントを記述するだけに留め、機密価格は内部 API / MCP 経由とします。クラウド Mac 双 Agent 構築記 と組み合わせる場合、OpenClaw がチャネルと Gateway を担い、Cursor Skill がリポジトリ内の納品規約を担う、という役割分担が整理しやすくなります。

常駐ホスト比較:Skill が整っても、マシンが止まれば意味がありません

ホスト 7×24 Skill 向きシナリオ 弱点
個人 MacBook フタ閉めで断 日中の Skill 執筆・ローカルデバッグ 無人 Hook / cron が不安定
Linux VPS 高い 純 CLI、macOS 非依存スクリプト Xcode 等 Apple ツールチェーン欠如
Mac mini M4 レンタル データセンター級オンライン Cursor SSH Remote、launchd、Agent Gateway 共存 月額とデータ移行の計画が必要

まとめ:「やり方」は Skill に、「常時オンライン」はクラウド Mac に

本稿の八ステップに従えば、多くのチームは 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 を実行し、トリガー語句の回帰テストを行ってください。

Skill 内のスクリプトを 7×24 で回すには?

ノート PC ではスリープで cron / Hook が止まります。常駐実行が必要なら レンタルノード で macOS + launchd を使う構成が安定します。手順の詳細は ヘルプセンター にあります。