Claude Codeのスキル(Skills)とは？作り方・置き場所・使い分け

同じ指示やチェックリストを何度もチャットに貼り付けているなら、それがスキルにする候補です。公式ドキュメントも、CLAUDE.mdの一部が「事実」ではなく「手順」に育ってきたときにスキルへ切り出すことを勧めています(Claude Code Docs)。

CLAUDE.mdとの一番の違いは、読み込まれるタイミングです。

スキルの本文は使われるときにしか読み込まれないため、長い手順書を置いても普段の動作は重くなりません。以前の「カスタムコマンド」(.claude/commands/)はスキルに統合されており、古いファイルもそのまま動きます。

例として、議事録から決定事項とToDoを抜き出すスキルを作ります。まず個人用のスキルフォルダを作ります。

mkdir -p ~/.claude/skills/minutes-todo

次に、~/.claude/skills/minutes-todo/SKILL.mdを次の内容で保存します。---で囲んだ部分が設定(フロントマター)、その下が手順です。

---
description: 議事録から決定事項とToDoを抜き出す。議事録の整理やToDoの洗い出しを頼まれたときに使う。
---

## 手順
1. 議事録を読み、「決まったこと」と「まだ決まっていないこと」を分ける
2. ToDoは「担当者・期限・内容」の表にする。担当者や期限が書かれていなければ「未定」と書き、推測で埋めない
3. 最後に、確認が必要な点を箇条書きで3つまで挙げる

フォルダ名のminutes-todoがそのままコマンド名になります。Claude Codeを起動して/minutes-todoと入力するか、「この議事録からToDoを出して」と頼むと、手順どおりの表が返ってくれば成功です。

設定で押さえるのはdescriptionの1つだけです。Claude Codeはこの説明文を見て、スキルを使うかどうかを判断します。「何をするか」と「どんな依頼のときに使うか」を最初に書いてください。

まず個人用で試し、手順が固まったらプロジェクト用に移してチームで共有する、という順番が無駄がありません。スキルに加えて自動処理や外部連携もまとめて配りたい場合は、プラグインにします。

Claude Codeには最初から入っているスキルもあります。/code-reviewや/debug、/loopなどで、自作のスキルと同じく/の後に名前を入れて呼び出します。

メール送信や本番公開のように取り消しにくい作業は、Claude Codeが自分の判断で始めると困ります。フロントマターにdisable-model-invocation: trueを足すと、そのスキルは自分が/名前と入力したときにしか動かなくなります。

---
description: 週報を社内チャットに投稿する
disable-model-invocation: true
---

他人が作ったスキルを入れるときは、SKILL.mdと同じフォルダにあるファイルを先に読んでください。スキルはClaude Codeへの指示そのものなので、中身を知らないまま使うのは、知らない人の手順書をそのまま実行するのと同じです。

スキルにしないほうがよいものもあります。1回しかしない作業は普通に頼めば足ります。常に守らせたいルールはCLAUDE.mdへ、ファイル保存のたびに必ず走らせたい処理はフックへ、外部サービスとの接続はMCPへ置くのが向いています。

- Claude Code Docs「Claude をスキルで拡張する」