Claude Codeのスキルとは、SKILL.mdというファイルに手順や基準を書いておき、必要なときにClaude Codeへ呼び出させる仕組みです。

毎回同じ手順をチャットに貼り付けているなら、ファイルにしておくと、一言で同じ作業を頼めます。クロードコード（Claude Code）の機能のひとつで、そのために使いますです。

本記事では、置き場所、SKILL.mdの書き方、呼び出し方、CLAUDE.mdとの違いを整理します。公式ドキュメント（2026年11月11日時点）をもとに、株式会社Pdienが日々の業務で使っている立場からお伝えします。

この記事の結論

• Claude Codeのスキルは、SKILL.mdという1つのファイルから作れます。
• 置き場所は、自分用の「~/.claude/skills/」と、プロジェクト用の「.claude/skills/」が基本です。
• 「いつ使うか」を決めるのは、SKILL.mdの先頭に書く description です。
• 常に守る決まりごとはCLAUDE.md、手順の型はスキルに書きます。

▲ Claude Codeのスキルは、手順をファイルにして呼び出す仕組みです

「自社の業務のどこをスキルにすればよいか」といったご相談を承っています。AI内製化（自社でAIを使いこなす体制づくり）のご相談はこちらからどうぞ。

Claude Codeのスキルとは？何ができる？

Claude Codeのスキルとは、手順や基準を書いたSKILL.mdを、必要なときに読み込ませる仕組みです。公式ドキュメントでは「Claudeにできることを広げるもの」と説明されています。

SKILL.mdには、AIへの指示をMarkdownで書きます。内容に合うときはAIが自分で使い、自分で呼び出すこともできます。

たとえば、次のような作業をスキルにできます。

• 毎回同じチェックリストで確認する作業
• 決まった順番で進める公開や書き出しの手順
• 書式が決まっている文書の作り方

▲ 「毎回同じ流れ」の作業ほど、スキルに向いています

公式ドキュメントは、次のようなときが作りどきだと説明しています。

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

出典: Extend Claude with skills（Claude Code Docs）（2026年11月11日時点）

Claude Code自体の始め方は、Claude Codeとは？できること・始め方にまとめています。

Claude Codeのスキルはどこに置く？

スキルは、「スキル名のフォルダ」を作り、その中にSKILL.mdを置きます。置く場所によって、使える範囲が変わります。

種類	置き場所（公式表記）	使える範囲
個人	~/.claude/skills/スキル名/SKILL.md	自分のすべてのプロジェクト
プロジェクト	.claude/skills/スキル名/SKILL.md	そのリポジトリ（コミットして共有できる）
プラグイン	プラグイン内の skills/スキル名/SKILL.md	プラグインを入れた環境

▲ スキルは、置いた場所によって使える範囲が決まります

個人用とプロジェクト用は、同じ作りです。同じ名前のスキルが複数の場所にあるときは、個人用がプロジェクト用より優先されます。

このほかに、会社が管理する設定として置くものや、サブフォルダ専用に置くものもあります。

チームで同じ手順を使いたいときは、プロジェクト用の置き場所に入れて共有する方法があります。自分だけで使うなら個人用です。

SKILL.mdはどう書く？

SKILL.mdは、先頭に「—」で囲んだ設定（フロントマター）を書き、その下に指示をMarkdownで書きます。設定は、どれも省略できます。

公式ドキュメントでは、description だけは書くことがすすめられています。ここに「何をするスキルか」と「いつ使うか」を書きます。

“`

—

name: deploy

description: 本番へ公開する手順

—

“`

上の例のように、name と description を書き、その下に手順を番号つきで書きます。

▲ 先頭の設定の下に、手順をふつうの文章で書きます

SKILL.mdの横には、参考資料や補助のスクリプトを置けます。公式ドキュメントは、SKILL.mdを500行以内に収めることをすすめています。

細かい資料が多いときは、別のファイルに分けておくと、必要なときだけ読み込まれます。

SKILL.mdの設定項目には何がある？

SKILL.mdの設定項目は、すべて任意です。よく使う項目は次のとおりです。名前を間違えると黙って無視されるため、綴りは正確に書きます。

