「Claude Skills」で検索すると Anthropic のドキュメント、「Agent Skills」で agentskills.io、「Cursor Rules」で IDE 設定——3 つとも Skill や Rule という語が入り、「同じものを別フォルダに置いただけでは?」と感じる人が多い。実際は 3 層に分かれる:Cursor Rules は IDE に常駐する家規、Claude Skills は Claude Code のオンデマンド Runbook 製品機能、Agent Skills はツール横断の SKILL.md オープン形式。本記事は統一フィールド比較、シナリオ行列、コピー可能な例で命名の混乱を一度に整理する。非対称な結論:分水嶺は「常駐制約 vs オンデマンド手順書 vs 形式の公約」であり、どのモデルが強いかではない。
Cursor と Claude Code を併用する開発者向け。3 者の定義、ファイルパス、読み込みタイミング、移植性、よくある混同を解説。サイト内のWorkflow / Rules / Skills 三層エンジニアリング記事は「ワークフローの組み方」、本記事は「3 つのバズワードがそれぞれ何か」の名詞対照表。公式:Cursor Rules、Claude Code Skills、Agent Skills Specification。
1. なぜ Claude Skills・Agent Skills・Cursor Rules は混同されやすいのか
2025 年後半から 2026 年にかけ、AI コーディングツールは一斉に「バージョン管理可能な Agent 設定」を打ち出した。Cursor は .cursor/rules と .cursor/skills を強化、Anthropic は Claude Code で .claude/skills を推進、コミュニティは agentskills.io をクロスホスト標準として整備。3 つの流れがほぼ同時期に重なり、マーケティングも「Skill」「Agent」を多用するため、日本語圏でも訳語が揺れ、典型的な混乱が起きる:
- 30 ステップのリリース手順を Cursor Rules に書き、毎回の会話が数千 token を背負う;
- Claude Code で「Rules パネル」を探すが、製品名は Skills;
- 誰かが共有した
SKILL.mdを.cursorと.claudeのどちらに置くか分からない; - 「Agent Skills」を新しい SaaS と思い込むが、実はファイル形式の仕様である。
根因は製品層・実装層・標準層の命名が重なっていること。すでにAI Coding Workflow、Rules、Skills 完全解説を読んだ方は、あちらを「ワークフローアーキテクチャ」、本記事を「名詞対照表+意思決定ハンドブック」として補完関係に置いてほしい。重複は意図的に避け、定義と対照に集中する。
さらに、個人開発者は「とりあえず全部 AGENTS.md に書く」傾向があり、チームは「Rules と Skills の境界が曖昧でレビューできない」という別の痛みを抱える。前者はコンテキスト肥大、後者はガバナンス不全——どちらも層の誤配置が原因だ。本記事の比較表は、PR で「これは Rule か Skill か」を議論する共通言語になる。
2. 3 者それぞれの定義(What)
2.1 Cursor Rules — 常時ロードされる制約層
Cursor Rules は Cursor IDE の常駐ポリシー。プロジェクトを開き glob にマッチすると自動でコンテキストに注入される。典型的な場所は .cursor/rules/*.mdc、ユーザー Settings の Rules、ルートの AGENTS.md。最小 diff、触ってはいけないディレクトリ、返答言語、いつテストを走らせるか、force push 禁止など、短く・硬く・毎会話で成立する条項向き。公式も Rules は簡潔に——長い Runbook はここに書かない。
2.2 Claude Skills — Claude Code のオンデマンド Runbook 製品
Claude Skills(Claude Code Skills)は Anthropic のターミナル/IDE Agent 製品内の能力パッケージ。.claude/skills/<name>/SKILL.md(ユーザー級も可)。Agent は frontmatter の description を先に読み、意図が合えば本文をロードして code review、リリース、セキュリティ監査など多段フローを実行。/skill-name の明示呼び出しや disable-model-invocation による誤トリガー防止もサポート。深い選定はClaude Code Skills 10 フレームワークガイドを参照。
2.3 Agent Skills — クロスツールの SKILL.md オープン標準
Agent Skills は特定ベンダーの機能スイッチではなく、Agent Skills Specification が定めるファイル形式とディレクトリ慣習。SKILL.md の frontmatter(name、description 等)+本文 Runbook +任意の references/・スクリプト。Cursor、Claude Code などのホストが同じ規約でパースするため、チームは同じ Skill 本文を .cursor/skills と .claude/skills に同期でき、各ツールのドキュメントに沿って frontmatter だけ微調整すればよい。標準が解くのは移植性であり、Cursor Rules の常駐制約は代替しない。
3. 核心比較表(How Compare)
| 種別 | 入口 | 実行能力 | コンテキスト | 向いている人 |
|---|---|---|---|---|
| Cursor Rules | プロジェクトを開く / glob マッチでロード | 編集行動・形式・禁区を制約 | 常駐、簡潔に保つ | Cursor ユーザー全員、レビュアー |
| Claude Skills | /skill または description の意味マッチ |
多段 Runbook(review、リリース)を実行 | オンデマンド、references/ 可 | Claude Code / API Agent ユーザー |
| Agent Skills | ホスト実装次第(独立製品ではない) | SKILL.md 構造とメタデータを規定 | ホストがロードするまで占有しない | クロスツールチーム、OSS メンテナ |
3.1 パスと所有権の対照
| 比較項目 | Cursor Rules Cursor 製品 | Claude Skills / Agent Skills Runbook 層 |
|---|---|---|
| 典型パス | .cursor/rules/*.mdc | .claude/skills/ または .cursor/skills/ 配下の SKILL.md |
| 標準の帰属 | Cursor ドキュメント | Agent Skills オープン仕様 + 各ホストのドキュメント |
| IDE 間コピー | Cursor のみ(概念は他社 Rules に手書き可) | 本文は共有可能、パスはホスト依存 |
| 向く内容 | 紅線、スタイル、権限 | チェックリスト、コマンド列、テンプレート |
4. シナリオ別の選び方 — 意思決定行列
| あなたのシナリオ | 優先するもの | 備考 |
|---|---|---|
| Cursor のみで業務コード | プロジェクト Rules 3〜5 条 → 必要に応じ Cursor Skills(Agent Skills 形式) | Rules に Runbook を書かない;review/移行は Skill へ |
| Claude Code ターミナル Agent のみ | Claude Skills(Agent Skills 形式)→ ユーザー級の常駐制約(CLAUDE.md 等) | Cursor Rules パネルはない;制約はプロジェクト説明ファイルへ |
| Cursor + Claude Code デュアルスタック | 共有 SKILL.md 本文 → .cursor/skills と .claude/skills に配置 → Cursor Rules は別管理 |
Agent Skills が形式、Cursor Rules が Cursor 専用制約 |
| OSS コントリビューションガイド | CONTRIBUTING + Agent Skills パッケージ(security-review)→ 任意で Cursor Rules 断片 | Skill は非 Cursor ユーザーにも説明価値がある |
| Xcode / codesign を含む Runbook | Skill にコマンド列 → Rules で signing 変更禁止 → macOS 実行ノード | GitHub Actions macOS ビルドと組み合わせ、コンパイルはリモート Mac へ |
5. 推奨スタック(Stack)
スタック A — Cursor 単独(個人プロジェクト)
- Rules:
core.mdcに紅線 3 条(最小 diff、勝手に commit しない、変更後 lint) - Skills:
code-reviewを 1 つ(Agent Skills 形式、.cursor/skills/) - Claude 用ディレクトリは作らず、リポジトリノイズを避ける
スタック B — Claude Code 単独(ターミナル優先)
- Claude Skills:
commit、security-review(disable-model-invocation: true) - プロジェクトルート
CLAUDE.mdが「常駐制約」役(Rules の類似、Agent Skills ではない)
スタック C — デュアルスタックチーム(推奨)
- 単一
skills/ソースまたは submodule を CI で.cursor/skillsと.claude/skillsに同期 - Cursor Rules は Cursor 開発者向け;Claude ユーザーは
CLAUDE.mdを読む - 新 Skill は先に Agent Skills の frontmatter で書き、各ツールで微調整
スタック D — リモート実行付き Agent
- Skill 内に SSH でクラウド Mac 上の
xcodebuild手順を明記 - Rules で未確認の本番設定変更を禁止
- 実行ノードは固定 macOS イメージ——AI コーディングツール選定の「実行環境」軸と一致
6. よくある誤解
「Agent Skills は Claude 専用」→ オープン形式;Claude Skills は Anthropic 実装の一つ。「Cursor Rules に 20 ステップのリリースを書ける」→ Skill に分割;Rules が長いほど毎会話のコンテキストを浪費。「SKILL.md を Rules フォルダにコピーすれば動く」→ 拡張子とローダーが異なる;.mdcRules は Skill の description マッチをしない。「3 つは排他的で 1 つだけ選ぶ」→ 典型は Rules(制約)+ Skills(フロー)+ Agent Skills 形式(共有)。「Skills があれば Rules 不要」→ Skills はオンデマンド;「毎回 force push 禁止」類の底線は代替できない。「標準が更新されれば Claude Skills は自動互換」→ agentskills.io と各ホストの changelog を追う;frontmatter フィールドは分化しうる。
7. 7 ステップ導入:コピー可能な例付き
- 棚卸し:毎会話守る制約 → Cursor Rules 候補;たまに走るフロー → Skills 候補。
- Rules を書く:1 ファイル 80 行未満、
globsでスコープ限定。 - Agent Skills 仕様で SKILL.md 起草:
nameと動詞始まりのdescription。 - ホストディレクトリへ:Cursor は
.cursor/skills/<name>/SKILL.md;Claude Code は.claude/skills/。 - 高リスク Skill:
disable-model-invocation: trueで/security-review等の明示呼び出しのみ。 - Git にコミット:コードと同 PR で、個人ノートだけに置かない。
- macOS ノードを紐付け:Skill に Xcode/shell がある場合、Runbook に SSH 先と事前チェックを書く。
# .cursor/rules/core.mdc --- description: Core repo constraints (always on) globs: "**/*" --- - Minimize diff; no drive-by refactors. - Never commit unless the user explicitly asks. - Do not modify backend/ unless the task requires it.
# .cursor/skills/code-review/SKILL.md (Claude: .claude/skills/code-review/SKILL.md) --- name: code-review description: Review staged git diff for bugs and test gaps. Use when user asks for review or before PR. --- 1. Run `git diff --staged` (or branch vs main). 2. Report Critical / Warning / Suggestion. 3. Do not auto-fix unless asked.
--- name: xcode-release description: Archive and export IPA on macOS runner. Manual invocation only. disable-model-invocation: true --- Prerequisites: macOS host, valid signing cert, Xcode selected. Steps: clean → archive → export → verify IPA checksum.
8. まとめ
Cursor Rules は「Cursor で毎会話越えてはいけない線」、Claude Skills は「Claude Code で某タスクを SOP 通りに」、Agent Skills は「その SOP ファイルの形とホスト間の運び方」。三者は代替ではなく制約層+製品能力+形式標準のコンボ。先に層で分類してから他人の設定パックをコピーすれば、「置いたのにトリガーしない」遠回りを減らせる。
関連:Cursor Rules · Claude Code Skills · Agent Skills オープン標準 · サイト内Workflow / Rules / Skills 三層エンジニアリング
FAQ
Rules と Skills を実運用するには、実行環境の一貫性が鍵
SKILL.md に書いた Xcode ビルド、Fastlane、launchd 手順を本当に走らせるにはネイティブ macOS が不可欠。Hashvps クラウド Mac mini M4 は SSH/VNC、専用 IPv4、再現可能な Homebrew 環境を提供——同じ Skills がローカルとクラウドで同じ挙動になり、Agent をノートのハードに縛らない。
Claude Skills や Cursor Skills を iOS リリースパイプラインに接続するなら、 Hashvps クラウド Mac はコスパの高い実行ノード—— プランを見る、Runbook をリモートで 7×24 完走させよう。