AI コーディングアシスタントとコードワークフローのイメージ。Agent Skill の構造化指示を象徴

2026 年 Cursor Agent Skill 完全ガイド：SKILL.md 作成、トリガーとリモート Mac 7×24 決定マトリクス

毎回同じ長い Prompt を貼るなら Agent Skill の出番です。Cursor・OpenClaw は agentskills.io 標準の SKILL.md で手順を按需ロードします。本稿は Skill と Rule の対照、三段階ロード、五ステップ作成、7×24 ゲートウェイをリモート Mac に置く理由を述べます。

1. 三つの痛み：Prompt 反復、コンテキスト肥大、手順の属人化

AI 支援は Agent へ進化し、チームが大きいほど次の摩擦が目立ちます。

  1. 同じ作業の繰り返し：メンバーごとにデプロイチェックリストをチャットに書き、モデルや会話を変えると消える。
  2. コンテキストの圧迫：運用マニュアル全文をシステムプロンプトに入れ、実際のコード用トークンが減る。
  3. バージョン管理できない知識：口頭ルールはレビューできず、オンボーディングが属人化する。

Skill は適切なタイミングで自動ロードされる専門手順書で、Rule の常駐や使い捨て Prompt とは異なります。

2. Skill と Rule：読み込みタイミングの比較

観点 Rule（ルール） Skill（スキル）
読み込み セッション中ずっ有効 関連タスク時のみ
典型内容 命名規約、force push 禁止、Git 安全 デプロイ、PR 作成、監査、OpenClaw doctor 段階手順
コンテキスト 固定コスト 起動時のみ。スクリプトは出力だけ返せる
チーム比喩 入社ガイド リリースマネージャの Runbook
MCP との関係 外部 API を直接呼ばない 「いつどの MCP チェーンを使うか」を編成できる

3. ディレクトリ構成と SKILL.md 仕様

プロジェクト Skill は .cursor/skills/（Cursor）または .agents/skills/（Claude Code・Gemini CLI 横断）に置きます。1 Skill 1 フォルダ、中核は SKILL.md です。

.cursor/skills/deploy-staging/
├── SKILL.md          # 必須：frontmatter + 手順
├── scripts/          # 任意：実行スクリプト
│   └── validate.py
├── references/       # 任意：長文は必要時だけ
└── assets/           # 任意：テンプレ・設定例

frontmatter 必須は name と description（ルーティング鍵）。任意で paths、disable-model-invocation（/skill-name 手動のみ）。

4. 三段階ロード：発見 → 起動 → references/scripts

トリガーは自動、/skill-name、@skill。Monorepo は子ディレクトリに .cursor/skills/ をネスト可能です。

5. 五ステップで最初の Skill を作る

  1. 単一責務に絞る：「staging デプロイ」まで。広い運用は Skill を分割して組み合わせる。
  2. ディレクトリと SKILL.md：Cursor 2.4+ なら /create-skill で骨組み生成も可。
  3. description を発火条件に：「ユーザーがデプロイ・本番反映・staging 公開と言ったとき」のように書く。「デプロイについて」は弱い。
  4. Gather → Act → Verify：環境収集、スクリプト実行、プローブやログで検証の順を明示する。
  5. 実タスクで回帰：言い回しを変えて誤起動がないか確認。必要なら paths: apps/web/** で絞る。

/migrate-to-skills で旧ルールを移行できます。

6. description とベストプラクティス

コアは 500 行以内、詳細は references/。手順には理由を書き、用語を統一し、失敗時のロールバックを明示します。

7. 2026 エコシステム：agentskills.io と人気 Skill

agentskills.io がオープン標準を維持し、Cursor Marketplace では Rules+Skills+MCP をワンクリック導入できます。addyosmani/agent-skills（品質ゲート）、Vercel フロント監査パック、当サイトの《OpenClaw チャネル障害診断》のような運用 Skill も参照価値があります。

8. 実践：PR 公開とリモート Mac の接続

ワンショット PR Skill：git status → ブランチ → push → gh pr create を固定し、Git 安全 Rule と併用して force push を防ぐ。OpenClaw/Hermes：ゲートウェイ Skill を蓋をしたノートで回すと落ちます。設定と Skill リポジトリは SFTPMAC リモート macOS の 7×24 ノードへ同期してください（《Hermes インストール》参照）。

運用面 手元の Mac ノート リモート macOS（SFTPMAC）
7×24 ゲートウェイ スリープ・蓋で中断しやすい launchd 常駐、SLA 契約可
Skill 同期 ローカル .cursor のみ Git + SFTP/rsync でチーム Skill を統一
ローカル推論 メモリ・冷却の制約 M4/M5 大メモリ SKU で試してから自前購入判断

9. よくある質問

Skill と MCP？ MCP はツール接続、Skill は手順定義。汎用 Skill は ~/.cursor/skills/、プロジェクト固有は .cursor/skills/ です。

まとめ：手順は Skill に、ゲートウェイは安定した Mac に

Skill は SKILL.md で Prompt 反復を減らし、MCP と併用で手順付きツール運用が可能です。常時オン Agent はノートのスリープが障壁になります。

SFTPMAC リモート Mac で Git/SFTP 同期と 7×24 ゲートウェイを実現。今日 /create-skill から始め、リモートで一連のリリースを通してください。