Claude Code Skillsとは？作り方・使い方と、業務で役立つ例を解説

「Claude Codeに頼むたびに、同じ手順や注意点を貼り付けている」「CLAUDE.mdに決まりごとを書き足していたら、どんどん長くなってきた」と感じている方は多いのではないでしょうか。毎回の説明は手間がかかり、書き忘れると仕上がりがばらつきます。

Claude Code Skills（スキル）を使うと、よく使う手順や決まりごとを1つのファイルにまとめ、Claudeに必要なときだけ読み込ませることができます。/スキル名と入力して呼び出すことも、Claudeに自動で使わせることもできます。

この記事では、スキルの仕組み、CLAUDE.mdとの使い分け、最初のスキルの作り方、置き場所と共有のしかた、よく使う設定項目、業務で役立つ例、うまく動かないときの直し方と安全に使うための注意点までを順に解説します。内容は2026年10月時点のClaude Codeの公式ドキュメントにもとづいています。

Claude Code Skillsとは

ひとことで言うと

スキルは、Claudeに渡す「手順書」です。SKILL.mdというファイルに手順や決まりごとを書いておくと、Claude Codeはそれを道具の1つとして持ちます。使い方は2通りです。

• Claudeに任せる：依頼の内容がスキルの説明に合うと、Claudeが自動でスキルを使う
• 自分で呼び出す：/スキル名と入力して、そのスキルを直接動かす

公式ドキュメントでは、スキルを作るとよいタイミングとして、同じ指示やチェックリスト、何段階もある手順を何度もチャットに貼り付けているときと、CLAUDE.mdの一部が「事実」ではなく「手順」になってきたときの2つを挙げています。

必要なときだけ読み込まれる

スキルの特長は、本文が使うときだけ読み込まれることです。Claude Codeはふだん、スキルの名前と説明文だけを把握していて、スキルを使うときにはじめて本文を読みます。開発者向けドキュメントでは、名前と説明文は1つのスキルあたり約100トークン（AIが文章を数える単位）、本文は5,000トークン未満が目安とされています。付属の資料は必要なときにだけ開かれます。

そのため、長い参考資料をスキルに入れておいても、使うまではほとんど負担になりません。毎回必ず読み込まれるCLAUDE.mdとは、ここが大きく違います。

カスタムコマンドはスキルに統合された

以前は、よく使う指示を.claude/commands/のファイルにして「カスタムコマンド」として呼び出す方法がありました。いまはこの仕組みがスキルに統合されています。.claude/commands/deploy.mdと.claude/skills/deploy/SKILL.mdは、どちらも/deployというコマンドになり、同じように動きます。

すでにある.claude/commands/のファイルは、そのまま使い続けられます。スキルにすると、付属ファイルを置くフォルダが持てる、自動で使うかどうかを設定できる、関係するときにClaudeが自動で読み込める、といった機能が加わります。新しく作るなら、スキルの形にしておくのがおすすめです。

最初から入っている組み込みスキル

Claude Codeには、最初から入っているスキル（組み込みスキル）があります。公式ドキュメントで紹介されている主なものは次のとおりです。

組み込みスキルの中には、Claudeが関係するときに自動で使うものと、/verifyのように自分で呼び出したときだけ動くものがあります。組み込みスキルをまとめて止めたいときは、disableBundledSkillsという設定を使います。

Agent Skillsという共通の規格

Claude Codeのスキルは、「Agent Skills」という公開された規格（agentskills.io）にもとづいています。同じ規格を使うほかのAIツールでも動く形式です。Claude Codeはこの規格に、呼び出し方の制御やサブエージェントでの実行など、独自の機能を加えています。

CLAUDE.md・フック・サブエージェントとの違い

Claude Codeには、Claudeの動きを決める仕組みがいくつもあります。どれに何を書けばよいかで迷いやすいので、スキルとの違いを整理します。

CLAUDE.mdとの違い

CLAUDE.mdは、Claude Codeが作業を始めるたびに必ず読み込む「前提」のファイルです。プロジェクトの説明、使っている道具、守ってほしい基本ルールなどを書きます。毎回読み込まれるので、内容が長くなるほど、関係のない作業のときにも負担になります。

