Claude CodeでCLAUDE.mdとスキルを分割して量産する方法|工程別マニュアル化の手順と判断基準

Claude CodeでCLAUDE.mdとスキルを分割して量産する方法|工程別マニュアル化の手順と判断基準の要点を表すアイキャッチ
目次

この記事の結論と対象読者

この記事の結論と対象読者の図解
この記事の結論と対象読者の要点を図解しています。

Claude Codeで記事や投稿を量産したいとき、1つの巨大なCLAUDE.mdに全部書き込むと読み飛ばしやトークン浪費が起きます。この記事は、工程ごとに指示書を分割し、スキルとして呼び出す構成を、Claude Code歴半年の運営者の実運用をもとに具体的な手順で示します。対象はClaude Codeを使い始めて半年未満で、同じような業務指示を毎回打ち込んでいる方です。

判断基準:CLAUDE.mdとスキルのどちらを使うか

判断基準:CLAUDE.mdとスキルのどちらを使うかの図解
判断基準:CLAUDE.mdとスキルのどちらを使うかの要点を図解しています。

指示書をCLAUDE.mdに書くかスキルに分けるかは、使う頻度と専用性で決めます。CLAUDE.mdは毎回の会話開始時に自動で読み込まれる一方、スキルは関係する場面でClaudeが自動で使うか、呼び出したときだけ読み込まれます。

両者の違いを一覧で比べると、どちらに書くべきか判断しやすくなります。

比較項目 CLAUDE.md スキル(SKILL.md)
読み込まれるタイミング 毎回の会話開始時に自動で読み込まれます 関係する場面でClaudeが自動で使うか、/スキル名で呼び出したときだけ読み込まれます
向いている内容 禁止事項・完了条件・出力形式など全工程共通のルール リサーチ・構成作成・執筆・推敲など特定の工程だけの手順
分量の目安 1ファイル200行未満が目安です 工程ごとに分けるため1本あたりは短くできます
置き場所 プロジェクト直下の./CLAUDE.mdか./.claude/CLAUDE.md、全プロジェクト共通は~/.claude/CLAUDE.md プロジェクト用は.claude/skills/<名前>/SKILL.md、全プロジェクト用は~/.claude/skills/<名前>/SKILL.md
トークンへの影響 毎回読み込まれるため、肥大化すると常に文脈を圧迫します 呼ばれたときだけ読み込まれるため、使わない工程のスキルは文脈を圧迫しません
更新のきっかけ 同じミスが2回起きたら追記します 工程の手順が変わったとき、その工程のスキルだけを直せます

この表にしたがうと、CLAUDE.mdは「全体のルールブック」、スキルは「工程ごとの作業手順書」という役割分担になります。迷ったときは、「この指示はすべての工程で毎回必要か」を基準に、イエスならCLAUDE.md、ノーならスキルへ振り分けてください。

再現可能な手順:工程別スキルを作るまで

再現可能な手順:工程別スキルを作るまでの図解
再現可能な手順:工程別スキルを作るまでの要点を図解しています。

実際に手を動かす順番を示します。ここではブログ記事を量産する想定で進めます。

  1. 作業用フォルダを1つ作り、そこでclaudeを起動します。初回はブラウザでのログインを求められますが、以後はログインし直す必要がありません(Quickstart)。
  2. /initを実行し、コードベースやフォルダ構成からCLAUDE.mdの下書きを作らせます(commands)。
  3. 下書きを開き、全工程共通のルール(禁止表現、文体、完了条件)だけを残し、工程固有の手順は削除します。
  4. 工程ごとにスキルフォルダを作ります。プロジェクト用なら.claude/skills/<名前>/SKILL.mdに置きます(skills)。
  5. 大きな変更を伴う作業では、いきなり実行させずPlan modeで計画を確認します。会話中はShift+Tabで切り替えるか、指示の先頭に/planを付けます(permission-modes)。

SKILL.mdの記述例

---
name: blog-structure
description: ブログ記事の見出し構成案を作る。リサーチ資料を渡して呼び出す。
---

# 手順
1. 渡されたリサーチメモから検索意図を3つに整理する
2. 検索意図ごとにH2見出し案を1つずつ作る
3. 各H2に対応するH3候補を2〜3個出す
4. 出力は箇条書きのMarkdownのみ。前置きの説明文は書かない

このスキルは/blog-structureで直接呼び出せます。呼び出す際にClaude Codeへ貼る指示文の例は次の通りです。

/blog-structure このリサーチメモ(research/202609-keyword.md)を元に構成案を作ってください。対象読者は初心者です。

具体例:3つの工程を分割した場合の構成

具体例:3つの工程を分割した場合の構成の図解
具体例:3つの工程を分割した場合の構成の要点を図解しています。

