【PR】この記事には楽天アフィリエイト・Amazonアソシエイトの広告リンクが含まれます。商品やサービスは公式の仕様・条件と販売情報を確認して選んでおり、実機テストによる評価ではありません。 Amazonのアソシエイトとして、PROBEFOLIOは適格販売により収入を得ています。
Claude Codeのスキルは、よく使う手順を1つのファイルにまとめ、必要なときだけ読み込ませる機能です。フォルダーを1つ作り、SKILL.mdを置けば、「/フォルダー名」で呼び出せます。
この記事では、2026年9月24日（追記した内容は25日）に確認したClaude Codeの公式ドキュメントをもとに、最小のスキルの作り方、使える項目と引数、呼ばれないときの直し方を説明します。
この記事の目次
結論：フォルダーにSKILL.mdを置けば、それがスキルになる
スキルづくりは、次の3つで完了します。
- フォルダーを作る：個人用は「~/.claude/skills/<名前>/」、プロジェクト用は「.claude/skills/<名前>/」。
- SKILL.md を書く：先頭を「---」で囲み、その中に description を書く。下に手順を書く。
- 呼び出して確かめる：「/<名前>」で呼び、/skills の一覧に出ているかを見る。
呼び出し名は SKILL.md の name ではなく、フォルダーの名前になります。名前は英数字とハイフンで短くすると打ちやすくなります。
スキル・CLAUDE.md・コマンドの違い
公式ドキュメントでは、CLAUDE.md は常に読み込まれ、スキルは使うときだけ中身が読み込まれると説明されています。使い分けは表「スキルとCLAUDE.mdの使い分け」のとおりです。
以前からある「.claude/commands/」のコマンドも動きますが、新しく作るならスキルが勧められています。
| 置くもの | CLAUDE.md | スキル |
|---|---|---|
| 読み込まれる時 | 毎回の会話で常に | 呼んだとき・内容が合うとき |
| 向いている内容 | プロジェクトの決まり・前提 | 決まった作業の手順・チェック |
| 付けられるファイル | CLAUDE.md 1つ | フォルダー内に資料や例を追加できる |
SKILL.md の先頭で使える主な項目
「---」で囲んだ部分には、description のほかにも項目を書けます。公式ドキュメントに載っている項目のうち、よく使うものを表「SKILL.md の先頭で使える主な項目」にまとめました。
最初は description だけで十分です。必要になったときに1つずつ足すほうが、どの項目が効いているかが分かりやすくなります。
| 項目 | できること |
|---|---|
| description | いつ使うスキルかを書く。Claudeが自分で使うかを決める手がかりになる |
| when_to_use | 使う場面の説明を足す。description に加えて読まれる |
| argument-hint | 「/名前」の後に渡す引数のヒントを表示する |
| disable-model-invocation | true にすると、自分で「/名前」と打ったときだけ使われる |
| user-invocable | false にすると、Claudeだけが使い、「/名前」では呼べない |
| allowed-tools | スキルを呼んだ回の応答の間だけ、決めた道具を確認なしで使えるようにする |
| model | このスキルを使うときのモデルを決める |
作る：議事録を整えるスキルの最小例
例として、貼った会議メモを決まった形に整えるスキルを作ります。個人用のフォルダー「~/.claude/skills/minutes/」を作り、その中に SKILL.md を置きます。
Windows では「~」はユーザーのフォルダー（例：C:\Users\ユーザー名）です。エクスプローラーで「.claude」が見えないときは、表示の設定で隠しファイルを表示してください。
中身は例「SKILL.md の最小例」のとおりです。「---」で囲んだ部分が説明、その下が手順です。
引数を受け取る：$ARGUMENTS
スキルには、呼び出すときに文字を渡せます。SKILL.md の本文に「$ARGUMENTS」と書くと、「/名前」の後に打った文字がそこに入ります。
たとえば、例「引数を受け取るスキル」のように書き、「/minutes 定例会議」と呼ぶと、「定例会議」が本文に入ります。公式ドキュメントでは、「$0」「$1」のように位置で受け取る書き方も案内されています。
長くなったら、補助のファイルに分ける
公式ドキュメントでは、SKILL.md は500行以下に保ち、詳しい資料は別のファイルに分けるよう勧めています。補助のファイルは、使うときだけ読み込まれます。
たとえば、議事録のスキルなら、SKILL.md には手順だけを書き、よい例と悪い例は examples.md に分けます。SKILL.md から「例は examples.md を参照」とリンクしておきます。
呼び出す・確かめる：/minutes と /skills
Claude Code を開き直し、「/minutes」と打ってから会議メモを貼ると、スキルの手順で整えます。
読み込まれたかは、次の2つで確かめます。
- 「/」のメニュー：「/」と打ったときの一覧に minutes が出るか。
- 「/skills」：読み込まれたスキルが、置き場所ごとに一覧で表示されるか。
description に合う依頼（「この議事録を整えて」など）をすると、「/minutes」と打たなくても Claude が自分で使うことがあります。
作ったスキルを試す4つの手順
作ったスキルは、次の順で試すと、うまく動かないときに原因を見つけやすくなります。
- 一覧に出るか：「/skills」で、置き場所とともに一覧に出るかを見る。
- 手で呼べるか：「/名前」で呼び、手順どおりに動くかを確かめる。
- 自動で使われるか：description に合う依頼をして、スキルが使われるかを見る。
- 関係ないときに使われないか：別の依頼をして、スキルが勝手に使われないかを確かめる。
同じ名前のスキルがあるときは、個人用が優先
公式ドキュメントでは、同じ名前のスキルが複数の場所にある場合、会社が管理する設定、個人用（~/.claude/skills/）、プロジェクト用（.claude/skills/）の順で優先されると説明されています。
プロジェクト用に作ったスキルが思いどおりに動かないときは、同じ名前の個人用のスキルがないかを確かめます。名前が重ならないように付けると、混乱を防げます。
呼ばれない・勝手に呼ばれるときの直し方
スキルが思いどおりに使われないときは、次の順に確かめます。
- 一覧に出ない：フォルダーの場所と、SKILL.md の先頭の「---」を確かめる。「---」がないとファイル全体が本文として扱われる。
- 自分で使われない：description に「どんな依頼のときに使うか」を具体的な言葉で足す。
- 関係ないときに使われる：description を狭くするか、「disable-model-invocation: true」を足して手動の呼び出しだけにする。
description は、公式の説明では when_to_use と合わせて1,536字で切られます。大事な言葉は前半に書いてください。
- フォルダー名を、呼び出したい名前にした
- SKILL.md の先頭を「---」で囲んだ
- description に「いつ使うか」を具体的に書いた
- /skills で一覧に出ることを確かめた
description の書き方：よい例と、よくない例
スキルが自分で使われるかどうかは、description の書き方で大きく変わります。表「description のよい例と、よくない例」のように、使う場面の言葉を具体的に入れます。
読んだ人が「どんな依頼のときに使うスキルか」をすぐに分かる書き方が、Claudeにとっても分かりやすい書き方です。
| よくない例 | よい例 |
|---|---|
| 議事録 | 会議のメモを、決定事項・担当と期限・次回の確認に分けて整える。議事録や打ち合わせの記録を整えたいときに使う |
| 文章チェック | 日本語の文章の長い文、あいまいな言葉、表記のゆれを指摘する。記事や報告書を提出する前の見直しで使う |
| 便利なツール | （何をするスキルかが分からないため、書き直す） |
Windowsでスキルのフォルダーを作る手順
Windowsで個人用のスキルを作るときは、エクスプローラーのアドレス欄に「%USERPROFILE%\.claude」と入れて開きます。その中に「skills」フォルダーを作り、さらにスキルの名前のフォルダーを作ります。
SKILL.md は、メモ帳などで作ります。保存するときに「.txt」が付かないよう、ファイルの種類を「すべてのファイル」にしてから、名前を「SKILL.md」にします。
allowed-tools は、必要な道具だけに絞る
allowed-tools を書くと、スキルを呼んだ回の応答の間だけ、決めた道具を確認なしで使えるようになります。次のメッセージを送ると、この許可は消えます。
公式ドキュメントの例では、git の決まったコマンド（add・commit・status）だけを許可しています。
便利な反面、確認なしで動く範囲が広がります。ファイルを消す・送るなど取り消せない操作は、allowed-tools に入れないでください。
最初に作ると便利なスキルの例
スキルにすると便利なのは、何度もくり返し、毎回同じ説明をしている作業です。表「最初に作ると便利なスキル」から、自分の作業に近いものを選びます。
どのスキルも、最初は読み取りや下書きだけにして、ファイルの書き換えは確認してから行う形にしておくと安心です。
| スキル | 中身 |
|---|---|
| 議事録を整える | 決定・担当・期限の見出しで、会議のメモを整える |
| 文章を点検する | 長い文、あいまいな言葉、表記のゆれを指摘する |
| 日報を下書きする | 今日の作業のメモから、3行の日報を作る |
| 変更の説明を書く | コードの変更から、変更の説明文を下書きする |
| チェックリストで確かめる | 提出の前に確かめる項目を、1つずつ点検する |
育てる：使うたびに1行ずつ直す
スキルは、最初から完璧に作る必要はありません。使って「ここが違う」と感じたら、その場で SKILL.md に1行足し、次に使ったときに効いているかを確かめます。
小さく直してすぐ試すことをくり返すと、自分の仕事に合ったスキルに育っていきます。手順が長くなったら、例や資料は別のファイルに分けます。
プロジェクトの決まりそのものはCLAUDE.mdの書き方に置き、手順だけをスキルにすると整理しやすくなります。
SKILL.md の書き方の考え方はSKILL.mdとは？の記事でも説明しています。
他人が作ったスキルを使う前に読む
インターネットで公開されているスキルを使う前に、SKILL.md と補助のファイルを必ず読みます。特に allowed-tools や、コマンドを実行する部分があるかを確かめます。
公式ドキュメントも、スキルは自分に広い許可を与えられるため、リポジトリに入っているスキルは Claude Code を動かす前に allowed-tools を確かめるよう注意しています。
中身が読めない、何をするか分からないスキルは使わないでください。試すときは、大事なファイルのない作業用のフォルダーで動かします。
よくある疑問を、ここで。
使い始める前に、気になるところから。
スキルとCLAUDE.mdは何が違いますか？
CLAUDE.md は毎回の会話で常に読み込まれ、スキルは呼んだときや内容が合うときだけ読み込まれます。いつも守る決まりは CLAUDE.md、ときどき使う手順はスキルに置くのが基本です。
作ったスキルが一覧に出ません。
フォルダーの場所（~/.claude/skills/<名前>/ か .claude/skills/<名前>/）を確かめてください。SKILL.md の先頭が「---」で囲まれているかも見て、Claude Code を開き直してから /skills で確認します。
個人用とプロジェクト用はどう使い分けますか？
自分がどのプロジェクトでも使う手順は個人用（~/.claude/skills/）、チームで同じ手順を使うものはプロジェクト用（.claude/skills/）に置き、リポジトリで共有します。
スキルに引数を渡せますか？
渡せます。公式ドキュメントでは、SKILL.md の本文に「$ARGUMENTS」と書くと、「/名前」の後に打った文字が入ると説明されています。「$0」「$1」のように位置で受け取る書き方もあります。
CLAUDE.md に書いた手順は、スキルに移したほうがいいですか？
毎回の会話で守ってほしい決まりは CLAUDE.md に残し、ときどき使う作業の手順だけをスキルに移すのがおすすめです。CLAUDE.md は常に読み込まれるため、使わない手順まで書くと会話が重くなります。
この記事を共有する
商品情報の提供：Supported by Rakuten Developers
出典と、この記事について
公式資料や、記事で参照した発表・報道をまとめています。仕様や料金は、利用する前に最新の案内をご確認ください。
確認した内容と条件は本文に記載しています。結果や使い勝手は、資料や環境によって異なります。編集方針を読む
ぜひコメントください