毎回プロンプトを書き直すのが、地味に面倒になってくる
Claude Code を使い始めると、最初にぶつかるのが「毎回、同じ前提や指示を書き直すのが地味に面倒」という壁です。これを解決する仕組みが CLAUDE.md と Skills です。役割が違うので、分けて理解すると一気にラクになります。
この記事で分かること：
CLAUDE.md＝「前提・ルール」を持たせる仕組み- Skills＝「得意分野（手順）」を持たせる仕組み
- どう使い分けるか／作りすぎない、の考え方
※ 仕様・名称はアップデートで変わります。最新は公式情報で確認を。ここでは「考え方」を持ち帰ってもらうのが目的です。
1. CLAUDE.md＝プロジェクトの「前提・ルール」を毎回伝える
作業フォルダに CLAUDE.md を置いておくと、Claude Code は起動時にそれを読み、「このプロジェクトは何か」「やってほしくないこと」を毎回踏まえて動いてくれます。つまり、毎回口頭で説明していた前提をファイルに一度書けば済むようになります。
書くのは最初は数行で十分です。作業フォルダの一番上に CLAUDE.md という名前で置きます。
# このプロジェクトについて
WordPress（SWELL子テーマ）で運営している個人ブログ。
## 守ってほしいこと
- 指示していないファイルは触らない
- 変更する前に、対象ファイルと修正方針を先に見せる
- 親テーマ（swell）は参照はしてよいが、書き込まないこれをコピーして、自分のプロジェクトに合わせて3行ほど書き換えれば動きます。足りなければあとから足せます。
- このプロジェクトは何か
- 守ってほしいこと（例：指示外のファイルは触らない／頼んでいない大改修はしない／最小限の変更を優先）
注意：
CLAUDE.mdはセッション開始時に毎回全文が読み込まれるので、増やすほど常時トークンを消費し、精度もかえって落ちやすくなります。短く・要点だけにして、定期的に削るのがコツです。
2. Skills＝AIに「得意分野（手順）」を持たせる
CLAUDE.md が「前提・ルール」なら、Skills は「特定の作業の進め方（手順・型）」をあらかじめ持たせておく仕組みです。よくやる定型作業を“得意技”として登録しておくイメージで、毎回ゼロから指示しなくても、同じ品質で進めてもらいやすくなります。
仕組みの違いもシンプルです。CLAUDE.md がセッション開始時に毎回全文を読み込まれるのに対し、Skills は呼び出されたときだけ本体が読み込まれる仕組み。だから「常に効かせたい前提＝CLAUDE.md」「呼ばれたら走らせたい手順＝Skills」と役割を分けると、トークン効率も精度も両立しやすいです。
考え方はシンプルで、
- 繰り返す作業／品質をブレさせたくない作業 → Skill 化する価値あり
- 毎回ゴール が違う創造的な作業 → 無理に型にしない
ぼくの感覚では、「3回以上やった作業」「事故りやすい作業」が Skill 化の目安です。最初から全部を型にしようとすると、かえって身動きが取りづらくなります。
Skillを1つ作ってみる
実際に作ると、一番早く分かります。ターミナルでフォルダを作ります。
mkdir -p ~/.claude/skills/summarize-changesその中に SKILL.md を置きます。中身はこれだけです。
---
name: summarize-changes
description: 直近の変更をまとめて報告する
---
git の変更内容を確認し、次の順で報告してください。
1. 変更したファイルの一覧
2. それぞれ何を変えたか（1行ずつ）
3. 確認したほうがよい箇所--- で挟んだ部分が「いつ呼ぶか」の情報、その下が「呼ばれたら何をするか」の中身です。フォルダ名がそのままコマンド名になるので、Claude Codeの入力欄で /summarize-changes と打てば呼び出せます。
置き場所は2種類あります。
| 置き場所 | パス | 効く範囲 |
|---|---|---|
| 自分用 | ~/.claude/skills/<名前>/SKILL.md | すべてのプロジェクト |
| プロジェクト用 | .claude/skills/<名前>/SKILL.md | そのプロジェクトだけ |
（Claude Code公式ドキュメント・2026年9月時点）
3. 使い分けと、作りすぎない
ざっくりの整理です。
- CLAUDE.md：常に効かせたい「前提・ルール・禁止事項」
- Skills：必要なときに呼び出す「特定作業の手順・型」
どちらも最初から完璧を目指さないのが結局いちばん速いです。使っていて「また同じ説明をしている」と気づいたタイミングで、その都度 CLAUDE.md に一行足す／Skill に切り出す。これくらいの温度感が、長く回せる運用だと感じています。
まとめ
CLAUDE.md＝前提・ルールを毎回伝える仕組み（短く・要点だけ）- Skills＝得意分野（手順・型）を持たせる仕組み（繰り返し作業を型化）
- どちらも作りすぎない。「また同じ説明をした」が追加の合図
CLAUDE.md や Skills を置く前に、Claude Codeの初期設定をひと通り見ておくと迷いません。
Claude Code が初めての方はClaude Codeとは？からどうぞ。
気になったことは、お気軽に
この記事のとおりに進めてみて、うまくいかないところがあれば遠慮なく聞いてください。
制作や設定のご相談も、同じ窓口で受けています。