スキルは、使うときだけ読み込まれる「手順書」です。公式ドキュメントでは、CLAUDE.mdの一部が手順になってきたら、スキルに移すことをすすめています。たとえば「リリースするときは、テスト→ビルド→確認の順に…」という手順は、毎回の作業には関係ないので、スキルにした方が向いています。組み込みの/doctorも、CLAUDE.mdの中の常に読み込む必要がない部分を見つけて、スキルに移すよう提案してくれます。

フックとの違い

フックは、ファイルを編集する前など、決まったタイミングで必ず動く仕組みです。Claudeの判断に関係なく、毎回確実に実行されます。スキルは、Claudeが内容を読んで判断しながら使うものなので、守られないこともあります。

公式ドキュメントでも、毎回必ず守らせたい決まりは、フックにするよう案内しています。「秘密の情報が入ったファイルは絶対に編集しない」のような、例外を許さない決まりはフックへ、「報告書はこの型で書く」のような判断を伴う手順はスキルへ、という分け方です。

サブエージェントとの違い

サブエージェントは、特定の作業を任せる別の担当のようなものです。独自の指示と使える道具を持ち、本体の会話とは切り離された状態で作業して、結果を返します。

スキルとサブエージェントは組み合わせられます。スキルの設定でcontext: forkを指定すると、そのスキルをサブエージェントで動かせます。反対に、サブエージェントの設定で、あらかじめスキルを読み込ませておくこともできます。

最初のスキルを作る

作る前に決めること

いきなりファイルを書き始める前に、次の3つを決めておくと、うまく動くスキルを作りやすくなります。

• どんな頼み方のときに使うか：「議事録にまとめて」「この記事を校正して」など、実際に使う言葉
• 毎回の手順：何をどの順番で行うか、迷ったときにどうするか
• できあがりの形：ファイルの形式、見出しの構成、保存する場所

フォルダとSKILL.mdを作る

スキルは、1つのフォルダと、その中のSKILL.mdで作ります。自分のパソコンのすべてのプロジェクトで使うなら、ホームフォルダの~/.claude/skills/の下に、スキルの名前でフォルダを作ります。たとえば議事録のスキルなら~/.claude/skills/meeting-minutes/SKILL.mdです。フォルダの名前が、そのまま/meeting-minutesというコマンド名になります。

SKILL.mdの書き方

SKILL.mdは2つの部分でできています。ファイルの先頭の「---」で囲んだ設定部分と、その下の本文です。

• 設定部分：説明文（description）など。Claudeはこれを見て、いつスキルを使うかを判断する
• 本文：スキルを使うときにClaudeが従う手順や決まりごと

公式ドキュメントでは、設定の項目はすべて省略できるとしたうえで、description（説明文）だけは書くことをすすめています。説明文がないと、本文の最初の行が代わりに使われます。設定部分は、ファイルの1行目が「---」で始まっているときだけ読み込まれる点にも注意してください。

見本：議事録を社内の型に整えるスキル

プログラミング以外の仕事でも使える例として、会議のメモを社内の議事録の型に整えるスキルを紹介します。

---
description: 会議のメモや文字起こしを、社内の議事録の型に整える。議事録の作成・整理を頼まれたときに使う。
---
## 議事録の型
1. 会議名・日時・参加者
2. 決まったこと（箇条書き）
3. 宿題（担当者・期限をつけた表）
4. 次回の予定
## 決まりごと
・です・ます調で書く
・決まっていないことは「継続検討」に分ける
・メモにない内容は書き足さない
・できあがったら minutes/ フォルダに「日付_会議名.md」で保存する

手順を細かく書くより、何をすれば完成かと迷ったときにどうするかをはっきり書く方が、Claudeは安定して動きます。公式ドキュメントでも、本文は簡潔にし、どうするかを書くことをすすめています。スキルは一度読み込まれると会話の中に残り続けるので、1行1行が使用量に響くためです。

動かして確かめる

