生成AIClaudeプロンプト

CLAUDE.mdとスキルの使い分け|指示を置く場所の決め方と実例

CLAUDE.mdとスキルの使い分け|指示を置く場所の決め方と実例 生成AI
この記事は約15分で読めます。
記事内に広告が含まれています。

七里式や深津式で質問文の型を覚えたのに、Claude Codeのようなエージェントを使い始めてから、毎回同じ前置きを貼り直していないでしょうか。エージェントでは1回の質問文を磨くことより、指示をどのファイルに置いておくかで結果が変わります。筆者もブログの記事づくりをClaude Codeに任せるなかで、ルールの置き場所を何度か移してきました。この記事ではCLAUDE.md・スキル・毎回のプロンプトの使い分けを、公式の整理とブログ運営のVaultの実例で解説します。

第1章:七里式・深津式の要素はどこへ移るか──型の分解

質問文の型に入れていた要素は、エージェントでは「毎回同じもの」と「その回だけのもの」に分かれます。毎回同じものはファイルに置き、毎回のプロンプトにはその回だけのものを残します。

七里式の「8+1の公式」は、前提条件・対象プロファイル・参考情報・実行指示・出力形式・スタイルなどを1つの質問文に並べる型です。深津式は「あなたはプロの〇〇です」と役割を決め、「#命令書」「#制約条件」「#入力文」「#出力文」に区切ります。どちらもチャットの1回の質問にすべてを詰める前提で作られています。

ところが同じ種類の作業を毎日AIに頼むと、役割・文体・禁止事項は毎回同じです。それを毎回書く代わりに、ファイルに一度書いて読み込ませるのがエージェントの使い方です。型の要素は、次のように置き場所が分かれます。

型の要素七里式・深津式での名前エージェントでの置き場所理由
役割・前提「前提条件」、「あなたはプロの〇〇です」CLAUDE.mdどの作業でも同じなので、毎回読み込まれる場所に一度書く
読者「対象プロファイル」媒体ごとのルールのファイル媒体によって変わるが、同じ媒体なら毎回同じ
手順深津式のアレンジ「段階的な指示」スキル長く、特定の作業でしか使わない
文体・制約「スタイル」、「#制約条件」ルールのファイル。数えられる決まりはスクリプト文字数のように機械で確かめられるものは、言葉で頼むより道具のほうが確実
出力の形「出力形式(文章)」「出力形式(形)」、「#出力文」雛形のファイルとスキル毎回同じ形なら雛形にする
参考情報「参考情報」ファイルとして置き、場所を伝える長い資料を質問文に貼らずに済む
今回の依頼「実行指示」「追加指示(+1)」、「#命令書」「#入力文」毎回のプロンプトその回にしかない情報

毎回のプロンプトに残るのは、「何を」「どれを」の部分だけです。質問文の型が無駄になったのではなく、型の要素が置き場所ごとに分かれたと考えると、移行しやすくなります。

第2章:CLAUDE.md・スキル・プロンプトの違い──使い分けの軸

3つの違いは、いつAIの文脈(コンテキスト)に読み込まれるかと、どれだけ確実に守られるかです。Anthropicは2026年6月18日の公式ブログで、指示を渡す7つの手段を「いつ読み込まれるか」「長い会話が要約されても残るか」「どれだけ強く効くか」の3つの軸で整理しています。

7つの手段とはCLAUDE.md、rules、スキル、サブエージェント、フック、出力スタイル、システムプロンプトへの追記です。よく使うものを、公式の表をもとにまとめました(最後の行は筆者が足したものです)。

置き場所読み込まれる時点文脈の負担向いているもの
CLAUDE.md(プロジェクト直下)会話の開始時に毎回大きい(関係のない行も毎回読む)どの作業でも守るルール、コマンド、決めごと
rules(.claude/rules/)開始時。対象のパスを指定したものは、そのファイルを触ったとき中くらい特定のフォルダだけの決まり
スキル(SKILL.md)開始時は名前と説明だけ。本文は使うとき小さい繰り返す手順
サブエージェント呼んだときだけ(別の文脈で動く)呼ぶまでゼロ調べもの、ログの分析などの脇の作業
フック決まった時点で必ず動く。長い会話の要約の影響を受けない—例外なく必ず行う処理
毎回のプロンプトその回その回だけその回の依頼

