Skill と CLAUDE.md・AGENTS.md・Cursor ルールの違い

結論から

CLAUDE.md、AGENTS.md、Cursor のルールは すべてのセッション でコンテキストに入るため、事実と境界線だけにとどめましょう。Skill は そのタスクが出てきたときだけ 読み込まれるので、長い手順を入れても、すべてのチャットが重くなることはありません。

CLAUDE.md、AGENTS.md、Cursor のルールを読むのは誰か

Claude Code は CLAUDE.md を、Codex は AGENTS.md を読み、Cursor は自身のルールに加えてその両方を読みます。3 つとも SKILL.md を読みますが、必要なときだけです。

ファイル	読むエージェント	タイミング
`CLAUDE.md`	Claude Code、Cursor	Claude Code：セッション開始時に `~/.claude/CLAUDE.md` とプロジェクトから読み込み、サブフォルダのファイルは Claude がそのフォルダで作業するときに読み込みます。Cursor：常に適用。
`AGENTS.md`	Codex、Cursor	Codex：まず `~/.codex/AGENTS.md`、次にリポジトリのルートから起動したフォルダまで、各フォルダのファイルを 1 つずつ読み込みます。最も近いものが優先され、合計 32 KiB までです。Cursor：常に適用。
`.cursor/rules/*.mdc`	Cursor	4 つのモードのいずれか：Always Apply、Apply Intelligently、Apply to Specific Files、Apply Manually
`SKILL.md`	3 つすべて	依頼が一致したとき、または名前で呼び出したときだけ

目安はこうです。1 行に収まり、すべてのチャットで守るべきことなら指示ファイルに。説明に 1 ページ必要で、ある種類のタスクにしか関係しないなら Skill に。

すべてのセッション

指示ファイルは、使うかどうかにかかわらず、すべてのチャットでコンテキストを消費します

必要なときだけ

Skill は、使われるまで約 1 文分のコストしかかかりません

よくあるビフォーアフター

CLAUDE.md に、リリースノートの書き方を説明する 60 行のセクションが少しずつ育っていきます。デバッグのセッションも含め、すべてのチャットがそのコストを払います。これを Skill に移せば残るのは 1 行だけで、手順はリリースノートを頼んだときだけ読み込まれます。

CLAUDE.md（移行後）

- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.

1
手順を .claude/skills/release-notes/SKILL.md（Codex と Cursor なら .agents/skills/）に切り出します。
2
いつ使うのかを伝える description を書きます。
3
指示ファイルには、1 行の案内だけを残します。
表示されるはずのもの： 指示ファイルが短くなり、手順はリリースノートを頼んだときだけ読み込まれます。

Cursor では、/migrate-to-skills で “Apply Intelligently” のルールを Skill に自動変換できます。

Claude Code がすべてのセッションの開始時に読み込む、指示を書いた Markdown ファイルです。個人用は ~/.claude/CLAUDE.md に、プロジェクト用は CLAUDE.md または .claude/CLAUDE.md に置きます。

両方使いましょう。常に当てはまる短いルールは AGENTS.md に、必要なときだけ読み込むべき手順は Skill に入れます。Codex ガイドで両方を解説しています。

違います。ルールは会話に追加される .mdc ファイルで、Skill は関係があるときや呼び出したときにエージェントが使うフォルダです。Cursor ガイドをご覧ください。

このガイドは役に立ちましたか？