スキルを作ったら、Claude Codeで試します。~/.claude/skills/やプロジェクトの.claude/skills/の中のファイルは自動で見張られているので、作業の途中で追加・修正しても、再起動せずに反映されます（作業を始めたときになかったスキル用のフォルダを新しく作った場合は、/reload-skillsを実行します）。

1. フォルダを作る~/.claude/skills/の下に、スキルの名前のフォルダを作ります。
2. SKILL.mdを書くフォルダの中にSKILL.mdを作り、説明文と本文を書きます。
3. Claude Codeを起動するターミナルでclaudeと入力して起動します。
4. 呼び出してみる説明文に合う頼み方（「このメモを議事録にまとめて」）をするか、/meeting-minutesと入力して直接呼び出します。
5. 直す思っていた仕上がりと違えば、SKILL.mdを直して、もう一度試します。

Claudeに作ってもらう

SKILL.mdは自分で書かなくても、Claude Codeに「この手順をスキルにして」と頼んで下書きを作ってもらえます。普段の作業でうまくいった流れがあれば、その会話のあとに「今の手順を、次から使えるスキルにまとめて」と頼むのが手軽です。

また、Anthropicの公式プラグイン「skill-creator」を入れると、スキルの作成や評価を手伝ってもらえます。公式ドキュメントでは、ターミナルで/plugin install skill-creator@claude-plugins-officialと入力して入れる方法が案内されています。skill-creatorは、スキルがあるときとないときの結果を比べるテストを作ったり、スキルが使われるべき依頼で使われているかを測って説明文の直し方を提案したりできます。

付属のファイルを置く

スキルのフォルダには、SKILL.mdのほかにファイルを置けます。詳しい資料、見本、プログラムなどを分けておくと、SKILL.mdを短く保てます。

meeting-minutes/
├ SKILL.md（必須。概要と、ほかのファイルの案内）
├ examples.md（議事録の良い例。必要なときに読む）
└ scripts/format.py（整形用のプログラム。中身は読まずに実行する）

SKILL.mdの中で「良い例は examples.md を参照する」のように、どのファイルに何が書いてあるか、いつ読むかを書いておくと、Claudeは必要なときだけそのファイルを開きます。

スキルの置き場所と共有

スキルは、置く場所によって使える範囲が変わります。自分だけで使うのか、チームで使うのか、会社全体で使うのかに合わせて選びます。

個人用

~/.claude/skills/に置いたスキルは、そのパソコンのすべてのプロジェクトで使えます。自分の作業のくせに合わせたスキルや、まだ試している段階のスキルはここに置きます。ただし、Coworkやクラウドで動く作業には読み込まれません。

プロジェクト用

プロジェクトのフォルダの.claude/skills/に置いたスキルは、そのプロジェクトで作業するときに使えます。Gitでコミットすれば、同じプロジェクトで作業するチーム全員が同じスキルを使えるようになります。クラウドで動くClaude Codeの作業でも、リポジトリにコミットされたスキルは読み込まれます。

プラグインで配る

複数のプロジェクトやチームで同じスキルを使いたい場合は、プラグインにまとめて配る方法があります。プラグインのスキルは/プラグイン名:スキル名の形で呼び出すので、ほかのスキルと名前がぶつかりません。

組織全体に配る

会社として全員に使わせたいスキルは、管理用の設定（managed settings）を使って、組織が管理するパソコンに配布できます。情報システム担当が管理する方法で、個人やプロジェクトのスキルより優先されます。

claude.aiのアカウントから同期されるスキル

claude.ai（チャット画面）の設定で有効にしたスキルは、同じアカウントで/loginしてログインしたClaude Codeにも同期されます。ターミナルで使う場合はバージョン2.1.273以降が必要です。/skillsと入力すると、「claude.ai sync」の下に同期されたスキルが表示されます。

同期は一方向で、Claude Code側で書き換えてもclaude.aiには反映されません。APIキーでログインしている場合や、Amazon Bedrockなどのクラウドサービス経由で使っている場合は同期されません。同期を止めたいときは、設定でsyncClaudeAiSkillsをfalseにします。