CLAUDE.mdの置き場所は、自分のすべてのプロジェクトに効く~/.claude/CLAUDE.md、プロジェクトの./CLAUDE.md、自分だけの設定を書く./CLAUDE.local.mdなどがあります。スキルは~/.claude/skills/<スキル名>/SKILL.md(自分用)か、.claude/skills/<スキル名>/SKILL.md(プロジェクト用)に置きます。

MacのFinderで、ホームフォルダの.claude/skillsを開き、スキルごとのフォルダが並んでいる画面
自分用のスキルの置き場所(~/.claude/skills/)。プロジェクトの中の.claude/skills/とは別の場所で、スキルごとにフォルダを作り、中にSKILL.mdを置く

最初のCLAUDE.mdは、Claude Codeの/initで自動で作れます。スキルのSKILL.mdは、筆者のVaultではどれも先頭に名前(name)と説明文(description)を書き、その下に手順を普通の文章で書く形です。たとえばx-postスキルの書き出しは次のとおりです。

---
name: x-post
description: X(@logicalyze)の投稿案を作る。(略)「Xの投稿案を作って」
「この記事を告知して」「スレッドにして」「ポストを書いて」「投稿を振り返って」で使う。
投稿は人が行う(Claudeは投稿案まで)。
---

注意したいのは、CLAUDE.mdが「必ず守られる設定」ではない点です。公式ドキュメントには、CLAUDE.mdの中身はシステムプロンプトそのものではなく、その後のユーザーメッセージとして渡され、Claudeはそれを文脈として扱うと書かれています。例外なく守らせたいことは、第3章で見るようにフックや道具の側に移すのが基本です。

第3章:置き場所を決める3つの質問──判断フロー

指示の置き場所は、「どの作業でも毎回必要か」「例外なく守らせたいか」「決まった手順か」の3つを問うと、ほぼ決まります。どれにも当たらなければ、その回だけの指定としてプロンプトに書きます。

指示の置き場所を3つの質問で決める判断フローの図
図1:指示の置き場所を決める3つの質問

毎回守らせるならCLAUDE.md

どの作業でも守ってほしいルールは、CLAUDE.mdに書きます。ただしCLAUDE.mdは毎回読み込まれるので、行が増えるほど文脈を使う量も増えます。公式のベストプラクティスの勧めは、書く前に「コードを読めばこれを見つけられるか」「実際に探しに行くか」と問い、両方とも「はい」なら書かないことです。

筆者のVaultでは、「公開は人が行う。Claudeは下書きまで」のように、どの作業でも破ってはいけないことをここに置いています。自分だけの好みは、チームと共有するCLAUDE.mdではなくCLAUDE.local.mdに書くよう、公式は案内しています。

繰り返す手順ならスキル

決まった順番で進める作業の置き場所は、スキルです。公式ドキュメントはスキルを作る目安を次のように書いています。

同じ指示、チェックリスト、または複数ステップの手順をチャットに何度も貼り付けている場合、または CLAUDE.md のセクションが事実ではなく手順に成長している場合は、スキルを作成してください。

スキルの本文は使うときだけ読み込まれるため、長い手順でも普段の文脈を圧迫しません。Claudeはdescription(説明文)を見て、関係のある場面で自動で使います。直接呼ぶときの書き方は/スキル名です。公開や送信のように外に影響する手順は、disable-model-invocation: trueを付けると、自動では読み込まれなくなります。

例外のない決まりは道具かフック

「必ず」と強調を足しても守られないことがあるなら、それは言葉で頼む決まりではありません。公式のベストプラクティスにも、CLAUDE.mdの行に強調を加え続けても見落とされるなら、その行はフックにすべきサインだと書かれています。

