2026 Agent Skill 完全ガイド：
Cursor 再利用スキル、オープン標準と Mac クラウド Agent ワークフロー

Cursor で毎回「デプロイ前チェックリスト」「PR 説明テンプレート」「OpenClaw 障害切り分け手順」を貼り付けていると、コンテキストウィンドウが手順説明で埋まり、会話をまたいで再利用できません。Agent Skill は「あることをどう進めるか」をオンデマンドで読み込む手順書としてパッケージ化します。Anthropic は 2025 年末にこれを agentskills.io オープン標準として公開し、Cursor 2.4 以降、Claude Code、Gemini CLI などが互換対応しています。本稿は開発者と Mac 効率化ユーザー向けに、Skill と Rule の違い、SKILL.md 形式、三段階プログレッシブ読み込み、六ステップ作成フローを整理し、リモート Mac Mini 上で Agent スキルを 7×24 安定稼働させる方法までつなげます。仕様とフィールド意味は Cursor および agentskills.io 公式を正としてください。レンタル単価は NOVAKVM 料金ページ、注文は 注文ページ、リモート接続は ヘルプセンターをご覧ください。

[ SECTION_01 ] // PAIN_MAP チャットボットからエージェントへ：従来の Prompt では複雑ワークフローが持たない理由

  • 反復作業：新しい会話のたびに「テスト実行 → commit → gh で PR 作成」を説明し直す必要があります。長い手順で一歩でも抜けると、Agent は検証を飛ばしたり近道を選びます。
  • コンテキスト汚染：デプロイ手順書全体を System Prompt や Rules に入れると、コードと diff のための枠が減り、モデルは現在のファイルパスを忘れやすくなります。
  • バージョン管理不能：口頭の約束が Notion や Slack に散らばり、新人オンボーディングで「唯一の正」が見つからず、Git ワークフローと乖離します。
  • ツール横断で移植できない：Cursor Rules だけに書いた約束は、Claude Code や CI 上の Codex Agent では効きません。Skill のオープン標準はこのサイロを崩すためのものです。
  • MCP との混同：MCP は外部 API やデータベース接続を担います。Skill は「ある種のタスクを受けたらどの順でどのツールを使うか」を Agent に伝えます。補完関係であり、代替ではありません。
  • ローカル Mac はシャットダウンで途切れる：Skill がどれだけ良くても、Gateway や Runner、常駐 Agent が個人ノート PC 上にあると、蓋閉じ・スリープ・回線切替で自動化ループが止まります。

ひと言で言うと、Skill は AI Agent 向けの再利用可能な手順書です。正しいタイミングで正しいステップを読み込み、すべてのルールを常にコンテキストに釘付けにしません。

[ SECTION_02 ] // MATRIX Agent Skill と Cursor Rule の違いは？一覧表で整理

多くのチームは「コメント禁止」「commit 前に lint」を Rules に入れ、一方で「staging への八段階リリースチェック」は Prompt に残しています。次の表で、Rule に置くか Skill に置くかを判断できます。

Rule（ルール）と Skill（スキル）の意思決定対照
比較軸 Rule Skill
読み込みタイミング セッション中ずっと有効（または paths 範囲） Agent が関連と判断したときに SKILL.md 全文をオンデマンド読み込み
典型的な内容 命名規約、コメント禁止、Git 安全プロトコル デプロイパイプライン、セキュリティ監査、PR 自動化、ドメイン専門フロー
コンテキスト占有 固定で token を消費 まず name と description のみ、活性化後に本文
トリガー 自動でコンテキストに付与 description の自動マッチ、または手動 /skill-name
クロスプラットフォーム 多くは Cursor 専用 .mdc agentskills.io 標準、Git リポジトリで共有可能
たとえ 新人向け就業規則 専門マニュアル（リリース、テスト、コンプライアンス）

[ SECTION_03 ] // STRUCTURE SKILL.md の構造、YAML フィールド、三段階プログレッシブ読み込み

標準ディレクトリはプロジェクト直下の .cursor/skills/your-skill-name/SKILL.md を例にします。Claude Code と Gemini CLI は .agents/skills/ もサポートし、ユーザー全体向けは ~/.cursor/skills/ または ~/.agents/skills/ に置けます。フォルダ名は frontmatter の name と一致させる必要があります。

.cursor/skills/deploy-app/SKILL.md 
---
name: deploy-app
description: >-
  ユーザーが staging または production へのデプロイ、
  「リリース」「本番反映」を求めたときに使用する。
paths:
  - "apps/web/**"
disable-model-invocation: false
---

# アプリをデプロイする

## 利用シーン
- デプロイ、リリース、環境切替の依頼

## 実行ステップ
1. scripts/validate.py で環境変数を検証
2. scripts/deploy.sh <environment> を実行
3. ヘルスチェックエンドポイントを確認

三段階プログレッシブ読み込みは Skill が token を節約する中核です（Cursor 公式と agentskills.io の双方で説明されています）。

  • Level 1 発見：Agent 起動時は各 Skill の name と description のみ読み、「今のタスクに関連するか」をルーティングします。
  • Level 2 活性化：マッチ後に SKILL.md 全文を読み、手順に沿ってツールやスクリプトを呼び出します。
  • Level 3 オンデマンド：実行中に references/ の長文を追加読み込み。scripts/ 内はシステムが実行し、スクリプト本体は会話 token を占有しません。

Skill 作成時、description には要約ではなくトリガー条件を書く必要があります。これが読み込み可否のルーティングキーです。悪い例：「デプロイ関連の指示を含む skill」。良い例：「デプロイ、リリース、staging/production 切替の依頼時に使用」。

