📋 目次

01 · Agent Skill が必要な理由（Prompt の貼り直しから脱却）

Cursor や Claude Code では、Agent Skill はエージェントが必要に応じて発見・有効化・実行する指示パッケージです。チャットに毎回貼る長い Prompt と違い、Skill は SKILL.md としてリポジトリやユーザーディレクトリに残り、タスクに合った場面で自動的にマウントされます。いわば「業務マニュアル」を配るイメージで、毎回口頭で規程を説明し直す必要がありません。

繰り返し Prompt の弱点は、Git で差分管理できない、チーム共有が難しい、別の Agent 実行環境に持ち込めないことです。「PR 説明は日本語で」「デプロイ前にこの三コマンド」といったノウハウを Skill に書けば、clone したメンバー全員が同じ振る舞いを得られます。Cursor 2.4 以降は Skill を Rules・MCP と並べ、手順・ドメイン知識・再現可能なワークフローを Skill に任せる設計になっています。

Mac 上で OpenClaw と OpenHuman の二重 Agent を運用している場合も、Skill は「特定の仕事のやり方」だけを教えるモジュールとして機能します。常時有効な Rule と、外部 API を叩く MCP とは役割が異なります。

02 · 繰り返し Prompt の三つのコスト

Skill 化の前に、多くのチームが次の非効率に直面します。

コンテキストの漂流：同じ注意書きがセッションごとに切り詰められたり忘れたりし、たまにポリシー違反が起きます。長い Prompt はトークンを消費し、コード閲覧の余地を狭めます。
属人化：ベテランのデプロイ手順がジュニアの Agent に届きません。個人の「魔法の Prompt」が散在し、レビューもされません。
シェル自動化への恐怖：bash や npm publish を含む Skill を主力 Mac で任せるのはリスクが高く、捨てられる検証環境がないと手動コピーに戻ってしまいます。

Skill は Markdown のバージョン管理で前两方を解消します。三つ目は本稿第 10 節のレンタル Mac 五手順で対処するのが現実的です。

03 · Skill と Rule の比較表

「.cursor/rules と Skill、どちらに書くべきか」は、常時注入か、タスク連動かで判断します。

観点	Agent Skill	Cursor Rule
読み込み	タスク一致時にオンデマンド	セッション中常時
内容例	PR 手順、リリースチェック、SDK 統合	コーディング規約、amend 禁止
配置	`.cursor/skills/`	`.cursor/rules/`
トークン	関連タスク時のみ	常に候補になりうる
オーナー	DevOps・SDK 担当	アーキテクト・規約担当

覚え方はシンプルです。毎回の会話で守らせたいことは Rule、特定の依頼のときだけ必要な手順は Skill です。500 行のデプロイ手順を always-on Rule に入れると、無関係な修正まで遅くなります。

04 · ディレクトリ構造と SKILL.md 規約

プロジェクト Skill は .cursor/skills/<name>/SKILL.md に置きます。個人用は ~/.cursor/skills-cursor/ です。1 Skill = 1 フォルダが原則です。

                        # 推奨レイアウト

.cursor/skills/deploy-staging/

├── SKILL.md

├── scripts/smoke-test.sh

└── references/rollback.md

YAML frontmatter の description はルーティングキーです。発見段階では name と description だけが見えるため、「何を・いつ・除外条件」まで具体的に書きます。

05 · 三段階の漸進読み込み

発見：全 Skill の name + description のみ。
有効化：マッチした Skill の SKILL.md 全文。
オンデマンド：scripts/・references/ は指示があるまで未読。

長い API 資料は references/ に分離し、本体はおおよそ 500 行以内に収めるのが公式の目安です。リモート SSH で試す場合も、無駄なトークンは帯域と時間の無駄になります。

06 · Skill の作り方（六ステップ）

方法 A：`/create-skill`

Cursor の Agent チャットで /create-skill を実行すると、用途・トリガー・手順を対話で整理し、frontmatter 付きの雛形が生成されます。初めて Skill 化するチーム向けです。

方法 B：手動六ステップ

単一責務：1 Skill = 1 種類のタスク。
ルーティング可能な description：三人称でトリガーと除外を明記します。
SKILL.md を作成：.cursor/skills/your-skill/ に配置します。
資源の分割：長文・シェルは references/・scripts/ へ。
チャット検証：description に沿った依頼で有効化を確認します。
PR と索引：README に Skill 一覧を載せ、重複開発を防ぎます。

07 · ベストプラクティスと数値

📌 2026 年の三つの数字：

agentskills.io に 31,000 超のコミュニティ Skill が登録されています；
Cursor 2.4+ でプロジェクト／ユーザー Skill のネイティブ発見が可能です；
SKILL.md は約 500 行以内が推奨で、超過分は references へ逃がします。

副作用のあるコマンドは本文で太字警告し、グローバル禁止は Rule、手順は Skill に分けるのが鉄則です。古い Skill は誤ルーティングの原因になるため、定期的に整理してください。

08 · 2026 スキルエコシステム

Skill は単一 IDE の小技から、ツール横断の interchange 形式へ進化しています。agentskills.io で検索・fork し、自社のブランチ戦略に合わせて description を書き換える運用が一般的です。ローカルで OpenClaw 系 Agent を動かす場合は、Skill でリポジトリ手順を固定し、MCP でチケットや DB に触る構成が多いです。

Xcode ビルドや署名を Skill に含める場合は、Mac mini M4 料金案内で日次レンタルと買い切りの TCO を比較するのがよいでしょう。

09 · FAQ：Skill、MCP、スコープ

Skill と MCP の違いは？

Skill は手順書（Markdown＋任意スクリプト）です。MCP は実行時に外部システムへ接続するプロトコルです。本番 DB のリアルタイム参照は MCP、リリース前チェックリストの統一は Skill です。

グローバルとプロジェクト Skill の置き場所は？

プロジェクトは .cursor/skills/、個人は ~/.cursor/skills-cursor/ です。同名は通常プロジェクトが優先されます（最新の Cursor ドキュメントを参照してください）。

Skill は勝手にシェルを実行しますか？

Skill は「どう実行するか」を示しますが、ターミナル起動は権限とユーザー確認の対象です。破壊的操作は description に明記し、隔離 Mac で先に試してください。

SSH・VNC・料金の詳細は日次レンタル Mac ガイド（FAQ）をご覧ください。

10 · レンタル Mac でスクリプト型 Skill を隔離検証（五手順）

npm test、docker compose、fastlane 署名などを Skill に含めるとき、主力 Mac での全自動実行は避けた方が安全です。

ノードを借りる：Apple Silicon・Xcode 入り macOS（Mac mini M4 など）を SSH/VNC で接続します。
隔離 clone：読み取り専用トークンでリポジトリを複製し、本番秘密情報を触らせません。
対象 Skill のみ有効化：実験中の Skill を止め、変数を減らします。
ログを保存：終了コードと標準出力を証跡に残し、失敗は Skill 側を直します。
マージ後に返却：問題なければ PR をマージし、インスタンスを解放して課金を止めます。

Linux VPS だけでは Xcode・iOS 署名・公証・Keychain の再現が難しいため、本番と同じ macOS で試す日次レンタルが費用対効果に優れる場面が多いです。単価は M シリーズ料金ページを参照してください。