Anthropic の公式の説明(下の「公式のページ」)を、内容を足さずに読みやすい日本語に書き直したものです。公式の翻訳ではなく、Anthropic が作ったものでもありません。公式は予告なく変わるので、使う前に公式のページもご覧ください。
このページで分かること
- スキルとは何か、公式がどんなときに作るよう勧めているか
- スキルの呼び出し方と、置く場所によって使える範囲がどう変わるか
- はじめてのスキルの作り方と、Claude に勝手に使わせない設定
先に知っておく言葉
- スキル:指示・知識・手順を書いた
SKILL.mdというファイル。Claude が必要なときに読み込むほか、/スキル名と打って呼び出せます - CLAUDE.md:毎回のセッションの始めに読み込まれる、Claude への決まりごとを書いたファイル
- 同梱のスキル(Bundled skills):Claude Code に最初から付いてくるスキル
- プラグイン:スキルやフックなどを、ひとまとめにして入れられる形にしたもの
- クラウドのセッション:あなたのパソコンでなく、クラウドの機械の上で動くセッション
- リポジトリ・コミット:git で変更の記録を取っているプロジェクトのフォルダ/変更をひと区切りとして記録に残すこと
- フロントマター(Frontmatter):Markdown のファイルの一番上に、
---の行で挟んで書く設定の欄 - フック:決まった時点(ファイルを書き換える前など)に、Claude の判断と関係なく毎回動く処理
スキルのしくみ
SKILL.mdに指示を書いて置いておくと、Claude はそれを使える道具の一つに加えます。話の中身に関係があれば Claude が自分で読み込み、/スキル名と打てばあなたから呼び出せます- 中身が読み込まれるのは、使うときだけです。何も設定しなければ、ふだん Claude に見えているのは名前と説明の一覧だけです。毎回読み込まれる CLAUDE.md と違って、長い資料を入れておいても、使うまではほとんど記憶を使いません
- 前からある「カスタムコマンド」(
.claude/commands/に置くファイル)は、スキルにまとめられました。.claude/commands/deploy.mdも.claude/skills/deploy/SKILL.mdも、どちらも/deployになり、動き方は同じです。今あるコマンドのファイルも引き続き使えます - スキルの書き方は、Agent Skills という、いくつもの AI の道具に共通の公開された決まりに沿っています(Claude Code は、その決まりに独自の機能を足しています)
呼び出し方
- デスクトップアプリでは:入力欄で
/を打つか、+ ボタンから Slash commands を選びます。最初から入っているコマンド、あなたのスキル、プロジェクトの中のスキル、入れたプラグインのスキルが並びます。選ぶと入力欄に入るので、続けてやってほしいことを書いて送ります - ターミナルで使う版(CLI)では:
/スキル名と打ちます - Claude に任せる:スキルの説明に合う話をすると、Claude が自分で読み込みます
最初から付いてくるスキル(同梱のスキル)
- たとえば
/doctor・/code-review・/batch・/debug・/loop・/claude-apiがあります。Claude に詳しい指示を渡し、道具を使った進め方は Claude に任せる作りです(多くの組み込みのコマンドは、決まった処理をそのまま動かします) - 多くはどのセッションでも使えます。一部は、特定の機能を有効にしたときだけ使えます
- 自分のアプリを動かして確かめる3つもあります。
/runはアプリを起動して変更が効いているかを見る、/verifyはテストや型の確認に頼らずアプリを動かして変更が狙いどおりかを確かめる、/run-skill-generatorはその2つにプロジェクトのビルドと起動のしかたを覚えさせる、という役目です。/verifyは、あなたが呼び出したときだけ動きます
置く場所で、使える範囲が変わる
- 個人(
~/.claude/skills/スキル名/SKILL.md):このパソコンのすべてのプロジェクトで使えます。ただし Cowork とクラウドのセッションでは読み込まれません - プロジェクト(
.claude/skills/スキル名/SKILL.md):そのリポジトリでのセッションで使えます。コミットすれば、同じリポジトリで作業する人も使えます - プラグイン:そのプラグインを有効にした所で、
/プラグイン名:スキル名という名前で使えます - claude.ai のアカウント:アカウントで有効にしたスキルが、Cowork とクラウドのセッションに加え、ターミナルでも同じアカウントでサインインしていれば使えます(ターミナルでは v2.1.273 以降。API キーで使っているときなどは読み込まれません)
- 組織:組織が配ったスキルは、組織がそれを配ったパソコンを使うすべての人に読み込まれます
- 同じ名前のスキルが個人とプロジェクトの両方にあるときは、個人のほうが動きます(組織のものがあれば、組織のものが最優先です)
はじめてのスキルを作る
公式の例は、まだコミットしていない変更をまとめて、危なそうな所を挙げるスキルです。試す手順は CLI で書かれています。
- 個人のスキルの場所に、
~/.claude/skills/summarize-changesというフォルダを作ります - その中に
SKILL.mdを作ります。上の---で挟んだ欄(フロントマター)のdescriptionに「何をするスキルで、いつ使うか」を、その下に Claude への指示を書きます。打つときの名前はフォルダ名になります(フロントマターにnameを書けば、そちら)。descriptionは、Claude が自分で読み込むかどうかを決める手がかりです - 公式の例では、指示の前に `
!git diff HEAD` という行を置いています。Claude が読む前に、この行が命令の結果(いまの変更の中身)に置き換わります - git のプロジェクトで何かのファイルを少し変え、
claudeで起動します。何を変えたかを聞くか、/summarize-changesと打って試します
書くときの決まり:
- フロントマターの欄はすべて省けます。公式が書くよう勧めているのは
descriptionだけです descriptionとwhen_to_useは合わせて1,536字で切れて一覧に載ります。いちばん大事な使いどころを先に書きますSKILL.mdは500行までに収め、細かい資料は同じフォルダの別のファイルに分けます。どのファイルに何があるかはSKILL.mdに書いておきます
だれが呼び出せるかを決める
何も書かなければ、あなたも Claude も呼び出せます。フロントマターで変えられます。
disable-model-invocation: true:あなただけが呼び出せます。Claude は自分からは使いませんuser-invocable: false:Claude だけが使います。/の一覧に出ず、/スキル名と打っても動きませんallowed-tools:そのスキルを呼び出した回のあいだ、書いた道具をあなたに聞かずに使えるようにします。次のメッセージを送ると元に戻ります
うまく動かないとき
- 使ってほしいのに使われない:説明に、ふだん口にする言葉を入れる/「What skills are available?」と聞いて一覧に出ているか確かめる/説明に寄せて言い直す/
user-invocable: falseにしていなければ、/スキル名で直接呼び出す - 使ってほしくないときに使われる:説明をもっと具体的にするか、
disable-model-invocation: trueを付けます - 途中から従わなくなる:毎回必ず守らせたい決まりはフックに移します。判断で使ってほしい指示は、「テストして」でなく「変更のたびにテストして」のように作業全体にかかる書き方にします。会話が要約されたあとは、スキルをもう一度呼び出します(要約のあとは頭の部分しか残らないことがあるので、大事な指示は上のほうに書きます)
- やめる:個人・プロジェクトのスキルは、そのフォルダを消します。プラグインのスキルは、プラグインを止めるか外します
公式が挙げている使いどころ
公式のページに書いてある向き・使い方だけを並べます。
- 作りどき:同じ指示・チェックリスト・何段階もの手順を、何度もチャットに貼っているとき。CLAUDE.md の一部が、事実でなく手順になってきたとき
- 中身の2つの型:決まりごと・書き方の指針・その分野の知識のような「参考にする中身」は、いまの作業に合わせて使わせる向き。デプロイやコミットのような「作業の手順」は、Claude に任せず
/スキル名で自分から呼び出すことが多い、とあります disable-model-invocation: trueの向き:外に影響が出る作業や、始める時を自分で決めたい作業(たとえば/commit・/deploy・/send-slack-message)。コードが仕上がったように見えたからといって、Claude がデプロイを決めてしまわないようにuser-invocable: falseの向き:命令として打つ意味のない、背景の知識(たとえば古い仕組みの説明)- 本文は短く:読み込まれた中身はそのあとのやり取りのあいだ残り続け、1行ごとに使う量が積み重なります。何をするかを書き、どうやって・なぜを語らないように、とあります
- リポジトリに入っているスキル:
allowed-toolsで広い権限を自分に与えられるため、そのリポジトリで Claude Code を動かす前に見直すように、とあります - 効いているかの確かめ方:呼び出されたことは、狙いどおりに動いた証拠ではありません。ありそうな指示をいくつか用意し、新しいセッションで、スキルがある時と止めた時の結果を比べます
- 配り方:プロジェクトのスキルは
.claude/skills/をコミットする、プラグインのskills/フォルダに入れる、組織全体には管理者の設定(managed settings)で配る、の3つです
あわせて読む
- CLAUDE.md と自動メモリ(Auto memory):プロジェクトの決まりごとを覚えさせる
- コマンド(Commands):/ で呼び出すコマンドの一覧
- プラグイン(Plugin):機能をまとめて入れる・管理する
公式のページ
- Extend Claude with skills(英語・原文)code.claude.com ↗
- Claude をスキルで拡張する(公式の日本語版)code.claude.com ↗
- Use Claude Code Desktop の「Use skills」(デスクトップアプリでの説明)code.claude.com ↗
- Glossary(用語集。上の「先に知っておく言葉」の言い換えに使いました)code.claude.com ↗
確認メモ:2026年10月1日に、公式のスキルのページ(英語・日本語)とデスクトップアプリのページ、用語集を開いて、スキルの置き場所と使える範囲、作り方の手順、呼び出せる人の設定、うまく動かないときの対処を突き合わせました。公式のページに更新日の表示は無いため、この日付は「このサイトが確かめた日」です。公式のページは約10万字あり、フロントマターの細かい欄(引数・モデル・努力レベル・サブエージェントで動かす設定など)、引数の受け渡し、命令の結果を差し込む書き方の細かい決まり、claude.ai から同期されるスキルの細かい扱い、名前がぶつかったときの細かい決まり、入れ子のフォルダや追加のフォルダからの読み込み、設定ファイルでの見せ方の変更、/skill-doctor での使われ方の確認、skill-creator プラグインでの評価、/claude-api の使い方、組織の管理者向けの配り方は、細かい設定やターミナルだけの操作のため載せていません。「リポジトリ」「コミット」の言い換えは公式の用語集に無く、ふつうの意味を一言で添えたものです。「プラグイン」は用語集の Plugin の説明(スキル・フック・サブエージェント・MCP サーバーをまとめて入れられる形にしたもの)を短くしたものです。用語集の CLAUDE.md・Bundled skills・Cloud session・Frontmatter・Hook・Skill の言い換えも、用語集の説明に沿っています。英語版と日本語版で、このページに載せた中身に違いはありませんでした。