デプロイ、テスト、PR 作成のたびに Cursor へ長い Prompt を貼り付けているなら、ワークフローはまだ「チャットボット段階」に留まっています。Agent Skill は Anthropic が 2025 年末に公開したオープン標準（agentskills.io）で、Cursor、Claude Code、Codex CLI、Gemini CLI など 16 以上のツールが採用しています。「一件事のやり方」を再利用可能で、必要に応じてロードされる操作マニュアルとして封装します。本記事は開発者と Mac パワーユーザー向けに、Skill と Rule の選定対照、SKILL.md 仕様、三段階プログレッシブロード、六ステップで最初の Skill を作成する手順を示します。最後に 7×24 常駐 Agent ワークフローで Skill スクリプトをMac Mini クラウドレンタルノードで動かす理由を説明します。
AI Agent の進化は明確です。チャットボットからタスクアシスタント、専門領域を持つエージェントへと移行しています。2026 年時点で Cursor 2.4+ は Skill を安定サポートし、コミュニティには 31,000 以上のインストール可能な Skill があります。それでも多くのチームは複雑なフローを使い捨て Prompt に書き込んでおり、次の六つの壁にすぐぶつかります。
繰り返し作業：デプロイ、監査、PR 作成のたびにフロー全体を説明し直す必要があり、新人の onboarding コストが高くなります。
コンテキスト汚染：長い Prompt が Token ウィンドウを占有し、本当に必要なコード diff が押し出されます。
セッション間で再利用不可：タブを閉じるとフロー知識も消え、チーム知識を IDE 内に蓄積できません。
ツール境界の曖昧さ：構造化された手順がないと、Agent は検証をスキップしたり MCP ツールを誤った順序で呼んだりします。
クロスプラットフォーム非互換：Cursor Rule の内容は Claude Code や Codex CLI にそのまま持ち込めません。
スクリプトとドキュメントの分離：デプロイスクリプトは repo に、手順書は Notion にあり、Agent が両者を自動関連付けできません。
Skill の核心価値は、「一件事のやり方」をバージョン管理可能で按需ロード、クロスプラットフォーム共通のモジュールにまとめることです。一言で言えば、Skill は AI Agent 向けの操作マニュアルであり、毎回一から教えるのではなく、適切なタイミングで正しいことを実行させます。
Mac 開発者にとってこの六つの壁は特に深刻です。iOS ビルド、公証（notarization）、Keychain 操作には macOS が必要です。これらの手順がチャット履歴だけに存在すると、新しいセッションのたびに xcodebuild フラグやプロビジョニングを再説明する必要があります。Skill はその暗黙知を repo 成果物に変換します。
Prompt は毎週書き直す付箋、Skill はチーム全体で共有する Git 管理の Runbook と考えると理解しやすいです。実行可能スクリプトを同梱でき、スクリプト本体はコンテキストに入らず出力だけがモデルに渡されます。
Cursor プロジェクトで最も混同されるのが Rule（ルール） と Skill（スキル） です。Rule は .cursor/rules/ に置き、起動時に常時ロードされます。命名規則、Git コミット形式、コードスタイルなど「新人向けオンボーディング」に適しています。
Skill は按需でロードされます。デプロイパイプライン、セキュリティ監査、PR 作成など多段階ワークフロー向けで、タスクに合致したとき Agent が専門プレイブックとして引き出します。
| 比較軸 | Rule（ルール） | Skill（スキル） |
|---|---|---|
| ロードタイミング | 常時ロード、固定コンテキストコスト | 按需 / 関連時ロード、動的で効率的 |
| 適用場面 | 永続的な約束（命名、スタイル、Git 規約） | 複雑ワークフロー（デプロイ、監査、PR） |
| トリガー | マッチファイルに自動適用 | Agent ルーティング / 手動 /skill-name |
| クロスプラットフォーム | Cursor 専用形式 | agentskills.io オープン標準、16+ ツール共通 |
| 実行可能スクリプト | 内蔵不可 | scripts/ を同梱、出力のみ Agent に渡る |
| MCP との関係 | 直接関連なし | Skill が手順を編成、MCP が外部ツール提供 |
「Rule は Agent に『誰であるか』を教え、Skill は『何をすべきか』を教える。」
Skill は四つの能力層もカバーします。カスタムコマンド（/deploy など）、ワークフロー封装（コミット → プッシュ → PR 作成）、ドメイン知識注入（React パフォーマンス、セキュリティ監査）、Hook 連携（CI/CD、シークレット管理）です。Cursor 2.4+ には /migrate-to-skills があり、旧 dynamic rules と slash commands を Skill 形式へ一括移行できます。
選定の目安はシンプルです。すべてのファイル編集に適用すべき指示なら Rule、ユーザーが「staging にデプロイして」や「依存関係を監査して」と言ったときだけ走らせたいなら Skill です。ワークフロー型の Rule が既にある場合は、ゼロから書く前に移行を実行することをおすすめします。
各 Skill はディレクトリです。必須ファイルは SKILL.md です。フォルダ名は frontmatter の name と一致させます（小文字、数字、ハイフンのみ）。
.cursor/skills/
└── deploy-app/ # フォルダ名 = skill 名
├── SKILL.md # コア指示（必須）
├── scripts/ # 実行可能スクリプト（任意）
│ ├── validate.py
│ └── deploy.sh
├── references/ # 按需ロードの参考資料（任意）
│ └── REFERENCE.md
└── assets/ # 静的テンプレート、設定（任意）
└── config-template.json
--- name: deploy-app description: >- ユーザーが staging または production へデプロイする必要があるときに使用。 キーワード：デプロイ、リリース、本番、環境切替。 paths: - "apps/web/**" disable-model-invocation: false --- # アプリデプロイ ## 実行手順 1. `scripts/validate.py` で環境変数を検証し、起動失敗を防ぐ 2. `scripts/deploy.sh <environment>` を実行 3. デプロイ結果を検証し、失敗時は自動ロールバック ## 注意事項 - production は二次確認が必要
description は Agent ルーティングの核心です。トリガー条件を書き、要約は書きません。誤：「この skill にはデプロイ関連の指示が含まれる」。正：「ユーザーがデプロイ、リリース、環境切替に言及したときに使用」。
本番環境では任意 frontmatter も重要です。paths で glob スコープを限定でき、monorepo に多数 Skill がある場合に有効です。disable-model-invocation: false で Agent の自動選択を許可し、true にすると手動 /deploy-app のみになります。
Cursor は起動時に三段階ロードを行い、発見効率と Token 節約を両立します。
name + description を読み、現在タスクに関連する候補を選びます。SKILL.md 本体を読み、手順に従います。references/ を読みます。scripts/ はローカル実行され、本体は Token を消費せず出力のみ渡ります。発見パスはプラットフォームごとに異なりますが、Skill フォルダはそのままコピーできます。Cursor は .cursor/skills/（プロジェクト）と ~/.cursor/skills/（グローバル）を読みます。Claude Code は .claude/skills/、Gemini CLI / Codex は .agents/skills/ です。オープン標準の意味は一度書けば多プラットフォームで再利用できることです。
SKILL.md は 500 行以内に抑え、詳細 Schema や API リファレンスは references/ へ移してください。Agent は手順が明示的に必要なときだけ読み込み、大規模チームの固定コンテキストを大幅に削減できます。
最速の方法は Cursor Agent で /create-skill と入力し要件を説明することです。手動作成やチーム標準化には、次の六ステップで完全ループを検証してください。
単一責任を定義：「iOS ビルド前チェック」など具体タスクを一つ選び、「全部入りスーパー Skill」は避けます。複雑フローは複数 Skill に分割します。
ディレクトリと SKILL.md を作成：プロジェクトルートに .cursor/skills/ios-prebuild-check/SKILL.md を置き、frontmatter と手順を記述します。description にはトリガー語を書きます。
scripts/ を追加（任意）：繰り返し実行する Bash / Python を scripts/ に置き、SKILL.md では「なぜ実行するか」を説明します。
長文ドキュメントは渐进開示：詳細 Schema や API リファレンスは references/ へ。SKILL.md は 500 行以内に保ちます。
トリガーを検証：「staging にデプロイして」など実タスクでテストし、Agent が Skill をロードするか確認します。ロードされなければ description のキーワードを調整します。
Git にコミットして共有：Skill ディレクトリをバージョン管理し、チームは clone ですぐ利用できます。横断 Skill は ~/.cursor/skills/、プロジェクト固有は .cursor/skills/ です。
ヒント：高品質 Skill は Gather → Act → Verify に従います。情報収集（設定読み取り、環境確認）→ 操作実行 → 結果検証。失敗時のリトライ、ロールバック、中止を明記してください。
注意：ClawHub などコミュニティ Skill マーケットには悪意ある Skill（ClawHavoc 事件）が存在しました。本番では clawhub inspect で監査し、バージョンを pin、ホワイトリストを設定してください。詳細はClawHub スキルセキュリティ記事を参照してください。
六ステップ完了後は 15 分のチームレビューを推奨します。二人のエンジニアが同じ自然言語トリガーを試し、Agent 挙動の差異を確認してください。差異の多くは description の曖昧さか Verify 手順不足が原因です。
Mac 中心のワークフローは CI と同じ macOS ティアで検証してください。xcodebuild や notarytool を呼ぶ Skill は Linux ランナーで静かに失敗します。専用 macOS ホストでの検証が必要な理由の一つです。
Agent Skills オープン標準は 2025 年 12 月に Anthropic から公開され、2026 年初頭には臨界規模に達しています。技術選定とコスト判断で引用できる三つのデータポイントを示します。
NodeMini の業務に近い例として、/mac-quote（機種 + 期間から見積 PDF）、/contract-draft（標準リース契約草稿）、/device-check（返却前チェックリスト）の三 Skill が反復作業を削減します。これらのスクリプトは macOS 上で 7×24 利用可能である必要があります。ローカル MacBook はフタを閉じると停止し、Linux VPS には Xcode と Apple ツールチェーンがありません。
Skill スクリプトと Agent をリモート Mac Mini レンタルノードに常駐させ、SSH で /deploy をトリガーし scripts/validate.py を実行して結果を返すパターンは、2026 年 Mac 開発者ワークフローの自然な延長です。ノート PC は Skill 編集と diff レビューのみ担当し、重いスクリプト、長セッション、Hook 監視はクラウド独占 Mac に任せます。これはAI 開発者スタックの「算力ノード化」と一致します。
ローカル MacBook で IDE Agent、Skill スクリプト、ローカル推論を同時実行すると、メモリと発熱が先にボトルネックになります。Linux VPS は macOS ネイティブツールチェーンがなく、xcodebuild、Keychain、notarytool を含む Skill 手順を信頼して実行できません。Skill を 7×24 常駐させたいが毎年最高配 MacBook を買い替えたくないチームにとって、NodeMini の Mac Mini クラウドレンタルが通常は最適解です。秒級プロビジョニング、SSH 主軸接続、独占 compute、透明な料金により、Agent Skill ワークフローと iOS CI/CD が同一の安定 macOS ベースラインを共有できます。
MCP（Model Context Protocol）はツール呼び出しプロトコルで、外部 API、データベース、SaaS を接続します。Skill は操作ガイドで、Agent にいつ・どの順序でタスクを実行するかを指示します。両者は補完関係にあり、Skill は MCP ツール呼び出しを編成できますが、MCP の接続能力そのものは置き換えません。
Skill は構造化されたガイダンスであり、強制実行ではありません。モデルは依然として自律判断します。トリガー条件、エラー処理、Verify 手順を明確に書くほど一貫性が上がります。実タスクで description のトリガー語をテストし、単一責任原則を守ってください。