2026 Cursor Agent Skills
完全ガイドと SKILL.md 実践

Rule vs Skill · agentskills.io · 三段階ロード · 六ステップ Runbook

2026 Cursor Agent Skills 完全ガイド
Cursor で毎回「staging へデプロイ → テスト → PR 作成」の長い Prompt を貼り付けていませんか。あるいはコンテキストが無関係なルールで埋まると感じていませんか。2026 年の答えは Agent Skill です。「ある作業の進め方」をバージョン管理可能な SKILL.md に封じ込め、Agent が必要なときだけ読み込む仕組みです。本稿は開発者と生産性ツール利用者向けに、① Skill と Rule・MCP の分担、② agentskills.io 準拠のディレクトリと frontmatter、③ 発見→活性化→実行の三段階ロード、④ 六ステップ作成と Runbook 移行、⑤ 2026 エコシステムの数値と Mac 7×24 ホスト選定を整理します。
01

2026 年に Agent Skill が必要な理由:従来 Prompt の三つの限界

AI Agent の進化は明快です。チャットボットからタスクアシスタントへ、そしてドメイン固有ワークフローを持つエージェントへ。Anthropic は 2025 年末に Agent Skills をオープン標準として公開し、Cursor 2.4 以降、Claude Code、Codex、Gemini CLI などが同一の SKILL.md パターンをサポートしています。Cursor で書いた Skill は、Copilot や Codex へ移してもパスを変える程度で済むことが多いです。

01

繰り返し作業:毎セッションで多段階フロー(コミット、プッシュ、PR 説明文)を説明し直すと、手順漏れやバージョン不一致が起きやすくなります。

02

コンテキスト汚染:デプロイ手順全体を Rule に書くと、常に Token を占有し、コードと diff の余地を圧迫します。

03

再利用不能:チャット履歴は Git 管理できず、チームで「Agent 操作マニュアル」をコードのように共有できません。

04

Skill の解:フローを独立フォルダに分割し、description がルーティングを担い、本文は関連タスク時のみロードされます。スクリプトは scripts/ で実行され、スクリプト本体はコンテキストを消費せず、出力だけが Agent に渡ります。

05

一言定義:Skill は Agent 向けの「操作マニュアル」であり、適切なタイミングで正しいことをさせます。Hermes の「タスク後に Skill を自動生成する」複利発想と同根ですが、Cursor 側は人間が規範を書き、Git で協調する点を強調します。

2026 年初頭時点で、コミュニティディレクトリは Marketplace や第三者集約サイトを含め三万件超のインストール可能 Skill として引用されることが増えています。標準は Anthropic 発、Apache 2.0 コードと CC-BY-4.0 ドキュメントライセンスで、ベンダーロックインリスクを下げています。

02

Agent Skill と Rule、MCP の分担:比較マトリクス

観点Rule(ルール)Skill(スキル)MCP
ロードタイミング毎会話デフォルト関連タスク時に必要時ロードツール呼び出し時に Server 接続
適用場面命名規則、禁止事項、ブランドトーンデプロイ、PR、セキュリティ監査、RunbookGitHub 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 の肥大化を防げます。

03

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 限定と同様の挙動です。

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. ヘルスチェックエンドポイントが 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 の応用を促す。用語は統一(「デプロイ」と「リリース」を混在させない)。

04

最初の Agent Skill を作る:六ステップ Runbook

01

最速ルート:Cursor Agent で /create-skill を入力し、自然言語でワークフローを説明。ウィザードで命名し .cursor/skills/ に保存します。

02

手動作成:.cursor/skills/your-skill-name/ を mkdir し SKILL.md を新規作成。name はフォルダ名と一致(小文字・数字・ハイフン)。

03

description を書く:ユーザーが言いそうな動詞と場面(「PR を開く」「マージリクエスト」「gh pr create」)を列挙。自動ルーティングの核心です。

04

スクリプト分割:反復コマンドは scripts/ へ。本文にはいつ走らせ、失敗時どうロールバックするかだけ。パスはスラッシュ scripts/deploy.sh で統一。

05

旧ルール移行:/migrate-to-skills を実行し dynamic rules と旧 slash commands を Skill 化。Settings → Rules で一覧を確認します。

06

検証:実タスクでトリガーを試す。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 が品質ゲートになります。

05

2026 エコシステムデータと Mac クラウド 7×24 ホスト:引用可能な硬情報

A

オープン標準:agentskills.io が frontmatter、Markdown 本文、発見パスを定義。Anthropic エンジニアリング文書は Skills が「手続き知識」を移植可能フォルダに梱包する仕組みを説明しています。

B

クロスプラットフォーム:同一 Skill を Cursor、VS Code Copilot、Codex CLI などでロード可能。Microsoft Agent Framework は SkillsProvider による発見と run_skill_script を提供(2026 エコシステム報道)。

C

ホストと複利: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 プレビュー。デプロイの詳細はヘルプセンターをご覧ください。