フックはファイルの編集やコマンドの実行の前後など、決まった時点で必ず動く処理です。筆者のVaultではフックは使っておらず、代わりにスクリプトの側で決まりを守らせています。たとえばWordPressに入稿するスクリプトは、送る状態を常に「下書き」に固定しているので、AIがどう判断しても公開されません。

その回だけの指定はプロンプト

今回のネタ、今回の締め切り、今回だけ変えたいことは、毎回のプロンプトに書きます。ここまでの3つに置いたことを、毎回のプロンプトで繰り返す必要はありません。

第4章:ブログ運営Vaultの実例──CLAUDE.mdと19のスキル

筆者のVaultは、Obsidianで開いているノートのフォルダです。GitHubのリポジトリとして管理し、Claude Codeもこのフォルダを開いて作業します。フォルダの直下にCLAUDE.md(89行)、.claude/skills/に19本のスキル、90_Rules/に媒体ごとの文体を置いています。その結果、毎回のプロンプトは1〜2行で済むようになりました。

VaultのリポジトリをGitHubで開き、.claude/skills、00_Inboxから99_Templatesまでの番号付きのフォルダ、CLAUDE.mdが並んでいる画面
VaultのリポジトリをGitHubで見た画面。直下にCLAUDE.md、.claude/skills/にスキル、番号付きのフォルダにノートを置いている
CLAUDE.md・スキル・ルールと道具・毎回のプロンプトの4層で指示を分けたVaultの構成図
図2:筆者のVaultでの指示の置き場所

CLAUDE.mdに置いているルール(抜粋)

CLAUDE.mdには「どこに何があるか」と「破ってはいけないこと」だけを書いています。ルールの部分から一部を抜き出すと、次のとおりです。

## ルール
- 原稿・投稿案は必ずfrontmatterを付ける(雛形は `99_Templates/`)
- 公開は人が行う。Claudeは**下書きまで**(WordPressは下書き保存、Xは投稿案まで)
- APIキー・パスワードはVaultに書かない(`.env` はVaultの外)
- 事実・数値・発表日は一次情報で確認し、出典URLを本文かfrontmatterに残す
- **Xの投稿案の文字数は、`.claude/skills/x-post/x_count.py` で数える**(Xは全角を2、半角を1、URLを1つ23として数え、上限は280。手で数えない)

このほかに、フォルダごとの役割の表と、「どの場面でどのスキルを使うか」の表を置いています。文体の細かい決まり(一人称、見出しの長さ、書かない言い回しなど)はCLAUDE.mdには書かず、90_Rules/blog.mdに分けました。CLAUDE.mdにはそのファイルの場所だけを書いています。

@ファイル名と書けば別のファイルをCLAUDE.mdに読み込めますが、公式ドキュメントによると、読み込んだファイルもCLAUDE.mdと一緒に読み込まれるため、文脈の負担は減りません。そのため場所を書くだけにして、記事を書くスキルが動いたときに読ませています。

記事制作スキルの中身(article-pipeline)

記事を最後まで作るときは、article-pipelineというスキルを使います。説明文(description)には、何をするスキルかと、どんな言葉で頼まれたら使うかを書いています。

description: 記事を「ネタ選び→構成→執筆→ファクトチェック→評価・修正→
AIっぽさの除去→画像→下書き保存→告知案」まで通しで作る。(略)
「この記事を最後まで作って」「トレンドの1位を記事にして」
「このネタをnoteで」「記事を通しで」で使う。

本文(153行)は工程の順番と、人が確認する場所を決めるだけの「司令塔」です。執筆・文章の仕上げ・WordPressへの入稿は、それぞれ別のスキルに任せています。人が確認するのは構成案と仕上がりの2回だけで、それ以外は止まらずに進みます。

毎回のプロンプトは1〜2行になった

この記事を書き始めたときのプロンプトは、次の1行でした。