同じ名前のスキルが複数の場所にある場合は、組織、個人、プロジェクトの順に優先されます。たとえばdeployというスキルが個人用とプロジェクト用の両方にあると、/deployでは個人用が動きます。

よく使う設定項目

SKILL.mdの設定部分には、description以外にもいくつかの項目を書けます。公式ドキュメントにはたくさんの項目が載っていますが、ここでは意味が分かりやすく、よく使うものに絞って紹介します。項目の名前は一字一句合っている必要があり、間違えるとエラーも出ずに無視される点に注意してください。

自動で使わせない

disable-model-invocation: trueと書くと、Claudeがそのスキルを自分の判断で使わなくなり、/スキル名で呼んだときだけ動きます。公式ドキュメントでは、デプロイ（本番環境への公開）、コミット、Slackへの投稿のように、影響がある作業や、自分のタイミングで動かしたい作業に使うよう案内しています。「コードの準備ができたように見えたから」とClaudeが勝手にデプロイしては困るからです。

人からは呼ばせない

user-invocable: falseと書くと、/のメニューに表示されなくなり、Claudeだけが使えるスキルになります。古いシステムの仕組みの説明のように、コマンドとして呼ぶ意味はないけれど、関係する作業のときにClaudeに知っておいてほしい背景知識に向いています。

確認なしで使える道具を決める

allowed-toolsに道具を書くと、そのスキルを使っている間は、書いた道具を確認なしで使えるようになります。たとえばコミット用のスキルで、gitのコマンドだけを確認なしにする、といった使い方です。この許可は、次のメッセージを送ると解除されます。

便利な項目ですが、範囲を広げすぎないよう注意が必要です。公式ドキュメントでは、この項目はフォルダを信頼するかどうかの確認に関係なく適用されるため、リポジトリに入っているスキルのallowed-toolsは、Claude Codeを動かす前に確認するよう注意書きがあります。

引数を渡す

スキルを呼び出すときに、続けて書いた言葉を受け取れます。本文の中に$ARGUMENTSと書いておくと、そこが呼び出したときの言葉に置きかわります。たとえば/fix-issue 123と入力すると、本文の$ARGUMENTSが「123」になります。argument-hintを書いておくと、入力するときに何を渡せばよいかのヒントが表示されます。

別の担当（サブエージェント）で動かす

context: forkと書くと、スキルが本体の会話から切り離されたサブエージェントで動きます。サブエージェントは今までの会話を見られないので、スキルの本文だけで作業が完結するように書く必要があります。手順がはっきりしたまとまった作業に向いていて、「この書き方を守って」のような決まりごとだけのスキルには向きません。

特定のファイルのときだけ使う

pathsにファイルの場所のパターンを書くと、そのパターンに合うファイルを扱っているときだけ、Claudeがスキルを自動で使います。たとえば記事の原稿のフォルダを指定しておけば、原稿を編集しているときだけ校正のスキルが使われます。

なお、claude.aiにアップロードするスキルで使える設定項目は、name・description・license・compatibility・metadata・allowed-toolsに限られます。Claude Codeとチャット画面の両方で使うスキルを作るときは、この範囲に収めておくと安心です。

業務で役立つスキルの例

スキルはプログラミングのためだけのものではありません。Claude Codeでファイルを扱う仕事なら、事務作業でも役立ちます。ここでは、手順が決まっていて、くり返し行う仕事を中心に例を紹介します。

文書の型をそろえる

議事録、日報、報告書のように型が決まっている文書は、スキルに向いている代表例です。型、言葉づかい、保存のしかたをスキルに書いておけば、誰が頼んでも同じ形になります。Claudeが勝手に内容を書き足さないよう、「元のメモにないことは書かない」と決めておくのがポイントです。

チェックリストを回す

記事の校正、表記ルールの確認、公開前のチェックなど、確認する項目が決まっている作業もスキルにできます。チェック項目を本文に並べ、結果を「問題なし・要確認・修正案」の形で出すよう書いておくと、人が確かめやすくなります。

決まった手順の作業

請求データの整形、CSVの集計、定型メールの下書きなど、毎回同じ手順で行う作業はスキルにすると楽になります。計算のように毎回同じ結果を出したい部分は、プログラムにしてスキルのフォルダに入れておくと安定します。