次のリンクは仕様と Cursor 連携の入口です。リリース後に再度開き、フィールド変更の有無を確認してください。

Cursor 公式：Agent Skills

Agent Skills オープン標準（agentskills.io）

Anthropic エンジニアリング：Equipping agents for the real world with Agent Skills

[ SECTION_04 ] // RUNBOOK Cursor で最初の Agent Skill を作る：六ステップ実践リスト

  1. 単一責務を選ぶ：「万能 DevOps スーパー Skill」は作らないでください。「PR 作成だけ」「sitemap 検証だけ」などに分割し、複雑タスクは複数 Skill の組み合わせにします。
  2. ディレクトリ作成：プロジェクトルートで mkdir -p .cursor/skills/my-first-skill。チーム共通手順なら ~/.cursor/skills/ のユーザー級 Skill も検討します。
  3. SKILL.md を書く：必須の name、description を記入。本文は Gather → Act → Verify：収集情報、操作手順、検証と失敗時ロールバックの順です。
  4. （任意）scripts/ を追加：反復コマンドを scripts/validate.sh などに置き、SKILL.md には「なぜ実行するか、期待出力は何か」だけを書き、長い shell をコンテキストに載せません。
  5. ローカルでトリガー検証：Agent 会話で実タスクの言い回しを試し、description がヒットするか確認します。必要なら /my-first-skill で強制活性化。Cursor 2.4+ には /create-skill と旧 Rules からの /migrate-to-skills もあります。
  6. Git と Code Review に載せる：.cursor/skills/ をリポジトリにコミットし、PR で本番の二重確認やシークレット混入がないかレビューします。

高品質 Skill の追加原則：段階的開示（SKILL.md はおおよそ 500 行以内、詳細は references/）、用語の一貫（「デプロイ」と「リリース」を混在させない）、パスはスラッシュ（scripts/deploy.sh はクロスプラットフォーム向き）、理由を説明（「validate は環境変数欠落による起動失敗を防ぐため」は「validate.py を実行」だけより Agent に伝わります）。

[ SECTION_05 ] // DATA 2026 Agent Skill エコシステム：参照パラメータ、注目領域、FAQ

  • オープン標準の公開時期：Anthropic は 2025 年 12 月に Agent Skills をオープン形式で公開しました。仕様サイトは agentskills.io、GitHub 仕様リポジトリは agentskills/agentskills です（最新は公式の記載に従ってください）。
  • Cursor の安定対応バージョン：Cursor 2.4+ の Agent モードで Skills が安定利用できます。2.4 から /migrate-to-skills により dynamic rules と slash commands を Skill ディレクトリへ移行できます。
  • クロスプラットフォーム対応ツール（抜粋）：agentskills.io トップに Cursor、Claude Code、Gemini CLI、GitHub Copilot などが掲載されています。確定前に agentskills.io で一覧を再確認してください。
  • frontmatter 必須：name（小文字・数字・ハイフン、フォルダ名一致）と description（トリガー条件）。任意で paths の glob、disable-model-invocation: true で手動 /skill-name のみ。
  • Skill と MCP の関係：Skill はワークフローとドメイン知識、MCP はツールエンドポイントです。Skill 本文で「特定 MCP 経由で API を呼ぶ」と指示できますが、Skill 自体はプロトコル代替ではありません。

2026 年のコミュニティでよく見る Skill 方向性には、Vercel 系 React/Next.js パフォーマンス監査、PR 自動化（commit → push → gh pr create）、TDD ループ、Skill Writer（Skill を書くための Skill）があります。企業チームは Mac レンタル業務の定型文も見積・契約ドラフト・返却チェックリストとして内部 Skill 化できます。NOVAKVM のようなベアメタル Mac 事業では、Skill が手順を、クラウド Mac が 7×24 の実行環境を担います。

[ SECTION_06 ] // CLOSE リモート Mac で Agent Skill を回す：実戦シナリオと方案収束

リモート Mac で「OpenClaw Gateway 障害切り分け Skill」や「iOS CI 自己修復 Skill」を動かす場合、Skill ファイルは .cursor/skills/ に置いてコードと同期できますが、実行環境が 7×24 を決めます。代替案にはそれぞれ弱点があります。

  • 個人 MacBook で Agent をローカル実行：蓋閉じ・スリープ、家庭回線の揺れ、Xcode と日常業務の CPU 争奪で、テスト→修正→再テストの長時間 Skill ループが中断されやすいです。
  • 汎用 Linux VPS：codesign、Metal、Simulator など macOS 専用チェーンが動かず、iOS/macOS 向け Agent Skill は着地できません。
  • 共有クラウド Mac 仮想デスクトップ：マルチテナントで Metal とビルドキューが不安定で、本番 CI を Skill 自動化に結びつけるのは向きません。

安定した Metal、専有 Apple Silicon、日/週/月の弾力スケールが必要な iOS CI/CD と AI Agent 自動化の本番環境では、NOVAKVM の Mac mini M4 / M4 Pro クラウドベアメタルレンタルが実務上の最適解になりやすいです。Skill が「どうやるか」を定義し、専有リモートノードが「いつでもやれる」ランタイムを提供します。SSH、画面共有、六地域ノードで、同一 .cursor/skills/ リポジトリをチーム共有し、地域ごとに遅延検証も可能です。機種と期間は 料金ページ、接続手順は ヘルプセンターをご参照ください。