Claude CodeのSkillsで社内の型を配る──毎回同じ説明をしている手順からSkillにする。CLAUDE.mdとの分け方と書き方

黒字化の外科医｜Web制作会社の「実務改善」経営参謀

2026年10月27日 08:07

この記事は、Claude CodeのSkillsを使って、制作会社の作業の型を社内に配る方法を扱います。

ベテランの手順が、会話のたびに書き直されている

「WordPressの更新前は、バックアップを取って、検証環境で確かめて、それから……」

同じ手順を、社員がそれぞれClaude Codeに毎回説明していないでしょうか。
説明する人によって、抜ける手順が違います。

手順は、会社の資産です。
会話の中に書き捨てるのではなく、ファイルとして配れる形にします。

Skillsとは、繰り返す手順やチェックリストを1つのフォルダにまとめ、必要なときだけClaude Codeに読み込ませる、社内の作業の型である

黒字化の外科医です。何をSkillにし、何をしないかを解剖します。

以下の機能の説明は、Claude Codeの公式ドキュメント（code.claude.com/docs の「Skills」と「Memory」のページ）で、2026年10月27日に確認した内容です。版によって変わるため、使う前に必ず公式で確かめてください。

Skillsで型を配るべき理由は、三つあります。

第一に、必要なときだけ読み込まれるから。
公式ドキュメントでは、各Skillの名前と説明は常にClaudeに見えていて、本文は使うときに初めて読み込まれる、と説明されています。手順を増やしても、普段の会話を圧迫しにくい形です。

第二に、プロジェクトに置けば、チームで同じ型を使えるから。
プロジェクトの `.claude/skills/〔Skill名〕/SKILL.md` に置き、リポジトリにコミットすると共有できます。個人用は `~/.claude/skills/` に置きます。

第三に、呼び出し方をそろえられるから。
Skillは `/〔Skill名〕` で呼べます。「更新の前は `/wp-update-check` を使う」と決めれば、誰がやっても同じ手順から始まります。

CLAUDE.mdとSkillsの分け方

公式ドキュメントでは、CLAUDE.mdは毎回の会話の最初にすべて読み込まれ、事実や常に守る決まりに向く、と説明されています。
Skillsは使うときだけ読み込まれ、繰り返す指示・チェックリスト・何段階もある手順に向く、とされています。

置き場所      向くもの                          制作会社の例
──────────────────────────────────────────
CLAUDE.md    いつも守る決まり、事実            ビルドのコマンド、命名の決まり、触らないフォルダ
Skills       ときどき使う手順、チェックリスト  更新前の確認、納品前の点検、改修の調査報告

CLAUDE.mdの中の一節が「手順」に育ってきたら、Skillに移す候補です。

Claude CodeのSkillsの書き方：SKILL.mdの形式

SKILL.mdは、YAMLの前置き（frontmatter）と、Markdownの指示でできています。
公式ドキュメントでは、前置きの項目はすべて任意で、`description` は書くことが推奨されています。`name` を省くと、フォルダ名がSkillの名前になります。

---
name: delivery-check
description: 納品前のコードを、社内の点検項目で確認する。納品前の確認、検収前の点検を頼まれたときに使う。
disable-model-invocation: true
---

## 手順
1. 変更されたファイルの一覧を出す。
2. 下の点検項目を、ファイルごとに確認する。
3. 結果を「項目・判定（OK／要確認）・理由」の表で返す。

## 点検項目
・秘密情報（APIキー、パスワード）が書かれていないか
・お客様の確認が必要な文言の変更がないか
・テストのコマンドが通るか
・不要なファイル（ログ、作業用のファイル）が残っていないか

判定に迷うものは、すべて「要確認」にすること。

`description` は、Claudeがいつ使うかを判断する材料です。「何をするか」と「いつ使うか」を1〜2文で書きます。

`disable-model-invocation: true` は、Claudeが自動で読み込むのを止め、人が `/delivery-check` で呼んだときだけ動かす設定です。公式では、デプロイのような副作用のある手順に使う例が示されています。

参考資料や長い点検表は、同じフォルダに別ファイルで置き、SKILL.mdから参照できます。公式では、SKILL.mdは500行以内に収めることが勧められています。

今すぐ試せる：Skillにする手順を棚卸しするプロンプト

私はWeb制作会社の経営者です。Claude CodeのSkillsにする社内の手順を選んでください。

【前提】
・社員がAIに繰り返し説明している作業：〔例：WordPressの更新前確認、納品前の点検、改修の調査〕
・作業ごとの月の回数：〔記載〕
・手順を一番よく知っている人：〔記載〕
・失敗したときの影響：〔例：サイトが止まる、お客様に誤った報告をする〕

1. 作業ごとに、CLAUDE.mdに書くべきか、Skillにすべきかを判定する。
2. Skillにする作業について、descriptionを1〜2文で書く。
3. 副作用のある作業（本番への反映など）には、自動で読み込ませない設定を提案する。
4. 優先順位を、回数と失敗の影響で決める。

型の配布工場：Skillにする順番

□ 月に何度も、同じ説明をしている（回数が多い）
□ 手順を知っている人が、社内に1〜2人しかいない
□ 抜けると、お客様に迷惑がかかる
□ 手順が、文章で書ける（勘に頼る部分が少ない）
□ 手順の持ち主（直す担当）を決められる

5つのうち4つ以上に当てはまる手順から、Skillにします。

Skillは、レビュー役のサブエージェントと組み合わせると、型と確認の両方を配れます。

▶ Claude Codeのサブエージェントで作業を分ける──1つの会話に全部やらせない。レビュー役・テスト役・調査役の定義と渡す道具

CLAUDE.md・Skills・サブエージェント定義・MCPの許可表を一式にした雛形は、こちらに置きました。

▶ Claude Code社内標準化キット──CLAUDE.md・Skills・サブエージェント定義の雛形、MCPの許可表と権限設定、点検表

構造的なリスク

逆説を指摘しておきます。

Skillは、型を配る道具であると同時に、指示を配る道具でもあります。
公式ドキュメントでは、Skillの `allowed-tools` は「制限」ではなく「許可」であり、リポジトリに入っているSkillの `allowed-tools` は、Claude Codeを動かす前に確認するよう注意されています。

また、Skillには、読み込まれる前にコマンドを実行して結果を差し込む書き方があります。
外から受け取ったリポジトリのSkillは、中身を読んでから使ってください。

よくあるQ&A

Q. Skillは、何本くらい作ればよいか？

最初は2〜3本で十分です。使われないSkillは、手順が古くなっても誰も気づきません。

Q. CLAUDE.mdに全部書いてはだめか？

公式では、CLAUDE.mdは1ファイル200行以内を目安にするよう勧められています。長くなるほど、守られにくくなります。手順はSkillに移してください。

Q. 手順が変わったら、どうするか？

Skillごとに持ち主を決め、変えた日と理由を記録します。社内のナレッジの残し方は、こちらで扱っています。

▶ 制作会社のナレッジ共有をAIで進める方法──過去の提案書・見積もり・トラブル対応を「探せる形」にして、新人の立ち上がりと見積もり時間を短くする手順と、情報の扱いの線

最後に

Skillsは、ベテランの手順を、会話の外に取り出して配る道具です。

繰り返す手順から順にSkillにし、持ち主を決めた会社だけが、人に依存しない作業の品質を持てるのです。

これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。

#Web制作会社 #ClaudeCode #Skills #AI駆動開発 #業務標準化 #ナレッジ共有 #制作会社経営 #中小企業 #生成AI活用 #チェックリスト