Claude Code Skillsの作り方！SKILL.mdで手順を再利用する方法

監修者_SD以外

監修者プロフィール

森下浩志

日本最大級のAI情報プラットフォーム「romptn ai」編集長。著書に「0からはじめるStable Diffusion」「0からはじめるStable Diffusion モデル・拡張機能集編」など、AmazonベストセラーのAI関連書籍を多数執筆。AIにおける情報の非対称性を解消するための社内研修や出張講義も行う。

Claude Code Skillsとは何か

Claude Code Skillsは、何度も発生する作業を同じ品質で進めるための手順書です。普段の会話で毎回「この順番で確認して」「この観点で資料を見て」と説明する代わりに、SKILL.mdへ作業の進め方をまとめておきます。

たとえば、営業資料の構成チェック、月次レポートの作成手順、WordPress入稿前の確認、顧客アンケートの分類などは、毎回似た観点で進めることが多い業務です。こうした作業をSkillsにしておくと、依頼のたびに前提を説明し直す時間を減らせます。

ポイントは、Skillsが「AIに何でも任せる魔法のボタン」ではないことです。あくまで、自社のやり方や判断基準をAIに渡しやすくする仕組みとして使うと、実務で安定しやすくなります。

Skillsの作成用途例

Skillsは、決まった成果物を毎回一定の基準で作りたい時に向いています。特に、社内ルール、チェック観点、テンプレート、判断基準がある作業と相性がよいです。

最初から大きな自動化を狙う必要はありません。人が毎回説明している作業を1つだけ選ぶと、最初のSkillを作りやすくなります。

Skillsにするべき例としないべき例

Skillsを使うべきか迷ったら、「毎回使う前提なのか」「特定の業務だけで使う手順なのか」で分けると判断しやすくなります。

たとえば「社外向け文書では敬体にする」は常に守るルールなのでCLAUDE.md向きです。一方で「営業資料を作る時だけ、導入、課題、提案、導入効果の順で構成する」はSkills向きです。

何でもSkillsに入れると、逆に運用がわかりにくくなります。常時ルール、固定コマンド、作業ごとの手順を分けておくことが、チームで使う時のコツです。

SKILL.mdの最小構成と置き場所

まずは小さく作るのが安全です。Claude Codeでプロジェクトごとに使うなら、作業フォルダの中に次のような場所を用意します。

mkdir -p .claude/skills/article-check

次に.claude/skills/article-check/SKILL.mdを作ります。最初は、名前、説明文、作業手順だけで十分です。説明文には「記事レビュー、入稿前チェック、下書き改善を依頼された時に使う」のように、実際に依頼する言葉を入れます。

手順部分には、記事の目的と読者を確認する、見出しが読者の疑問に答えているか見る、根拠が弱い主張を指摘する、重要度の高い順に修正案を返す、といった流れを書きます。

全プロジェクトで使いたい個人用の手順は~/.claude/skills/<skill-name>/SKILL.md、チームで共有したい手順は.claude/skills/<skill-name>/SKILL.mdに置くのが基本です。

必要な場面で使われやすい説明文の書き方

Skillsは、説明文が曖昧だと必要な場面で使われにくくなります。説明文には、何をする手順なのか、どんな依頼で使うのかを入れます。

弱い例は、対象と場面が広すぎる説明です。

資料作成を手伝う

これだと、営業資料なのか、社内報告なのか、スライドのデザイン確認なのかが判断しにくくなります。よい例は、作業内容と使う場面が具体的です。

営業資料を作る前に、対象読者、提案の目的、必ず入れる実績、禁止表現を確認し、構成案を作る。提案書を整えたい、既存資料を改善したい、営業用スライドを作りたい時に使う。

コツは、実際に依頼する人が言いそうな言葉を入れることです。「営業資料を作りたい」「月次レポートを分析したい」「記事を入稿前に確認したい」のような言葉が入っていると、AIが作業に合わせやすくなります。

補助ファイルを分ける基準

すべてをSKILL.mdに書き込むと、読みづらくなり、更新もしづらくなります。長くなりそうなら、役割ごとに分けます。

SKILL.mdは目次と手順の中心にして、「詳しい表記ルールは参考資料を見る」「スライドはこのテンプレートに合わせる」のように案内します。最初は手順書だけで始め、必要になったら参考資料や素材を分ける方が管理しやすくなります。

作ったSkillをClaude Codeで確認する流れ

作ったら、すぐに動作確認します。見るべきポイントは「Claude Codeが見つけられるか」と「期待した場面で使われるか」の2つです。

Claude CodeはSkillの変更を検知できますが、新しく最上位のフォルダを作った場合は、再起動が必要になることがあります。

うまく使われない時は、本文を増やす前に説明文を直してください。多くの場合、問題は手順の量ではなく、AIが「この依頼にはこのSkillが関係ある」と判断できないことにあります。

おすすめのオープンソースで配布されているSkills

公開されているSkillsは、ゼロから作る前の参考になります。ただし、ライセンスや中身は配布元ごとに違うため、実務で使う前に必ず確認してください。

ビジネスサイドの人が最初に見るなら、資料、表計算、PDF、業務メモのような日常業務に近いものから始めるのがおすすめです。配布元が有名でも、中身の確認は省略しないでください。

ほかのAI作業ツールでも使う時の注意

SKILL.mdは共通化しやすい形式ですが、置き場所や読み込み方はツールごとに違います。横展開する時は、本文だけでなく、どこに置くか、どう読み込まれるか、権限確認がどう出るかも確認します。

話題に上がりやすいツールでも、公式情報で確認できない場合は断定しない方が安全です。「同じファイルだから必ず同じように動く」ではなく、共通で使う本文と、ツールごとの設定差分を分けて管理すると考えましょう。

チーム共有前に確認したい安全チェック

第三者が配布しているSkillは、便利そうかどうかだけで判断しないでください。Skillsは手順だけでなく、補助ファイルや外部URL参照を含められるため、通常のメモより強い影響を持つことがあります。

最低限、次を見ます。

自作Skillでも同じです。特に、社内データや顧客情報を扱う業務では、Skillが何を読んで何を実行するかをREADME並みに明確にしておくと、後から安全に運用できます。

Claude Code Skillsでよくある質問

まとめ：Claude Code Skillsは小さく作って育てる

Claude Code Skillsは、AIに任せる作業を増やすための大きな仕組みではなく、何度も使う手順を安全に再利用するための小さな単位です。まずはSKILL.mdだけで始め、説明文で「いつ使うか」を具体的に書くところから整えましょう。

実務では、常時守るルールをSkillsへ押し込まないことが大切です。常に守る前提はCLAUDE.md、人が明示して実行する固定作業はコマンド、必要な時だけ読む作業手順はSkillsという形で分けると、運用が崩れにくくなります。

公開されているSkillsは参考になりますが、社内で使うなら中身の確認が前提です。小さく作り、実際の依頼で使われ方を見ながら改善していくのが、Claude Code Skillsを長く使う一番安全な進め方です。