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

結論からお伝えします。Claude Codeで試作や定型作業を積み上げるには、ルールはCLAUDE.md、繰り返す手順はスキルという役割分担が必要です。Claude Codeを使い始めたものの、指示を毎回書き直していたり、同じ修正を繰り返していたりする方に向けて、判断基準と再現手順をまとめます。
CLAUDE.mdとスキル、どちらに書くかの判断基準

両方ともMarkdownで書く指示書ですが、役割が違います。最初にこの違いを押さえると、無駄な書き直しを防げます。
- CLAUDE.md向き:プロジェクト全体に常に効かせたいルール(出力形式、禁止事項、完了条件など)
- CLAUDE.md向き:同じ指摘を2回受けた内容(再発防止ルールとして追記する)
- スキル向き:特定の作業でだけ使う手順(資料作成、リサーチ、レポート生成など)
- スキル向き:呼ばれたときだけ読み込まれてよい内容(毎回読む必要がないもの)
CLAUDE.mdはプロジェクト直下の./CLAUDE.mdか./.claude/CLAUDE.md、全プロジェクト共通なら~/.claude/CLAUDE.mdに置くと、会話の開始時に自動で読み込まれます。1ファイル200行未満が目安です(Memory)。スキルは~/.claude/skills/<名前>/SKILL.mdかプロジェクトの.claude/skills/<名前>/SKILL.mdに置き、関係する場面でClaudeが自動で使うか、/スキル名で直接呼び出せます(Skills)。
再現手順:CLAUDE.mdとスキルを育てる流れ

実際に運用ルールを積み上げていく手順です。最初から完成形を作らず、使いながら育てる流れにしています。
- 作業用のフォルダ(Obsidianなどのノートアプリを使っている場合はそのVaultフォルダ)を作業対象にして
claudeを起動します。初回はブラウザでのログインを求められますが、以後はログインし直す必要がありません(Quickstart)。 - コードベースや既存フォルダがある場合は
/initでCLAUDE.mdの下書きを作ってもらいます(Commands)。 - 作業を進める中で同じ指摘を2回したら、
/memoryでCLAUDE.mdを開き、出力形式・禁止事項・完了条件を具体的に追記します(Memory)。 - 毎回同じ手順を繰り返す作業に気づいたら、手順をSKILL.mdに切り出します。
- CLAUDE.mdが想定どおり読み込まれているか不安なときは
/contextを使うと、文脈の使用量と一緒にCLAUDE.mdの読み込み状況も確認できます(Commands)。 - 大きな変更に入る前は、指示の先頭に
/planを付けるか、Shift+TabでPlan modeに切り替え、計画を承認してから実行します(Permission modes)。
貼ってそのまま使える指示文の例
/memory
次のルールをCLAUDE.mdに追記してください。
- Markdownファイルを新規作成するときは、冒頭に作成日をYYYY-MM-DD形式で入れる
- リサーチ系のアウトプットは「決定事項」「保留事項」「次に調べること」の3見出しで構成する
- 完了条件を確認せずに「できました」と報告しない
このように出力形式・禁止事項・完了条件を具体化することで、「いい感じに」という曖昧な依頼より手戻りが少なくなります。
SKILL.mdの書き方の例
---
name: competitor-research
description: 競合動画のリサーチを行い、伸びている動画をリスト化する手順
---
1. 指定したチャンネルの最新動画一覧を取得する
2. 再生数・登録者数・投稿日・再生時間を確認する
3. 条件を満たすものだけを「伸びている動画」として抽出する
4. 結果をMarkdownの表にしてresearch/フォルダに保存する
nameは呼び出し名、descriptionはClaudeが自動で使うかを判断する材料になります。手順は番号付きで、誰が読んでも同じ動きになるように書きます。
この図は、CLAUDE.mdへの追記とスキルの切り出しを時系列で並べ、どのタイミングでどちらに書くかの作業順序を示しています。図の流れを確認し、自分がいま書こうとしているルールがどの段階に当てはまるか照らし合わせてみてください。
具体例:録音データをナレッジ化する運用で確認したポイント