00_Setup/system-overview.md を読んで、続きをお願いします。20_Ideas/2026-11-16-agent-era-instructions.md の新記事を書き始めたいです。

CLAUDE.mdとスキルを作る前は、プロンプトの冒頭に毎回、次のような前置きを書いていました。

あなたは、〇〇の専門家です。
〇〇をしてください。
(この下に要件定義を書き足す)

役割を決め、頼むことを書き、その下に要件定義を足していく、深津式の型に近い形です。今は役割・読者・文体・手順・出力の形をどれもファイルに置いてあるので、毎回のプロンプトで伝えるのは「どのネタを」だけです。この記事でも、構成案が出てきたあとの返事は「任せる」の一言でした。

第5章:置き場所を移した3つの例──失敗から

置き場所は最初から正しく決まるものではありません。筆者のVaultでも、うまくいかなかったところで置き場所を移してきました。

例1:Xの文字数を数えるのはスクリプトへ

2026年11月13日まで、Xの投稿案の文字数は「全角も半角も1字、URLは数えない」という数え方で、AIが数えていました。Xの公式の数え方は、全角を2、半角を1、URLを長さに関係なく1つ23と数え、上限は280です。このずれで、文字数の見積もりが20字ほど狂っていました。

正しい数え方をスキルに書き足しても、数えるのはAIのままです。そこでXと同じ数え方で数えるスクリプト(x_count.py)を作り、CLAUDE.mdには「x_count.pyで数える。手で数えない」という決まりだけを書きました。

翌日、4本の投稿案のうち1本が数えたあとの手直しで1字ずれていました。そこでスキルの手順に、保存の直前にもう一度数える工程を足しています。道具を作っても、いつ使うかは手順の側(スキル)で決める必要がありました。

例2:食い違うスキルには「読み替えの表」を

claude.aiのアカウントに登録した記事用のスキルは、Vaultの中から書き換えられません。そのスキルには、図の配色を紫にする、キャッチ画像をフラットなイラストにするなど、今のブランドと違う指定が残っていました。両方が読み込まれると、どちらに従うかがぶれます。

そこでCLAUDE.mdに「食い違うときはVaultのルールを優先する」と書き、記事の司令塔のスキルに、項目ごとの読み替えの表を置きました。置き場所が複数あるなら、どれを優先するかも書いておく必要があります。

例3:表記の決まりと直す道具を分ける

2026年11月16日に、日本語と英数字の間に半角スペースを入れない書き方にそろえると決めました。このとき、決まりは90_Rules/blog.mdの「表記」に書き、スペースを取り除く作業はスクリプト(fix_spacing.py)に、見落としの点検は原稿のチェック用スクリプトに分けています。

「何を守るか」はルールのファイル、「どう直すか」は道具に置くと、決まりが変わったときに直す場所が1か所で済みます。

第6章:増やしすぎ・長すぎを防ぐ──運用の注意

置き場所を分けても、どこかが膨らむと効きが落ちます。公式の目安と、筆者のVaultの今の状態は次のとおりです(2026年11月17日時点)。

項目公式の目安筆者のVault
CLAUDE.mdの長さ1ファイルあたり200行以下を目標89行
SKILL.mdの長さ500行未満に保つ(推奨)56〜169行
スキルの説明文一覧では1件あたり1,536字で切られる。一覧全体は文脈の1%まで(設定で変えられる)133〜279字
@で読み込んだファイル文脈の負担は減らない使わず、場所だけを書く

スキルを増やすほど一覧に並ぶ説明文も増えるので、説明文には「何をするか」と「どんな言葉で頼まれたら使うか」を短く書き、似たスキルを増やしすぎないようにしています。

スキルが呼ばれなかったように見えるときや、手順どおりに進んだか疑問を感じたときは、その場でClaude Codeに質問しています。たとえば記事を作ったあとに「評価と修正は何回繰り返した?」と聞くと、スキルに書いた手順を実際にたどったかを確かめられます。