開発の作業

エンジニアの作業なら、コードの確認の観点、コミットの前に確かめること、リリースノートの書き方などがスキルの材料になります。公式ドキュメントでは、セッションの始めにverifyやsimplifyという名前のプロジェクトのスキルがあると、コミットの直前にClaudeがそれを実行するよう指示される、という仕組みも紹介されています（文書やテストだけの変更を除く）。

迷ったら、「Claudeが勝手に動かしても困らないか」で自動か手動かを決めましょう。ファイルを整えるだけの作業なら自動、外部に送る・公開する・削除するといった作業なら手動（disable-model-invocation: true）にしておくと安心です。

うまく動かないとき・安全に使うための注意

スキルが使われない

Claudeがスキルを使ってくれないときは、公式ドキュメントに沿って次の順に確かめます。

• 説明文に、ふだん使う言葉が入っているか
• Claudeに「使えるスキルは？」と聞いて、一覧に出てくるか
• 説明文に近い言い方で頼み直してみる
• /スキル名で直接呼び出してみる

設定部分の書き方が間違っていると、スキルの本文は読み込まれても説明文が空になり、Claudeが自動で選べなくなります。claude --debugで起動すると、読み込みのエラーを確認できます。

使われすぎる

関係のない依頼でもスキルが使われてしまう場合は、説明文をもっと具体的にします。自分で呼んだときだけ動かしたいなら、disable-model-invocation: trueを設定します。

途中から守られなくなる

最初は守っていた手順を、会話の途中から守らなくなることがあります。公式ドキュメントでは、原因に応じて次のように直すよう案内しています。

• 毎回必ず守らせたい決まりだった場合：フックに移す。スキルの設定のhooksに書けば、スキルと一緒に管理できる
• 判断して使ってほしい指示だった場合：「テストを実行する」ではなく「編集のたびにテストを実行する」のように、作業全体に当てはまる書き方にする
• 会話の圧縮（コンパクト）が起きた場合：スキルを呼び直す。圧縮後は本文の最初の部分しか残らないことがあるので、大事な指示はSKILL.mdの上の方に書く

スキルが多すぎる

スキルが増えすぎると、一覧に載せられる文字数の上限を超え、使う頻度が低いスキルから説明文が削られます。そうなると、Claudeが説明文で選べなくなります。/doctorで一覧の負担の大きさを確認でき、/skill-doctorでは、スキルごとの負担と使われた回数を見て、止めてよいスキルを探せます。

他人のスキルを使うときの注意

インターネット上には、ほかの人が作ったスキルがたくさん公開されています。便利なものもありますが、スキルはClaudeに指示を与え、プログラムを動かすこともできるので、扱いには注意が必要です。

開発者向けドキュメントでは、自分で作ったものか、Anthropicから入手したものなど、信頼できる出所のスキルだけを使うよう強くすすめています。出所が分からないスキルを使う場合は、使う前に中身をしっかり確かめるよう案内されています。確かめるときは、次の点を見ましょう。

• SKILL.mdと付属のファイルをすべて読み、説明と中身が合っているか
• allowed-toolsで、どんな道具を確認なしに使えるようにしているか
• 外部のサイトに接続したり、データを送ったりする指示がないか
• 入っているプログラムが何をするものか

他人のリポジトリで作業するときも同じです。リポジトリの.claude/skills/に入っているスキルは、そのフォルダでClaude Codeを動かすと読み込まれます。中身とallowed-toolsを確かめてから作業を始めましょう。

よくある質問

まとめ

スキルを使うと、Claude Codeに毎回同じ説明をする手間がなくなり、誰が頼んでも同じ手順で仕事が進むようになります。まずは、いつも貼り付けている指示を1つ選んで、スキルにしてみてください。

自社の業務に合わせてどんなスキルを用意するか、チームでどう共有して管理するかは、業務の整理とあわせて考える必要があります。INTERCREATE JAPANでは、Claude CodeやCodexの導入から、社内の業務に合わせたスキルづくりまでをお手伝いしています。