散歩中の音声メモや打ち合わせの録音をテキスト化してフォルダへ振り分ける作業を例にすると、取り込みのたびに「どのフォルダに入れるか」「ファイル名をどう付けるか」を毎回考えるのは非効率です。この種の作業は、取り込み範囲(直近24時間分だけ、など)と保存先のルールをスキルに固定しておくと、呼び出すだけで同じ形に仕上がります。一方で、取り込んだ内容をどう要約するか、どの決定事項を残すかといった判断は、作業のたびに状況が変わるため、CLAUDE.md側に「決定事項・失敗・再利用できる手順を分けて残す」という方針として書いておくほうが扱いやすくなります。
失敗例と対策

CLAUDE.mdとスキルの運用でつまずきやすいポイントと対策をまとめます。
- 失敗例:CLAUDE.mdに毎回の作業手順まで書き込み、ファイルが肥大化して読みにくくなる
対策:常に効かせたいルールだけをCLAUDE.mdに残し、個別の手順はスキルへ移します。/doctorはコードから分かる内容を削る提案を出してくれます(Commands) - 失敗例:Bashコマンドでファイルを直接操作させた後、気に入らない結果を巻き戻そうとして戻せない
対策:Bashコマンドで変更したファイルは巻き戻しの対象外であることを理解したうえで、重要な変更の前に現在地を把握しておきます(Checkpointing) - 失敗例:会話が長くなり、文脈が埋まって反応が遅くなる
対策:関係ない作業に移るときは/clearで新しい会話を始め、直前の会話が必要なら/resumeで戻ります(Commands)
初心者向け最小構成
まず試すだけなら、以下の最小構成で十分です。
- 作業フォルダを1つ用意し、
claudeを起動する - 最初はCLAUDE.mdもスキルも作らず、
/initで下書きを作ってもらう - 同じ指摘を2回したタイミングで、初めてCLAUDE.mdに1行追記する
- 権限モードは既定のManualのまま使う
この構成であれば、特別な設定をせずに最初の一歩まで進められます。
中上級者向け応用:セッション管理と仕組み化の使い分け
複数の作業を継続的にこなしていく場合は、セッション管理の使い分けと、スキルの数が増えたときの整理が重要になります。
セッション管理の比較表
| 選択肢 | 何をするか | 向いている場面 |
|---|---|---|
/compact |
会話を要約して文脈の空きを作る | 同じ作業を続けながら文脈を整理したいとき |
/clear |
空の文脈で新しい会話を始める | 別の作業・別のテーマに移るとき |
/rewind(Esc×2) |
コード・会話を選んで巻き戻す | 直前の変更や発言を取り消したいとき |
/compactは会話全体を読み直す大きな処理のため、続きが不要なら/clearのほうが負荷がかかりません(Costs)。どれを使うか迷ったら、「同じ作業の続きか」「別の作業への切り替えか」「直前の操作を取り消したいか」で判断します。
この図は、作業の場面を軸にして/compact・/clear・/rewindのどれを選ぶかの分岐を示しています。自分がいま迷っている場面がどの分岐に当てはまるか確認し、該当するコマンドをその場で実行してみてください。
スキルの数が増えてきたら、名前の付け方で系統を分けておくと迷いにくくなります。たとえばリサーチ系はresearch-、資料作成系はdoc-のように接頭辞を揃えておくと、どのスキルを呼べばよいか名前だけで判断できます。
実践で分かったこと
CLAUDE.mdとスキルを使い分ける中で、仕組み化が有効だった運用を2点紹介します。
1点目は、ObsidianのVaultフォルダをClaude Codeの作業対象にし、Vaultの一番上にCLAUDE.mdを置いて運用ルールを書いていることです。過去のYouTube台本、リサーチ、散歩中に録った音声の文字起こしが同じVaultに入るため、フォルダは全事業共通のナレッジと、発信チャンネル・事業ごとのフォルダに分けています。同じ指摘を繰り返さないよう、出力形式や禁止事項、完了条件をそのつど具体化してCLAUDE.mdへ追記しています。CLAUDE.mdは毎回の会話の開始時に読み込まれる仕組みのため、追記した内容が次回以降の作業にもそのまま反映されます(Memory)。
2点目は、毎回やる作業を手順書(スキル)にして一言で呼び出せるようにしていることです。2026年9月時点で自作スキルは61本あり、録音の取り込みと文字起こし、音声日記の保存、資料作成の指示書づくり、競合動画のリサーチ、YouTube台本づくりなどをスキル化しています。台本づくりは複数あった旧手順を1つのスキルに統合し、入口を1つにまとめました。コンテンツ販売系と台本系で名前の付け方を分け、どの系統のスキルか名前で分かるようにしています。スキルは呼ばれたときだけ内容が読み込まれる仕組みのため、CLAUDE.mdに書き続けるよりも文脈を圧迫しません(Skills、Costs)。
一般的な手順と運営者の運用の比較
| 項目 | 一般的な手順 | 運営者の運用と理由 |
|---|---|---|
| ルールの保存場所 | 会話の中だけで都度伝える | Vault最上位のCLAUDE.mdに昇格させ、毎回自動で読ませる。会話が変わってもルールが引き継がれるため |
| 繰り返し作業 | そのつど同じ指示を書き直す | 61本のスキルに切り出し、一言で呼び出す。台本づくりは複数の旧手順を1スキルに統合し、入口を迷わせないため |
| 録音データの取り込み | 気づいたときにまとめて処理する | スキルを手動実行し、直近24時間分だけを取り込む。文字起こしはPC内のローカル処理で行い、範囲と方法を固定することで取りこぼしと手順のばらつきを防ぐため |
外部ツールと連携する場合の注意点
CLAUDE.mdやスキルの運用が安定してきたら、会計ソフトや会員サイトの運営ツールなど、外部サービスとMCP(Model Context Protocol)でつなぐ選択肢もあります。リモートのMCPサーバーはclaude mcp add --transport http <名前> <URL>、ローカルはclaude mcp add <名前> -- <コマンド>で追加でき、会話中の接続状態は/mcpで確認できます(MCP)。外部の内容を取り込むサーバーはプロンプトインジェクションの危険があるため、信頼できる提供元のものだけをつなぐようにしてください(MCP)。認証が対話的なやり取りを求めてくる場合もあるため、初回接続はターミナルの画面を見ながら進めると安心です。
FAQ
Q. CLAUDE.mdとスキル、最初はどちらから作ればよいですか
A. 最初はどちらも作らず、/initでCLAUDE.mdの下書きを作ってもらうところから始めるのがおすすめです。同じ指摘を2回受けたらCLAUDE.mdに追記し、同じ手順を2回繰り返したらスキルに切り出す、という順番で育てると迷いません。
Q. スキルの数が増えすぎて管理しにくくなりませんか
A. 名前の付け方に接頭辞のルールを決めておくと、どの系統のスキルか名前だけで判断できます。61本規模になっても、系統ごとに名前を揃えておけば呼び出すスキルに迷いにくくなります。
Q. 巻き戻しをすればどんな変更も元に戻せますか
A. 戻せません。Bashコマンドで変更したファイルは巻き戻しの対象外です。重要な変更の前には、どこまで戻せるかを意識しておくと安心です(Checkpointing)。
まとめ
CLAUDE.mdは常に効かせたいルール、スキルは繰り返す作業の手順書という役割分担を押さえると、Claude Codeの運用は積み上がっていきます。同じ指摘が2回出たらCLAUDE.mdへ、同じ手順を2回繰り返したらスキルへ切り出すという基準を持っておくと、判断に迷いません。文脈管理は/compact・/clear・/rewindを場面で使い分け、外部サービスと連携する場合はMCPの信頼性にも注意しながら、小さな構成から育てていってください。
公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取る

コメント