スキルとは何か、CLAUDE.md との違いを知る

スキルは、Claude Code に渡す作業の手順書です。毎回読まれる CLAUDE.md とは、読まれ方が違います。スキルの正体と、CLAUDE.md との違いをまとめました。

最初は名前しか知らなかった

正直に言うと、私はスキルも、サブエージェントも、フックも、名前を知っているだけでした。どれも Claude Code の機能ですが、どんな機能なのかはよく分かっていなかったのです。

そこで、部長（部門ごとのフォルダで動く Claude Code）にこうお願いしました。相談の途中で必要があれば、これらを積極的に使ってください、と。

すると、部長は作業の途中から使い始めました。その様子を見ているうちに、それぞれの機能がだんだん分かってきました。

このカテゴリでは、そうして分かってきたことを、公式の説明と合わせて紹介しています。

スキルは作業の手順書

スキルは、主に何段階もある作業の進め方を書いておくファイルです。会社でいえば、部門に置いてある業務マニュアルにあたります。

中身は、CLAUDE.md とほぼ同じ文章。先頭に名前と説明を書く欄があり、その下に手順を書きます。

置き場所は、部門のフォルダの中の「.claude」の中にある「skills」というフォルダ。そこにスキルごとのフォルダを作り、「SKILL.md」という名前で置きます。

なお、「.claude」は、ふだんは見えないフォルダです。

私がサイトを作っている制作部門には、こうした手順書がいくつも置いてあります。たとえば、記事を書く手順や、書いた原稿を点検する手順です。

CLAUDE.md との違いは読まれ方

CLAUDE.md は、チャットを始めるたびに中身が全部読み込まれます。部門の方針書として、毎回頭に入れておいてもらうためのファイルです。

一方、スキルは、チャットを始めたときには名前と説明しか読まれません。本文が読み込まれるのは、そのスキルを使うときだけ。

公式の説明によれば、スキルの本文は使うときまで読み込まれません。長い手順を書いても、呼び出されるまでは Claude Code が一度に扱える量をほとんど占めないわけです。

公式では、CLAUDE.md は長くなるほど守られにくくなる、ともされています。手順をスキルに分ければ、方針書を短く保てます。

CLAUDE.md の基本は、こちらの記事で解説しています。

関連記事：CLAUDE.md とは何か、プロンプトとの違いを知る

スキルを使う方法は2つ

1つは、部長がスキルの説明を見て、今の作業に合うと判断したときに、自分で使う方法。もう1つは、チャット欄に「/」とスキルの名前を入力して、使う人が自分で呼び出す方法です。

私の場合、機能を理解した今も、使い時の判断は部長に任せています。

細かい指示まで守ってくれて驚いた

部長がスキルを使うようになって、本当に驚いたことがあります。細かい指示まで漏らさずに、作業してくれるのです。とても助かっています。

どんなときにスキルにするか

公式の説明では、次のようなときにスキルを作るよう勧めています。

• 同じ指示や、同じ手順を、何度もチャットに貼っているとき
• CLAUDE.md の一部が、決まりではなく手順になってきたとき

手順書は、自分で書かなくても大丈夫。部長に頼めば作ってくれます。作り方は、こちらの記事で紹介しています。

関連記事：スキルの作り方、頼み方のコツと手順書の見本