ほかに気をつけていることは、次の3つです。

  • APIキー・パスワードはCLAUDE.mdにもスキルにも書かない。どちらも共有や公開をしやすいファイルなので、秘密の情報はVaultの外に置く
  • 公開・送信のように外に影響する作業は、人が行う。スキルで扱うなら自動で呼ばれない設定にし、スクリプトの側でも止める
  • 同じ注意を2回以上言い直したら、置き場所を見直す。毎回言うならCLAUDE.md、手順ならスキル、守られないなら道具かフック

よくある質問

ChatGPTやGeminiでも同じ考え方は使えますか?

使えます。ChatGPTやGeminiにも、指示を保存しておく機能があります。「毎回同じものは保存する場所へ、その回だけのものはプロンプトへ」という分け方は、どのサービスでも同じです。Geminiの設定については「Geminiのプロンプト設定ガイド」で解説しています。なお、スキルの形式そのものも、Anthropicが2025年12月18日に「Agent Skills」という公開の規格にしました。

AGENTS.mdとの違いは何ですか?

役目はほぼ同じで、読むツールが違います。Claude Codeが読むのはCLAUDE.mdで、公式ドキュメントによると、作業フォルダとその上のフォルダにCLAUDE.mdが無いときはAGENTS.mdを読みます。

七里式や深津式はもう要りませんか?

要らなくなったわけではありません。CLAUDE.mdやスキルを書くとき、役割・読者・制約・出力の形を漏れなく整理するのに、型はそのまま役立ちます。エージェントを使わないチャットでは、今も1回の質問文がすべてです。

CLAUDE.mdに書いたのに守られないときは?

CLAUDE.mdは文脈として渡されるもので、強制する設定ではありません。効くのは、強調を足すことより置き場所を変えることです。公式ドキュメントは、Claudeの判断に関係なく操作を止めたいときはフック(PreToolUse)を使うよう案内しています。筆者のように、スクリプトの側で決まりを守らせる方法もあります。

まとめ

  • 質問文の型の要素は、エージェントでは「毎回同じもの」と「その回だけのもの」に分かれる
  • 毎回守るルールはCLAUDE.md、繰り返す手順はスキル、例外のない決まりは道具かフック、その回の依頼はプロンプトに置く
  • 違いは「いつ読み込まれるか」と「どれだけ確実に守られるか」
  • 置き場所は失敗したところで移せばよい。複数の置き場所があるなら優先順位も書く
  • CLAUDE.mdは200行以下、SKILL.mdは500行未満を目安に、膨らんだら分ける

質問文そのものの組み立て方は、「七里式プロンプト「8+1の公式」完全ガイド」や「7Rプロンプトの使い方」にまとめています。Claudeで記事を書き直したときの記録は「Googleアップデートでアクセスが激減──Claude Pro でリライトしてみた話」で読めます。

更新履歴

日付内容
2026-11-17公開

出典

  • Anthropic「Steering Claude Code: CLAUDE.md files, skills, hooks, rules, subagents and more」(2026-06-18):https://claude.com/ja/blog/steering-claude-code-skills-hooks-rules-subagents-and-more
  • Claude Codeドキュメント「スキル」(2026-11-17確認):https://code.claude.com/docs/ja/skills
  • Claude Codeドキュメント「メモリ」(2026-11-17確認):https://code.claude.com/docs/ja/memory
  • Claude Codeドキュメント「ベストプラクティス」(2026-11-17確認):https://code.claude.com/docs/ja/best-practices
  • Anthropic「Agent Skills」(2025-10-16、2025-12-18追記):https://claude.com/blog/skills
  • X Developer Platform「Counting characters」(2026-11-17確認):https://docs.x.com/fundamentals/counting-characters
k2zo_o

AIコンテンツクリエイター。AIで動画やコンテンツを作っています。生成AI・Web・DTM・Macで、試して分かったことを発信中。

k2zo_oをフォローする
シェアする
k2zo_oをフォローする