← 開発日記に戻る

Claude Skills・Agent Skills・Cursor Rules の違いは?2026 対照ガイド

AI コーディング & ワークフロー · 2026.08.08 · 約 15 分

Claude Skills、Agent Skills、Cursor Rules の三層対照

「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 RulesClaude Code SkillsAgent 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(namedescription 等)+本文 Runbook +任意の references/・スクリプト。Cursor、Claude Code などのホストが同じ規約でパースするため、チームは同じ Skill 本文.cursor/skills.claude/skills に同期でき、各ツールのドキュメントに沿って frontmatter だけ微調整すればよい。標準が解くのは移植性であり、Cursor Rules の常駐制約は代替しない。

一言で覚える
Cursor Rules = Cursor の家規(自動・常駐);Claude Skills = Claude Code の SOP(オンデマンド);Agent Skills = みんなで使う SOP ファイル形式(ツール横断)。

3. 核心比較表(How Compare)

Cursor Rules vs Claude Skills vs Agent Skills
種別 入口 実行能力 コンテキスト 向いている人
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:commitsecurity-reviewdisable-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 フォルダにコピーすれば動く」 → 拡張子とローダーが異なる;.mdc Rules は Skill の description マッチをしない。
  • 「3 つは排他的で 1 つだけ選ぶ」 → 典型は Rules(制約)+ Skills(フロー)+ Agent Skills 形式(共有)
  • 「Skills があれば Rules 不要」 → Skills はオンデマンド;「毎回 force push 禁止」類の底線は代替できない。
  • 「標準が更新されれば Claude Skills は自動互換」 → agentskills.io と各ホストの changelog を追う;frontmatter フィールドは分化しうる。

7. 7 ステップ導入:コピー可能な例付き

  1. 棚卸し:毎会話守る制約 → Cursor Rules 候補;たまに走るフロー → Skills 候補。
  2. Rules を書く:1 ファイル 80 行未満、globs でスコープ限定。
  3. Agent Skills 仕様で SKILL.md 起草name と動詞始まりの description
  4. ホストディレクトリへ:Cursor は .cursor/skills/<name>/SKILL.md;Claude Code は .claude/skills/
  5. 高リスク Skilldisable-model-invocation: true/security-review 等の明示呼び出しのみ。
  6. Git にコミット:コードと同 PR で、個人ノートだけに置かない。
  7. macOS ノードを紐付け:Skill に Xcode/shell がある場合、Runbook に SSH 先と事前チェックを書く。
例 1:Cursor Rule(常駐制約)
# .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.
例 2:Agent Skills 形式(デュアルホストで本文共有可能)
# .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.
例 3:Claude Skills 専用オプション(任意 frontmatter)
---
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

Claude Skills と Agent Skills は同じものですか?
完全同一ではありません。Agent Skills は SKILL.md の書き方を定めるオープン仕様、Claude Skills は Claude Code がその仕様を実装した製品名です。「Claude Skill が Agent Skills 標準に準拠している」とは言えますが、Agent Skills を Claude 専用と理解するのは誤りです。
Cursor Rules は Skills の代わりになりますか?
なりません。Rules は自動常駐で短い制約向き、Skills はオンデマンドで長いフロー向き。長い Runbook を Rules に入れると毎会話が重くなり、誤コストも増えます。
SKILL.md は Git にコミットすべきですか?
すべきです。.cursor/rules と同様、チーム共有の Skills はコードと同倉でバージョン管理し、clone した新メンバーが同じ AI エンジニアリング設定を継承できるようにします。
Claude Code のみで Cursor を使わない場合、Cursor Rules は必要ですか?
Cursor Rules ファイルは不要です。CLAUDE.md やプロジェクト説明で常駐制約を担い、Skills は将来のツール移行に備え Agent Skills 形式で書くことを推奨します。
Workflow の記事との違いは?
Workflow 記事は「編成層+Rules+Skills」で AI コーディング全体を組む話。本記事は 3 つのバズワードの定義と対照に特化し、スラッシュコマンドや CI トリガーなど Workflow 詳細は展開しません。
Xcode を含む Skill でクラウド Mac が推奨される理由は?
codesign と xcodebuild はネイティブ macOS が必須。Skill は手順を述べ、実際の実行には安定した Mac ノードが要る。クラウド Mac は 7×24 の SSH 環境を提供し、ノート PC を徹夜稼働させない。

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 完走させよう。

Hashvps · Mac クラウド

Rules と Skills には安定した Mac ノードを

Cloud Mac mini M4、ネイティブ macOS と SSH。SKILL.md Runbook を Xcode/CI 実行ノードに。

ホームへ
期間限定