実際にフォルダを分けるとこのような形になります。

project/
├── CLAUDE.md          # 全工程共通ルール(文体、禁止事項、完了条件)
├── .claude/
│   └── skills/
│       ├── research-note/SKILL.md     # リサーチ結果の整理手順
│       ├── blog-structure/SKILL.md    # 構成案作成手順
│       └── blog-draft/SKILL.md        # 執筆手順
└── knowledge/
    └── past-examples.md   # 過去に公開した記事の実例

CLAUDE.mdには「ですます調で統一する」「煽り表現を使わない」といった全工程共通のルールだけを書き、工程固有の手順はスキル側に書きます。これにより、執筆だけを頼みたいときに/blog-draftを呼べば、リサーチや構成の手順を読み込まずに済みます。

この図は、リサーチから執筆までの一連の作業が、どの順番でどのフォルダ・ファイルに渡るかを軸に示しています。

図の構成要素は次の通りです。左端に「研究者(読者)」のノードを置き、そこから右向きの矢印で「research-noteスキル実行」のノードへつなぎます。そこから矢印で「research/*.mdに保存」のノードへ、さらに矢印で「blog-structureスキル実行」のノードへ進み、「構成案(Markdown)」のノードを経て、最後に矢印で「blog-draftスキル実行」から「原稿ファイル」のノードへ到達する一本道の流れです。各ノードの下に、そのスキルが参照するCLAUDE.mdのルールを小さく添えておくと、どの段階で共通ルールが効いているかも分かります。この流れを見て、まだスキル化していない工程があれば、その工程からSKILL.mdを1つ作ることを次の行動にしてください。

失敗例と対策

失敗例と対策の図解
失敗例と対策の要点を図解しています。

実際によくある失敗と、その対策をまとめます。

失敗例 原因 対策
スキルを呼んでも反映されない SKILL.mdの置き場所が違う(プロジェクト用のつもりが~/.claude/skills/に置いていた) プロジェクト専用なら.claude/skills/<名前>/SKILL.mdに置き直す
CLAUDE.mdが200行を超えて肥大化 工程別の手順をすべて書き込んでしまった /doctorで設定点検を行い、コードから分かる内容を削る提案を参考にしてスキルへ移す
同じ指摘を何度も修正している 「いい感じに」のような曖昧な指示のままにしている 再発した指摘はCLAUDE.mdかスキルの手順に具体的な条件として追記する

/doctorはCLAUDE.mdについて、コードから分かる内容を削る提案を出してくれるため、肥大化したCLAUDE.mdの整理に使えます。

初心者向け最小構成

最初から61本のスキルを作る必要はありません。最小構成は次の3点です。

  • CLAUDE.mdに、文体と禁止事項と完了条件だけを書きます(20〜30行程度でも機能します)
  • 最も頻度の高い1工程だけをスキル化します(例:構成案作成だけ)
  • /memoryでCLAUDE.mdを開き、同じミスが2回起きたタイミングで1行追記する運用から始めます

/memoryはCLAUDE.mdを編集し、自動メモリのオンオフも切り替えられるコマンドです。最初はこの1コマンドだけ覚えておけば十分です。

中上級者向け応用:文脈の節約とセッション管理

スキルの数が増えてくると、どの作業にどのコマンドを使うかの選択が増えます。会話が長くなったときの選択肢を比較します。

コマンド できること 制限・注意点 選び方
/compact 会話を要約して文脈の空きを作ります 要約自体が会話全体を読む大きな処理になります 同じ会話を続けたいが文脈が重いとき
/clear 空の文脈で新しい会話を始めます 直前の会話は/resumeで戻せます 別の作業に切り替えるとき
/rewind 「コードと会話」「会話のみ」「コードのみ」を選んで巻き戻します Bashコマンドで変更したファイルは巻き戻せません 直前の変更を取り消したいとき

この図は、今どんな場面に直面しているかを軸に、どのコマンドへ進むかの分岐を示しています。

図の構成要素は次の通りです。頂点に「会話が長くなった/変更を取り消したい」という分岐開始のノードを置き、そこから3方向に矢印を伸ばします。1つ目は「別の作業に切り替えたい」というラベルの矢印で「/clear」のノードへ、2つ目は「同じ作業を続けたいが文脈が重い」というラベルの矢印で「/compact(残す焦点を指示で渡す)」のノードへ、3つ目は「直前の変更を取り消したい」というラベルの矢印で「/rewind」のノードへつなぎます。さらに/rewindのノードから「Bashで変更したファイルか」を問う分岐を追加し、「はい」なら「対象外・手動確認」のノードへ、「いいえ」なら「コードと会話/会話のみ/コードのみを選択」のノードへ矢印を伸ばします。自分の状況がどの分岐に当てはまるか確認し、該当するコマンドをその場で打ってください。

巻き戻しは入力欄が空の状態でEscを2回押すか/rewindで開けます。ただしBashコマンドで直接変更したファイルは対象外なので、ファイル操作をBash経由で行った直後は巻き戻しに頼らないほうが安全です(checkpointing)。

サブエージェントを使うと、リサーチや検品のような作業を専用の文脈で行わせ、要約だけを本体の会話に返せます(sub-agents)。工程別スキルと組み合わせる場合、.claude/agents/にリサーチ専用・検品専用のエージェントを定義しておくと、本体の会話を圧迫せずに並行して作業を進められます。

実践で分かったこと

運営者自身の運用で、工程分割がどう効いているかを2点、数値付きで共有します。

1つ目は、スキルの命名規則です。2026年9月時点で自作スキルは61本あり、コンテンツ販売系と台本系で名前の付け方を分けています。これは、スキルが増えるほど「どれを呼べばいいか」で迷う時間が増えるためで、名前の先頭で系統が分かるようにすることで、呼び出し時に一覧を見返す手間を防いでいます。1つのSKILL.mdにまとめず分割する判断は、この命名規則が機能する前提があって初めて効果が出ます。1本の巨大なスキルにしてしまうと、名前で系統を分ける意味がなくなります。台本づくりについては、複数あった旧手順を1つの入口スキルに統合しており、分割しすぎても呼び出しが煩雑になることが分かっています。分割の単位は「呼び出す頻度のまとまり」で決めるのが実運用上の基準です。SKILL.mdの古さが問題になるケースもあるため、内容を変更したときは必ずその場で更新するか、使われなくなった手順は破棄しています。これにより、古い前提のままスキルが実行されて出力がずれることを防いでいます。

2つ目は、バックアップの頻度です。Vault全体を非公開のGitHubリポジトリに15分ごとに自動で同期しています。これは、CLAUDE.mdやスキルのファイルをClaude Code自身に編集させる運用では、意図しない上書きや削除が起きる可能性があるためで、短い間隔で同期しておくことで、問題が起きても15分前の状態まで戻せる状態を保てています。スキルやCLAUDE.mdを育てていく運用では、会話の巻き戻しとファイルの復元は別物なので、バックアップの頻度自体を独立した安全策として持っておく必要があります。

一般的な手順と運営者の運用の比較

工程分割の一般的な進め方と、実際の運用でどう変えているかを比べます。

項目 一般的な手順 運営者の運用 運用にしている理由
スキルの命名 工程名をそのままファイル名にします コンテンツ販売系・台本系で接頭辞を分けます スキルが61本まで増えても系統が名前だけで分かるようにするためです
古い手順の扱い 使わなくなっても残しておきます 変更時に必ず更新するか破棄します 古い前提をClaudeが優先して出力がずれるのを防ぐためです
バックアップ 作業後に手動でコミットします 15分ごとに自動同期します CLAUDE.mdやスキルをAIに編集させる運用で、意図しない変更からすぐ復元できる状態を保つためです

FAQ

Q. CLAUDE.mdとスキルはどちらから作り始めるべきですか。

A. 最初はCLAUDE.mdだけで十分です。毎回の作業で繰り返し伝えているルールが見えてきた段階で、そのルールのうち特定の工程だけに関わるものをスキルへ切り出すのが無理のない順番です。

Q. スキルは何本くらいから分割しすぎと言えますか。

A. 明確な本数の基準はありませんが、呼び出すときに「どれを使えばいいか」で迷う状態になったら、似た工程のスキルを1つの入口にまとめるタイミングです。台本づくりのように複数の旧手順を1つに統合した例もあります。

Q. スキルを編集したら自動で改善されますか。

A. いいえ。スキルが使うたびに自動で改善される仕組みはありません。改善したい場合はSKILL.mdの手順を自分で書き直すか、Claudeに修正を依頼する必要があります。

Q. プロジェクトをまたいでスキルを使い回せますか。

A. ~/.claude/skills/に置けば全プロジェクトで使えます。プロジェクト固有の手順は.claude/skills/に置き、使い分けます。

まとめ

CLAUDE.mdには全工程共通のルールだけを書き、工程固有の手順はスキルに分割するのが、トークンを無駄にせず指示を読み飛ばされない構成です。最初は1つの工程だけスキル化し、同じ指摘が再発したタイミングでCLAUDE.mdかスキルへ具体的な条件として追記していけば、無理なく指示書を育てられます。巻き戻しとバックアップは別物なので、/rewindの範囲を理解した上で、ファイル単位の自動バックアップも別に用意しておくと安全です。

工程分割やスキル化をさらに自分の業務に当てはめて進めたい場合は、公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取れます。

公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取る

一次情報

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次