項目	役割（公式の説明をもとに整理）
name	「/」のメニューに出る名前。省略するとフォルダ名
description	何をするか、いつ使うか。Claudeが使うか判断する材料
when_to_use	使う場面の補足（descriptionに足される）
disable-model-invocation	true にするとClaudeが自動で使わない
user-invocable	false にすると「/」のメニューに出さない
allowed-tools	実行中、確認なしで使えるツール
paths	自動で使う対象を、ファイルのパターンで絞る

▲ 最初は name と description だけで十分です

description と when_to_use を合わせた文は、一覧では1,536文字で切られます。大事なことは前のほうに書きます。

Claude Codeのスキルはどう呼び出す？

呼び出し方は2通りです。「/スキル名」と入力して自分で呼ぶ方法と、依頼の内容が description に合ったときにAIが自分で読み込む方法です。

▲ 手動と自動を、スキルごとに切り替えられます

• 手動：「/fix-issue 123」のように、スキル名の後に引数を付けて呼ぶ
• 自動：依頼が description に合うと、AIが読み込む
• 自動を止める：disable-model-invocation を true にする
• 自分専用にする：user-invocable を false にすると、AIだけが使う

description は常にAIの手元にありますが、スキル本体の中身は、使うときに初めて読み込まれます。

「本番へ公開する」のように、勝手に動いてほしくない作業のスキルは、自動で使わない設定にしておくと安心です。

スキルの作り方や、AI社員（AIエージェント）に任せる業務の切り分けを、自社の状況に合わせてご相談いただけます。

スキルとCLAUDE.mdの違いは？

スキルとCLAUDE.mdの違いは、読み込まれるタイミングです。CLAUDE.mdは毎回の作業で常に読み込まれ、スキルは使うときだけ中身が読み込まれます。

比べる点	CLAUDE.md	スキル
向いている内容	事実・守る決まりごと	手順・参考資料
読み込み	常に	使うときだけ
長い内容	毎回の分量が増える	使うまで負担が小さい

▲ 決まりごとはCLAUDE.md、手順はスキルに書き分けます

以前の「カスタムスラッシュコマンド」は、スキルに統合されています。.claude/commands/deploy.md という既存のファイルも、そのまま使えます。

どちらも「/deploy」で呼び出せますが、スキルならフォルダに補助ファイルを置け、自動で使うかどうかも選べます。

Claude Codeのスキルを作る流れは？

スキルを作る流れは、フォルダを作る、SKILL.mdを書く、呼び出して試す、の3つです。

▲ 小さく作って、使いながら直していきます

最初から完璧を目指さず、1つの作業で試して、足りない手順を書き足していくのが現実的です。

当社でも、動画編集の手順や議事録づくりなど、毎回同じ流れの作業をSKILL.mdにして使っています。Claude Codeの使い方そのものは、Claude Codeでインスタ運用を効率化する方法でも紹介しています。

使いやすいClaude Codeのスキルを書くコツは？

使いやすく書くコツは、description に「いつ使うか」を具体的に書き、手順を短く保つことです。

▲ 呼び出されやすさは、description の書き方で決まります

• description に「何をするか」と「どんなときに使うか」を両方書く
• 1つのスキルには、1つの作業だけを入れる
• SKILL.mdは500行以内にして、細かい資料は別ファイルに分ける
• 勝手に動いては困る作業は、自動で使わない設定にする
• 設定項目の名前は正確に書く（間違うと無視される）

なお、Claude Codeの料金プランや使用量の上限は、Claude Codeの料金はいくら？で解説しています。

よくある質問（FAQ）

まとめ

Claude Codeのスキルは、手順をSKILL.mdに書いて呼び出す仕組みです。置き場所と description を決めるだけで、毎回の作業を一言で頼めるようになります。

▲ 手順はスキル、決まりごとはCLAUDE.mdに書き分けます

• 作る：スキル名のフォルダにSKILL.mdを置く
• 呼ぶ：「/スキル名」の手動か、依頼に合わせた自動
• 分ける：決まりごとはCLAUDE.md、手順はスキル
• 守る：自動で動かしたくない作業は設定で止める

▲ 作る前に、この3つを確かめると迷いません

▲ 1つ作って使い、直しながら増やしていきます

株式会社Pdienは、愛知県岡崎市の会社です。AIエージェントを使ったAI内製化の支援や、SNS運用の自動化を行っています。ご相談はお問い合わせフォームから受け付けています。

Claude Codeのスキルづくりから、AI社員（AIエージェント）の導入、会社での使い方のルールづくりまで、自社に合わせた進め方をご相談いただけます。