blog
AIブログ
Claude Code Skillsとは?公式スキル一覧・作り方・使い方をわかりやすく解説【2026年版】
文:クリスタルメソッド編集部 監修:河合 継(代表取締役)

Claude Code Skills(スキル)とは、Claude Codeに「この場面ではこう進めてほしい」という手順書(SKILL.md)を追加して、必要なときに読み込ませる仕組みです。フォルダを1つ作ってMarkdownファイルを1つ置くだけで、/スキル名 と入力して呼び出したり、会話の内容に合わせてClaudeが自動で使ったりできます。この記事では、2026年10月に確認した公式ドキュメントをもとに、最初から入っているスキルとAnthropicが公開している19個の一覧、実際の画面つきの作り方、使い方、claude.aiのスキルとの関係、プラグインでの配り方と注意点を、初めての方にも分かる順に解説します。
知りたいことから読む場合は、次の章へどうぞ。
- どんなスキルがあるか知りたい:スキルの一覧(同梱スキルとAnthropic公開の19個)
- 自分で作ってみたい:作り方(実際の画面つき)
- 呼び出し方・引数・設定項目を知りたい:使い方・SKILL.mdの書き方
- claude.aiのスキルとの関係を知りたい:ほかの機能との違い
- チームに配りたい:スキルパックとプラグイン
- 動かない・安全面が気になる:注意点とセキュリティ
Claude Code Skillsとは?ひとことで言うと「Claude Codeに覚えさせる手順書」
Claude Code Skillsは、AnthropicのコーディングエージェントClaude Codeに、繰り返し使う手順や知識を「スキル」として追加する仕組みです。スキルの実体は SKILL.md という1つのMarkdownファイルで、先頭のYAML(frontmatter)に「いつ使うか」を、本文に「何をどう進めるか」を書きます。Claude Codeは会話の内容に合うスキルを自分で選んで読み込むほか、/スキル名 と入力して直接呼び出すこともできます(出典:公式ドキュメント「Extend Claude with skills」)。
チャットのAI本体であるClaude(クロード)はclaude.aiの画面で使うものですが、Claude CodeはそのClaudeをターミナルやエディタから動かし、ファイルの読み書きやコマンドの実行まで任せられる開発用のツールです。Skillsは、このClaude Codeに「自分たちの手順」を覚えさせるための機能と捉えると分かりやすいです。
押さえておきたい特徴は3つです。
- ファイル1つで作れる:
.claude/skills/スキル名/SKILL.mdを置くだけで、再起動なしに使えるようになります。 - 必要なときだけ読み込まれる:セッション中は各スキルの名前と説明(description)だけが常に文脈に入り、本文は呼び出されたときに初めて読み込まれます。使わないスキルが文脈(コンテキスト)を圧迫しにくい設計です。
- チームで共有できる:プロジェクトの
.claude/skills/をコミットすれば、同じリポジトリで作業する全員が同じスキルを使えます。
メインの作業と分けて役割を任せる仕組みは、Claude Codeのサブエージェントの作り方で解説しています。
関連記事Claude CodeのAgent Teamsとは?
Claude Code Skillsの種類:最初から入っているスキルと、自分で作るスキル
スキルは大きく「最初から入っているスキル(バンドルされたスキル)」と「自分やチームで作るスキル」の2種類に分かれます。
最初から入っているスキル(同梱スキル)
Claude Codeには、/doctor(設定の点検)、/code-review(コードレビュー)、/debug、/batch、/loop、/claude-api(Claude APIの参照資料)、/run・/verify(アプリを実際に起動して変更を確かめる)などのスキルが最初から入っています。/ に続けてスキル名を入力して呼び出すほか、関係がありそうな場面ではClaudeが自動で使います(/verify のように、自分で呼んだときだけ動くものもあります)。不要なら設定の disableBundledSkills でまとめて無効にできます。
同梱スキルは、Claudeに詳しい指示を渡し、ツールを使った進行をClaudeに任せる「プロンプト型」です。固定の処理を直接実行する組み込みコマンド(/help や /compact など)とは性質が違い、コマンド一覧では「Skill」と表示されます。公式ドキュメントとコマンド一覧で説明を確認できたものは次のとおりです(2026年10月27日確認)。
| スキル | することと使いどころ |
|---|---|
/doctor |
セットアップの点検。インストール・設定ファイル・拡張(使っていないスキルやMCP・プラグインの文脈コスト、遅いフック)・CLAUDE.md・権限・利用量を調べ、直す前に確認を取ります。/doctor prompt-audit(v2.1.283以降)は、CLAUDE.mdやスキルの古い指示・食い違う指示の点検です |
/code-review |
現在の差分、またはPR・ブランチ・パスのバグを探します。--fix で修正、--comment でPRへの投稿までできます(/review は同じ動きの別名) |
/simplify |
変更したコードの整理(既存の関数の再利用・簡素化・効率・抽象化の高さ)を、4つのレビュー用エージェントで並行して確認し、直します。バグ探しはしません(バグは /code-review) |
/debug |
今のセッションのデバッグログを有効にし、ログを読んで不具合の原因を調べます |
/batch |
大きな変更を5〜30の独立した単位に分け、計画の承認後に、単位ごとにバックグラウンドのサブエージェントを別々のworktreeで動かします(gitリポジトリが必要) |
/loop |
間隔を決めて(省略するとClaudeが間隔を決めます)、同じプロンプトをセッションが開いている間くり返します |
/claude-api |
Claude APIとManaged Agentsの参照資料を、プロジェクトの言語に合わせて読み込みます。コードが anthropic や @anthropic-ai/sdk を読み込んでいると自動でも使われます。/claude-api migrate(コードを新しいモデルへ)、upgrade(SDKのメジャーバージョン移行・v2.1.236以降)、cost-optimize(API費用の見直し・v2.1.247以降)などのサブコマンドがあります |
/run・/verify・/run-skill-generator |
アプリを実際に起動して変更が動くことを確かめます(テストや型チェックに頼らない)。起動手順が複雑なプロジェクトでは、/run-skill-generator が手順を .claude/skills/run-名前/ に記録し、以後の /run・/verify がそれに従います |
/workflow-authoring |
動的ワークフローを有効にしているときだけ使えます(公式の例) |
/verify は、自分で呼んだときだけ動きます(時間とトークンを使う長い確認なので、勝手には動かない設計)。「verify」または「simplify」という名前のスキルを自分で置いておくと、Claude Codeはコミットの直前にそのスキルを実行します(v2.1.286以降。ドキュメントやテストだけの変更は除く。プラグインのスキルとclaude.aiから同期したスキルは対象外)。同梱スキルをまとめて止めたいときは設定の disableBundledSkills を使います(/doctor だけは入力できる状態が残ります)。
自分やチームで作るスキル:置き場所で「誰が使えるか」が決まる
自作のスキルは、SKILL.md をどこに置くかで読み込まれる範囲が決まります。公式ドキュメントに載っている置き場所は次の7つです。
| 種類 | 置き場所 | 読み込まれる範囲 |
|---|---|---|
| 個人用(Personal) | ~/.claude/skills/スキル名/SKILL.md |
そのパソコンのすべてのプロジェクト(Coworkやクラウドのセッションでは読み込まれません) |
| プロジェクト用(Project) | .claude/skills/スキル名/SKILL.md |
そのリポジトリのセッション。コミットすればチーム全員が使えます |
| 入れ子(Nested) | サブフォルダ/.claude/skills/スキル名/SKILL.md |
そのサブフォルダ以下で始めたセッション。上の階層で始めた場合は、その中のファイルを触ったときに読み込まれます |
| 追加フォルダ | --add-dir で渡したフォルダの .claude/skills/ |
そのセッションだけ |
| プラグイン | プラグイン/skills/スキル名/SKILL.md |
プラグインを有効にした場所(/プラグイン名:スキル名 で呼び出します) |
| 組織用(Enterprise) | 管理者が配布する設定フォルダ内の .claude/skills/ |
組織が配布したパソコンのすべての利用者 |
| claude.aiアカウント | claude.aiの設定で有効にしたスキル | 同じアカウントでサインインしたターミナル・Cowork・クラウドのセッション(~/.claude/skills/synced/ に自動で同期) |
以前の「カスタムコマンド」(.claude/commands/ のMarkdownファイル)は古い形式として今も動きますが、新しく作るならスキルの形が推奨されています。スキルは参照資料やスクリプトを同じフォルダに同梱でき、frontmatterの name と paths も使えるためです。同じ名前のスキルが複数の場所にあるときは「組織用 → 個人用 → プロジェクト用」の順に優先され、自作のスキルは同名のバンドルされたスキルを置き換えます(出典:Claude Code公式ドキュメント「Claude をスキルで拡張する」)。
次に読む:Claude Codeでプラグインを使うには?
Claude Codeを拡張するコマンド|/plugin /deep-research /claude-api ほか【2026年版】
Claude Codeで使えるスキルの一覧:Anthropic公開の19個と、用途別の選び方
同梱スキルのほかに、Anthropicは見本となるスキルをGitHubの公開リポジトリ anthropics/skills で配っています。2026年10月27日に確認した時点で、skills/ の下には次の19個があります(説明は各スキルのSKILL.mdの説明文を要約)。リポジトリのREADMEは、これらを「デモと学習用」としたうえで、重要な作業に使う前に十分に試すよう案内しています。
| スキル名 | 何をするか | 入れるプラグイン |
|---|---|---|
docx文書 |
Word文書の作成・編集。頼み方の例:「この議事録をWordの報告書にして」 | document-skills |
xlsx |
Excelの表・分析・グラフつきレポート。例:「この売上表を月別に集計して、グラフ入りのxlsxにして」 | document-skills |
pptx |
PowerPointのスライドの作成・編集。例:「この企画書を10枚のスライドにして」 | document-skills |
pdf |
PDFの作成・処理。例:「このPDFから表を取り出して」 | document-skills |
algorithmic-artデザイン・表現 |
p5.jsで、コードから模様やアートを描く。例:「流れる粒子のアートを作って」 | example-skills |
canvas-design |
ポスターなどの静止画をPNG・PDFで作る。例:「イベント告知のポスターを作って」 | example-skills |
frontend-design |
画面(UI)を作るときの見た目・書体の方向づけ。例:「このダッシュボードの見た目を整えて」 | example-skills |
theme-factory |
スライドや文書に、用意されたテーマ(色・書体)を当てる。例:「このスライドにテーマを当てて」 | example-skills |
slack-gif-creator |
Slack向けの動くGIFを作る。例:「お疲れさま用のGIFを作って」 | example-skills |
brand-guidelines仕事・社内文書 |
Anthropicのブランドの色と書体を当てる。自社の色・書体を決めたスキルを作るときの見本になります | example-skills |
internal-comms |
状況報告など社内向けの文章を、決まった形式で書く。例:「今週の進捗報告を書いて」 | example-skills |
doc-coauthoring |
提案書・仕様書などを、段階を踏んで一緒に書き上げる。例:「仕様書を一緒に書いて」 | example-skills |
web-artifacts-builder開発 |
Reactなどを使った、複雑なArtifacts(画面)を作る。例:「状態管理のあるツール画面を作って」 | example-skills |
webapp-testing |
Playwrightで手元のWebアプリを操作・確認する。例:「ローカルのアプリのログインが動くか試して」 | example-skills |
mcp-builder |
外部サービスにつなぐMCPサーバーを作る手引き。例:「このAPI用のMCPサーバーを作って」 | example-skills |
claude-api |
Claude APIの参考資料(Claude Codeには同梱スキルとして最初から入っています) | claude-api |
skill-creatorスキル作り・学習 |
スキルを新しく作る・直す・性能を測る。例:「このスキルを評価して」(後の章) | example-skills |
academy-guide |
Claudeの使い方の質問に、Claude Academyの講座を案内する | academy-guide |
discernment-nudge |
助言や下書きの後に、利用者が確かめるべき点を問いかけとして添える | discernment-nudge |
入れ方は、スキル集を1度登録してから、必要なプラグインを入れる2段階です。リポジトリの .claude-plugin/marketplace.json には document-skills(文書の4つ)、example-skills(上の表の12個)、claude-api、academy-guide、discernment-nudge の5つのプラグインがあり、プラグインごとに入れます。
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
入れたスキルは「/プラグイン名:スキル名」で呼び出せるほか、descriptionに合う場面ではClaudeが自動で使います。プラグインの仕組み(範囲・配り方)はスキルパックとプラグインの章で説明します。
プラグインを使わずに、1つだけ手元に置く方法もあります。スキルは「SKILL.mdを入れたフォルダ」なので、リポジトリを取得し(git clone https://github.com/anthropics/skills.git)、使いたいスキルのフォルダ(たとえば skills/pdf)を、自分用なら ~/.claude/skills/、プロジェクト用なら .claude/skills/ へフォルダごとコピーします。スクリプトや参照資料を同梱したスキルもあるので、SKILL.mdと中身を読んでから使ってください。プラグインで入れたスキルの更新は、/plugin の「Installed」タブで「Update now」を選ぶか、シェルで claude plugin update プラグイン名@マーケットプレイス名 を実行します。マーケットプレイス単位でまとめて更新するときは、/plugin の「Marketplaces」タブで「Update marketplace」を選びます(2026年10月27日、公式の「Discover and install plugins」で確認)。なお、docx・xlsx・pptx・pdf の4つは、READMEによるとソースは公開されていますがオープンソースではなく、ほかの多くのスキルはApache 2.0です。
用途別に見る:コード生成・レビュー・文書・出荷のスキル
どんなスキルを作る・入れるかの目安を、用途別に並べます。「最初から入っている」は本体に同梱のスキル、「公式の例」は公式ドキュメントの例、gstackとdocument-skillsは前後の章で紹介する公開スキルです。
| 用途 | スキル | 使う場面と頼み方の例 |
|---|---|---|
| コード生成・修正 | fix-issue(公式の例) | Issue番号を渡し、読む→実装→テスト→コミットの順で進める 例: /fix-issue 123 |
| レビュー | /code-review(最初から入っている)、gstackの /review | 変更したコードのバグや抜けを探す 例: /code-review |
| 変更の要約 | summarize-changes(この記事で作った例)、pr-summary(公式の例) | コミット前・プルリクエストの確認 例: /summarize-changes |
| 原因調査 | /debug(最初から入っている)、gstackの /investigate | 不具合の原因を順を追って調べる 例:「ログインで落ちる原因を調べて」 |
| 文書の作成 | document-skills の docx・pdf・pptx・xlsx | Word・PDF・PowerPoint・Excelのファイルを扱う 例:「この表をExcelにして」 |
| テスト・出荷 | gstackの /qa、/ship | サイトのテストと修正、テスト後のプルリクエスト作成 例: /qa |
claude.aiで入れたスキルも、Claude Codeの一覧に並ぶ
claude.aiのアカウントでサインインしたターミナルでは、claude.aiの設定で有効にしたスキル(pdf・xlsx などAnthropic製のものや、自分でアップロードしたもの)が ~/.claude/skills/synced/ に自動で取り込まれ、/skills の一覧に「claude.ai sync」と表示されます(v2.1.273以降。取り込みは一方向で、手元で書き換えてもclaude.aiには戻りません)。claude.ai側の「探索」にあるパートナー企業(Notion・Figma・Atlassianなど)のスキルも同じ形式です。詳しくはclaude.aiのスキルとの違いの節で説明します。
Claude Code Skillsの作り方:SKILL.mdを1つ書いて呼び出すまで(実際の画面つき)
ここでは「コミット前の変更を要約して、リスクを指摘するスキル」を例に、作成から実行までを実際に操作した画面で説明します。公式ドキュメントの「最初のスキルを作る」と同じ流れで、必要なファイルは SKILL.md の1つだけです。
手順1:スキル用のフォルダを作る
プロジェクトのルートで、スキル名のフォルダを作ります。チームで共有するならプロジェクト用(.claude/skills/)、自分のパソコンの全プロジェクトで使うなら個人用(~/.claude/skills/)です。フォルダ名がそのままコマンド名(この例では /summarize-changes)になります。
mkdir -p .claude/skills/summarize-changes
~/.claude/skills/ の下に同じ形で作ります(公式ドキュメントの説明をもとに作成)手順2:SKILL.mdを書く
作ったフォルダの中に SKILL.md を作ります。先頭の --- で囲んだ部分がfrontmatterで、description に「何をするか・いつ使うか」を書きます。その下がClaudeへの指示(本文)です。
---
description: コミット前の変更内容を要約し、リスクがあれば指摘する。「何を変えた?」「変更を確認して」「コミットメッセージを考えて」と頼まれたときに使う。
allowed-tools: Bash(git diff *)
---
## 現在の変更
!`git diff HEAD`
## 指示
上の差分を日本語で2〜3行に要約してください。そのあと、気づいたリスク(エラー処理の不足、ハードコードされた値、更新が必要なテスト)を箇条書きで挙げてください。差分が空なら「コミットされていない変更はありません」と答えてください。
!`git diff HEAD` の行は「動的コンテキストの挿入」です。スキルが呼ばれるとClaude Codeがこのコマンドを先に実行し、出力をこの行と差し替えてからClaudeに渡すため、Claudeは実際の差分を見たうえで答えます。allowed-tools: Bash(git diff *) は、このコマンドを確認なしで実行してよいという事前の許可です(自動モード以外では、許可されていないコマンドが含まれているとスキルの呼び出し自体が中止されます)。

cat で SKILL.md の中身を確認し、git status で cart.js に未コミットの変更があることを確かめています(2026年10月14日に実際に操作して撮影。Linux・Claude Code v2.1.299)手順3:Claude Codeで呼び出して動かす
ファイルを保存したら、そのプロジェクトで claude を起動します。セッション中に追加したスキルも再起動なしで読み込まれます。入力欄に / と打つと候補にスキルが並び、description の文がそのまま説明として表示されます。

/summ と打った画面。作ったばかりの /summarize-changes が候補の先頭に出て、説明文にはSKILL.mdのdescriptionがそのまま表示されています(2026年10月14日に実際に操作して撮影。Linux・Claude Code v2.1.299)/summarize-changes と入力してEnterを押すと、スキルの本文が実際の差分つきでClaudeに渡り、変更の要約とリスクが返ってきます。

/summarize-changes の実行結果。cart.jsの変更(消費税10%込みの金額を返すようになった)を要約したうえで、税率のハードコードや更新が必要なテストなどのリスクを挙げています(2026年10月14日に実際に操作して撮影。Linux・Claude Code v2.1.299)/summ で自作スキルを選んで実行し、結果が返ったあと /skills で一覧を開くまでの録画(約33秒・音声なし)(2026年10月14日に実際に操作して撮影。Linux・Claude Code v2.1.299)ここまでで、スキルの作成と実行は完了です。動かないときは、この記事の後半「注意点とセキュリティ」にある「スキルが呼ばれないとき」を確認してください。
Claude Code Skillsの使い方:自動呼び出し・引数・一覧の確認・編集の反映
呼び出し方は2通り:自分で呼ぶ/Claudeが自動で使う
初期設定では、あなたとClaudeのどちらもスキルを呼び出せます。あなたは /スキル名 で直接呼び、Claudeは会話の内容が description に合うときに自動で使います。たとえば先ほどのスキルがある状態で「いま何を変更しましたか?」と聞くだけで、ClaudeはSkillツールで summarize-changes を選びます。手動モード(manual mode)では、次のようにスキルを使ってよいかの確認が出ます。

/ を使わずに「いま何を変更しましたか?」と聞いた画面。Claudeがdescriptionを見て自分でスキルを選び、手動モードなので「Use skill “summarize-changes”?」の確認が出ています(Yes・このフォルダでは今後聞かない・No)(2026年10月14日に実際に操作して撮影。Linux・Claude Code v2.1.299)この動きは、frontmatterの2つの項目で変えられます。
| frontmatter | 呼び出せるのは | 文脈への読み込み |
|---|---|---|
| (指定なし) | あなた:○ Claude:○ |
説明は常に、本文は呼び出し時に |
disable-model-invocation: true |
あなた:○ Claude:×(Claudeが呼ぼうとすると止められます) |
説明も文脈に入らず、本文は呼び出し時に |
user-invocable: false |
あなた:×(/メニューに出ません) Claude:○ |
説明は常に、本文は呼び出し時に |
デプロイやSlackへの送信のように、実行のタイミングを自分で決めたい作業は disable-model-invocation: true にしておくと、Claudeが勝手に実行することはありません。逆に「古いシステムの仕様」のような、コマンドとして打つ意味のない知識は user-invocable: false にしてClaudeだけが参照する形にします。
引数を渡す($ARGUMENTS)
/fix-issue 123 のようにスキル名の後ろに書いた文字列は、本文の $ARGUMENTS に置き換わります。$0・$1(または $ARGUMENTS[0])で位置ごとに取り出したり、frontmatterの arguments: [issue, branch] で名前を付けて $issue のように使ったりもできます。本文に置き場所が無い場合は、末尾に ARGUMENTS: 入力した内容 が自動で追加されます。
---
name: fix-issue
description: GitHubのIssueを番号で指定して修正する
disable-model-invocation: true
---
GitHub Issue $ARGUMENTS を、このリポジトリのコーディング規約に従って修正してください。
1. Issueの説明を読む
2. 要件を整理する
3. 修正を実装する
4. テストを書く
5. コミットを作る
一覧を見る・表示を切り替える(/skills)
/skills を実行すると、読み込まれているスキルの一覧と、それぞれが文脈に占めるおおよそのトークン数が表示されます。claude.aiから同期されたスキル・プラグインのスキル・プロジェクトのスキルが出どころ付きで並びます。この画面でスキルを選んでSpaceを押すと「on → name-only → user-invocable-only → off」と表示の状態を切り替えられ、Escで .claude/settings.local.json の skillOverrides に保存されます。共有リポジトリのスキルなど、ファイルを編集せずに一時的に止めたいときに便利です。

/skills の画面。claude.aiから同期されたスキル(pdf・xlsxなど)とプラグインのスキルに続いて、作ったプロジェクトのスキル summarize-changes(project・約30トークン)が並んでいます。説明が長いスキルは、画面の幅に合わせて途中までしか表示されません(2026年10月14日に実際に操作して撮影。Linux・Claude Code v2.1.299)編集の反映と削除
Claude Codeはスキルのフォルダを監視しているため、~/.claude/skills/ やプロジェクトの .claude/skills/ の中の SKILL.md を追加・編集・削除すると、そのセッション中に反映されます。セッションを始めたあとに .claude/skills/ フォルダ自体を新しく作った場合だけ、/reload-skills を実行します。削除はフォルダを消すだけです(バンドルされたスキルは skillOverrides で "off" にします)。
なお、一度呼び出したスキルの本文は、その会話の中に残り続けます。長い会話で文脈が自動で圧縮されたあとは、各スキルの先頭5,000トークン(合計25,000トークンまで)だけが引き継がれるため、大事な指示はSKILL.mdの先頭近くに書くのがコツです。
SKILL.mdの書き方:frontmatterの項目一覧と本文のコツ
frontmatterの項目はすべて省略できます。公式が推奨しているのは description だけで、省略すると本文の最初の行が説明として使われます。項目名はハイフン区切りの小文字で、表に無い項目はエラーにならず無視されます(綴りを間違えても気づきにくいので注意してください)。2026年10月14日時点の公式ドキュメントに載っている項目は次のとおりです。
| 項目 | 役割 |
|---|---|
name |
コマンド名(/メニューに出る名前)。省略するとフォルダ名 |
description |
何をするか・いつ使うか。Claudeが使うかどうかを判断する材料(推奨)。省略すると本文の最初の行 |
when_to_use |
呼び出す場面の補足(言い回しの例など)。descriptionと合わせて1,536文字まで一覧に載ります |
argument-hint |
入力補完に出す引数のヒント(例:[issue-number]) |
arguments |
名前付き引数の一覧。本文で $名前 として使えます |
disable-model-invocation |
trueにするとClaudeは自動で使いません(/名前 で自分だけが呼ぶ) |
user-invocable |
falseにすると/メニューから消え、Claudeだけが使います |
allowed-tools |
このスキルを呼んだターン中、確認なしで使えるツール(例:Bash(git diff *)) |
disallowed-tools |
このスキルの実行中に使わせないツール |
model |
このスキルの実行中だけ使うモデル(/model と同じ値) |
effort |
このスキルの実行中の思考の深さ(low〜max) |
context |
forkにするとサブエージェントとして別の文脈で実行 |
agent |
context: fork のときに使うサブエージェントの種類(Explore・Planなど) |
background |
context: fork のとき、falseにすると結果を待ちます(既定は背景で実行) |
hooks |
スキルを呼んだときに登録するフック |
paths |
一致するファイルを触っているときだけ自動で使う(globパターン) |
shell |
!`コマンド` を動かすシェル(bash・powershell) |
metadata |
自分のツールで読むための自由な項目 |
license / compatibility |
Agent Skills仕様の項目。Claude Codeは受け付けますが動作には影響しません |
claude.aiにアップロードして使うスキル(Cowork・クラウドのセッション・Skills API)では、Agent Skills仕様の6項目(name・description・license・compatibility・metadata・allowed-tools)だけが使えます。argument-hint などを書くとアップロード時にエラーになるので、両方で使うスキルはこの6項目に絞ります。
本文のコツ:短く書き、詳しい資料は別ファイルに
- SKILL.mdは500行以内に収めます。詳しい仕様や例は同じフォルダの
reference.md・examples.mdに分け、SKILL.mdには「どのファイルに何があるか」を書いておきます。Claudeは必要なときだけそのファイルを読みます。 - スクリプトは
scripts/に置きます。本文からは${CLAUDE_SKILL_DIR}/scripts/run.shのように参照し、allowed-toolsに同じパスを書いておけば確認なしで実行できます。 - 「なぜ」より「何をするか」を書きます。読み込まれた本文は会話に残り続けるので、1行ごとにトークンがかかります。
- 毎回必ず守らせたい決まりは
hooks(フック)に置きます。スキルの文章はClaudeが途中で守らなくなることがありますが、フックは出来事のたびに必ず実行されます。
応用:コマンドの出力を差し込む・サブエージェントで動かす
本文に !`コマンド` と書くと、スキルを呼んだ時点でそのコマンドが実行され、出力に置き換わります(複数行は ```! のコードブロック)。また、frontmatterに context: fork を付けると、スキルをサブエージェントとして別の文脈で実行できます。サブエージェントは会話の履歴を見ないので、必要なことはすべてSKILL.mdに書きます。次は、GitHub CLIでPRの差分を取り込み、Exploreエージェントで要約する公式の例です。
---
name: pr-summary
description: プルリクエストの変更内容を要約する
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---
## プルリクエストの情報
- 差分: !`gh pr diff`
- コメント: !`gh pr view --comments`
- 変更ファイル: !`gh pr diff --name-only`
## やること
このプルリクエストを要約してください…
descriptionの書き方:悪い例と良い例
スキルが自動で使われるかどうかは、ほぼ description の書き方で決まります。Claudeは会話の内容をdescriptionと照らして使うかどうかを判断するので、「何をするか」と「どんな場面で使うか」の両方を、利用者が実際に口にする言葉で書きます。公式ドキュメントは、キーワードを入れること、そして重要な使いどころを先頭に書くことを勧めています(description と when_to_use を合わせた文章は、一覧では1,536文字で切られます)。
| description | どうなるか | |
|---|---|---|
| 悪い例 | gitを扱うスキル | 何をするのか・いつ使うのかが分からず、「変更を確認して」と頼んでも自動では選ばれにくくなります |
| 悪い例 | 高度なコード解析を実現する多機能なスキル | 機能の宣伝だけで、利用者の言葉(要約・リスク・コミット前)が入っていません |
| 良い例 | コミット前の変更内容を要約し、リスクがあれば指摘する。「何を変えた?」「変更を確認して」「コミットメッセージを考えて」と頼まれたときに使う。 | 何をするか(要約とリスクの指摘)と、使う場面(頼まれ方の例)が入っています。この記事の作り方で使ったスキルのdescriptionです |
| 良い例 | CSVファイルの件数と合計を集計し、報告文を作る。「CSVを集計して」「売上データをまとめて」と頼まれたときに使う。 | 用途と、利用者が言いそうな言葉が入っています(実装例の章のスキル) |
うまく自動で選ばれないときは、①descriptionに利用者が実際に言いそうな言葉が入っているか、②「使えるスキルは?(What skills are available?)」と聞いて一覧に出ているか、③/スキル名 で直接呼べるか、の順に確かめます。反対に、呼ばれすぎるときはdescriptionをより具体的にするか、disable-model-invocation: true にして自分で呼ぶ形にします。
SKILL.mdの実装例:スクリプトを同梱した公式のスキルを全文で読む
前の章では、SKILL.mdだけで完結するスキルを作りました。実務で使うスキルは、決まった処理をスクリプトに任せる形が多くなります。ここでは公式ドキュメントが載せている「コードベースの可視化(codebase-visualizer)」を例に、フォルダ構成とSKILL.mdの全文を読みます(2026年10月20日に公式ドキュメントで確認)。
まずフォルダ構成です。scripts/ の中のPythonファイルは、公式の例ではフォルダを走査して codebase-map.html を作る処理を担います。
~/.claude/skills/codebase-visualizer/
├── SKILL.md
└── scripts/
└── visualize.py
次がSKILL.mdの全文です。公式ドキュメントでは ~/.claude/skills/codebase-visualizer/SKILL.md に保存する例として載っています(本文は公式の英語のまま掲載します)。
---
name: codebase-visualizer
description: Generate an interactive collapsible tree visualization of your codebase. Use when exploring a new repo, understanding project structure, or identifying large files.
allowed-tools: Bash(python3 *)
---
# Codebase Visualizer
Generate an interactive HTML tree view that shows your project's file structure with collapsible directories.
## Usage
Run the visualization script from your project root:
```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .
```
This creates `codebase-map.html` in the current directory and opens it in your default browser.
## What the visualization shows
- **Collapsible directories**: Click folders to expand/collapse
- **File sizes**: Displayed next to each file
- **Colors**: Different colors for different file types
- **Directory totals**: Shows aggregate size of each folder
読みどころは4つです。
- description に「使う場面」まで書いてあります。「新しいリポジトリを調べるとき」「大きなファイルを見つけたいとき」という場面が入っているので、会話の内容が合えば自動で選ばれます。
- allowed-tools を
Bash(python3 *)に絞っています。このスキルを呼んだターンでは、python3 の実行だけが確認なしで動きます。 - スクリプトの場所は
${CLAUDE_SKILL_DIR}で書きます。どのフォルダで作業していても、スキル自身のフォルダを指せます。 - スクリプトの中身はSKILL.mdに載せません。公式のフォルダ構成の説明でも、補助スクリプトは「実行されるもので、読み込まれるものではない」とされています。長い処理を足しても、毎回の文脈(コンテキスト)を圧迫しません。
詳しい資料は別ファイルに分ける
API仕様や使用例が長くなるときは、同じフォルダに reference.md や examples.md を置き、スクリプトは scripts/ に入れます。
SKILL.mdの側には、どのファイルに何があるかだけを書いておきます。必要になったときに、Claude Codeがそのファイルを読みに行きます。
## Additional resources
- For complete API details, see [reference.md](reference.md)
- For usage examples, see [examples.md](examples.md)
日々の使い方:場面ごとの操作
スキルを作ったあとに使う操作を、場面別にまとめます。いずれもこの記事の前半で説明した内容です。
| 場面 | 操作 | 補足 |
|---|---|---|
| 追加したスキルが見えているか確かめる | 入力欄に / と打つ |
候補にスキル名と description の説明が出ます |
| 読み込まれているスキルの一覧とトークン量を見る | /skills |
出どころ(プロジェクト・プラグイン・claude.aiから同期)つきで並びます |
| 自分でスキルを呼ぶ | /スキル名 引数 |
引数は本文の $ARGUMENTS に入ります |
| 自動で使われたくない | disable-model-invocation: true |
自分が呼んだときだけ動きます |
| SKILL.mdを編集した | 保存する | フォルダが監視されているため、そのセッション中に反映されます |
| プラグインに入っているスキルを呼ぶ | /プラグイン名:スキル名 |
次の章で説明します |
質問しながら進め、集計はスクリプトに任せるスキルの例
次は公式の例ではなく、この記事のために書いた例です。使っている項目は、前の表の description・disable-model-invocation・allowed-tools・argument-hint と $ARGUMENTS だけです。「STEP1で質問→STEP2で処理→STEP3で結果によって分ける」という順を、SKILL.mdの見出しで書いています。
~/.claude/skills/csv-report/
├── SKILL.md
└── scripts/
└── summarize_csv.py
---
name: csv-report
description: CSVファイルの件数と合計を集計し、報告文を作る。「CSVを集計して」「売上データをまとめて」と頼まれたときに使う。
disable-model-invocation: true
allowed-tools: Bash(python3 ${CLAUDE_SKILL_DIR}/scripts/summarize_csv.py *)
argument-hint: [csv-file]
---
# CSVの集計レポート
## STEP1 対象の確認
$ARGUMENTS が空のときは、集計するCSVのパスを質問し、答えを待つ。
## STEP2 集計
次のコマンドを実行する。
```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/summarize_csv.py $ARGUMENTS
```
## STEP3 結果の扱い
- 「データがありません」と出たら、ファイルが空であることを伝えて終了する。
- 合計が出たら、列ごとの合計を3行以内の報告文にまとめる。
集計の処理は scripts/summarize_csv.py に分けました。判断はSKILL.mdの指示、数える処理はスクリプトという分担にすると、数え間違いが減り、SKILL.mdも短く保てます。
#!/usr/bin/env python3
"""CSVファイルの行数・列名・数値列の合計を表示する。"""
import csv
import sys
path = sys.argv[1]
with open(path, newline="", encoding="utf-8") as f:
rows = list(csv.DictReader(f))
print(f"行数: {len(rows)}")
print("列: " + ", ".join(rows[0].keys()) if rows else "データがありません")
for col in (rows[0].keys() if rows else []):
try:
total = sum(float(r[col]) for r in rows)
except ValueError:
continue
print(f"{col} の合計: {total:g}")
このスクリプトは、この端末で2行のCSVに実行し、「行数: 2」と「amount の合計: 2000」が出ること、空のCSVで「データがありません」と出ることを確認しました(スキルとして呼び出す部分は、使う環境で試してください)。
事務職の業務に使う例:議事録・提案書・問い合わせ返信
スキルはコードを書く人だけのものではありません。「出力の形式」と「分からないときの扱い」を決めておけば、文書づくりにも使えます。次はこの記事のために書いた例で、議事録を決まった形で作るスキルです。
---
name: meeting-minutes
description: 会議のメモから議事録を作る。「議事録にして」「会議メモをまとめて」と頼まれたときに使う。
disable-model-invocation: true
argument-hint: [メモのファイル]
---
$ARGUMENTS のメモを読み、次の形式で議事録を作る。
1. 日時・参加者
2. 決まったこと(箇条書き)
3. 宿題(担当者と期限)
メモに書かれていない情報は補わず、不明な項目は「未記載」と書く。
| 業務 | SKILL.mdに書くこと | 書いておくと防げること |
|---|---|---|
| 議事録 | 項目の順(日時・参加者・決定事項・宿題)、宿題には担当者と期限 | メモにない発言や日付を補ってしまう |
| 提案書 | 章立て、1章あたりの長さ、必ず入れる項目(目的・費用・スケジュール) | 毎回違う構成になる |
| 問い合わせ返信 | 文面の口調、送ってはいけない情報、判断に迷うときは下書きにとどめる指示 | 確認なしでの送信、口調のばらつき |
カスタムコマンド・サブエージェント・MCP・Claude Skills(claude.ai)との違い
Claude Codeには似た拡張の仕組みがいくつかあります。役割の違いを押さえておくと、「何をスキルにすべきか」が決めやすくなります。
| 仕組み(定義する場所) | 役割 | 向いていること |
|---|---|---|
Skills.claude/skills/名前/SKILL.md |
手順や知識を、必要なときだけ読み込ませる | 繰り返す作業の手順化・チームの決まりごと |
カスタムコマンド(旧形式).claude/commands/名前.md |
スキルと同じ(統合済み。補助ファイルと name・paths が使えない) | 既存のコマンド。新規はスキルで |
サブエージェント.claude/agents/名前.md |
独立した文脈で動く専門のAI。ツールやモデルを個別に設定 | 調査や並列作業を本体の文脈から切り離す |
MCP.mcp.json など |
外部ツール・サービスとの接続 | DB・SaaS・ブラウザなど外部との連携 |
| プラグイン プラグインのフォルダ |
スキル・エージェント・フック・MCPをひとまとめに配布 | チームや公開向けの配布 |
フックsettings.json や SKILL.md の hooks |
出来事のたびに必ず実行される処理 | 必ず守らせたい決まり(保存前の整形など) |
サブエージェントの詳細はClaude Codeのサブエージェント解説、MCPはClaude CodeのMCP解説、コマンドの一覧はスラッシュコマンド解説記事をご覧ください。
「Claude Skills」(claude.aiのスキル)との違いと、つながり方
claude.aiの設定で有効にする「Claude Skills」も、同じSKILL.md形式です。つながり方は、使う場所によって次のように違います(2026年10月23日に公式ドキュメントとヘルプセンターで確認した内容です)。
| 使う場所 | claude.aiで入れたスキル | 自分で置くスキル |
|---|---|---|
| Claude Code(ターミナル・エディタ) | claude.aiのアカウントでサインインしていれば自動で取り込まれます(v2.1.273以降・~/.claude/skills/synced/・手元では読み取り専用)。/<名前> のほか /anthropic-skills:<名前> という正式名でも呼べます |
~/.claude/skills/(個人用)・.claude/skills/(プロジェクト用)・プラグインにファイルで置きます |
| claude.ai・Cowork | 設定で有効にすると使えます(Coworkには作業の開始時に同期されます) | claude.aiの「カスタマイズ」→「Skills」からzipをアップロードします |
| Claude API | 引き継がれません。Skills APIで別にアップロードします | Skills APIにアップロード(ワークスペースのメンバー全員が使えます) |
つまり、「claude.aiで入れたスキルをClaude Codeでも使う」のは自動ですが、「Claude Codeに置いたスキルをclaude.aiで使う」には、zipにしてアップロードする必要があります。ただし、claude.aiにアップロードして使うスキルでは、Agent Skills仕様の6項目(name・description・license・compatibility・metadata・allowed-tools)だけが使えます。両方で使うスキルは、この6項目に絞って書きます(前の章のとおり、Claude Code独自の項目を書くとアップロード時にエラーになります)。同期されたスキルの !`コマンド` は、手元では実行されません。
claude.ai側でスキルを使い始めるには、設定→機能で「クラウドでコードを実行」をオンにし、カスタマイズ→Skillsでスキルをオンにします。自分で作る・アップロードする場合も含め、Free・Pro・Maxの個人プランでも使えます(Team・Enterpriseは組織のオーナーが先に許可します)。claude.ai側の有効化の画面・一覧・パートナー製スキル・組織への配布は、Claude Skillsとは?作り方・一覧・活用例で画面つきで説明しています。この記事は、その中でもClaude Code(ターミナル・エディタ)で使うスキルに絞っています。
Claude Code Skillsの活用例:公式の例と、実務で使われている形
公式ドキュメントに載っている例は、どれも「数行のSKILL.md」で始められるものです。
- コミット作業(commit):
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)を付け、disable-model-invocation: trueで自分が呼んだときだけ動かします。gitの操作に毎回の確認が要らなくなります。 - Issueの修正(fix-issue):
/fix-issue 123のように番号を$ARGUMENTSで受け取り、読む→実装→テスト→コミットの順を本文に書いておきます。 - PRの要約(pr-summary):
!`gh pr diff`で差分を取り込み、context: fork+agent: Exploreで本体の文脈を汚さずに要約します。 - コードベースの可視化(codebase-visualizer):同梱したPythonスクリプトを
${CLAUDE_SKILL_DIR}/scripts/visualize.pyで実行し、フォルダ構成をHTMLの図にします。スクリプトを同梱できるのがスキルの強みです。 - アプリの起動手順の記録(/run-skill-generator):バンドルされたこのスキルを1回実行すると、環境構築から起動までの手順が
.claude/skills/run-名前/に記録され、以後の/run・/verifyがその手順で動きます。 - コミット前の自動チェック:
verifyまたはsimplifyという名前のスキルがあると、Claude Codeはコミットの直前にそれを実行します(v2.1.286以降)。
公共分野の例として、国土交通省のPLATEAUプロジェクトは都市の3Dデータを扱うための「PLATEAU Agent Skills」を公開しています(docs.plateauview.mlit.go.jp)。SKILL.md形式のスキルが組織から配布される形が広がり始めている例です。
作ったスキルを評価する(skill-creator)
スキルが「呼ばれた」ことと「意図どおりに動いた」ことは別です。公式は、同じ依頼をスキルあり・なしの新しいセッションで比べることを勧めています。Anthropic製のプラグイン skill-creator を入れると、この比較を自動で回せます。
/plugin install skill-creator@claude-plugins-official
入れたあとに「summarize-changes スキルを skill-creator で評価して」と頼むと、テストケース(evals/evals.json)の作成、スキルあり・なしの実行、採点、2つの版の比較、descriptionの調整までを対話で進められます。
Claude Code・AIエージェントの業務導入をご検討の方は、自社での開発実例を公開しているクリスタルメソッドの無料相談をご利用ください。
スキルパックとプラグイン:配られているスキルをまとめて入れる・自分で配る
スキルを1つずつフォルダに置く方法のほかに、複数のスキルを1まとまりで配る仕組みがプラグインです。公式ドキュメントでは、プラグインを「スキル・エージェント・フック・MCPサーバーなどを入れたディレクトリを、1つの単位として読み込むもの」と説明しています。プラグインの一覧(カタログ)をマーケットプレイスと呼び、一度追加すると、その中のプラグインを名前で入れられます。2026年10月20日に公式ドキュメントで確認した手順です。
Anthropicが出している3つのマーケットプレイスとスキル集
| 種類 | 名前 | 追加のしかた |
|---|---|---|
| 公式(official) | claude-plugins-official |
初めて対話モードで起動したときに自動で追加されます。Anthropic製のほか、パートナーなどのプラグインも並びます |
| コミュニティ(community) | claude-community |
/plugin marketplace add anthropics/claude-plugins-community。作者がAnthropicに提出した第三者のプラグインです |
| デモ(demo) | claude-code-plugins |
/plugin marketplace add anthropics/claude-code。プラグインの作り方を示す見本です |
| スキル集(anthropics/skills) | anthropic-agent-skills |
/plugin marketplace add anthropics/skills。スキルの公開リポジトリで、document-skills・example-skills・claude-api・academy-guide・discernment-nudge の5つのプラグインがあります(2026年10月27日確認) |
インストールのコマンドは次のとおりです。スキル集のコマンドは、リポジトリ(anthropics/skills)のREADMEに載っているものです。
/plugin install commit-commands@claude-plugins-official
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
セッション中の /plugin install は、すぐには入れずに、そのプラグインの詳細画面を開いて追加されるスキルやフックを確認してから範囲を選ぶ形です。入れたあと、スキルは /commit-commands:commit のように「プラグイン名:スキル名」で呼びます。プラグインのスキルには名前の頭にプラグイン名が付くため、同じ名前のスキルが別々のプラグインにあっても、自分のスキルとぶつかりません。
anthropics/skills のREADMEには、pdf・docx・pptx・xlsx の各スキルが入っていること、多くのスキルがApache 2.0のオープンソースである一方で、これら4つの文書スキルは「ソースは見られるがオープンソースではない」とされていることが書かれています。また、スキルは「デモと学習用」の提供で、重要な作業に使う前に十分に試すよう注意書きがあります。
入れる範囲(スコープ)は3つ
自分用(user)はこの端末のすべてのプロジェクトで、~/.claude/settings.json に記録されます。リポジトリ全員(project)は .claude/settings.json に記録され、コミットして共有します。このリポジトリの自分だけ(local)は .claude/settings.local.json に記録されます。
リポジトリ全員の範囲では、設定をコミットしただけでは各自の端末にプラグインは入りません。各メンバーが一度 claude plugin install 名前@マーケットプレイス名 --scope project を実行する必要があります。ターミナルから入れるときは、claude plugin install を使い、入れたものは claude plugin list で確認できます。
自分のスキルをプラグインにして配る
チームに同じスキルを配りたいときは、スキルをプラグインにまとめます。全体の流れは次の4段階です。
公式の最小の例では、スキル1つだけのプラグインをこう作ります。
my-first-plugin/
├── .claude-plugin/
│ └── plugin.json
└── skills/
└── hello/
└── SKILL.md
マニフェスト(.claude-plugin/plugin.json)では name が必須で、スキルを呼ぶときの接頭辞になります。
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
スキル本体は、これまでのSKILL.mdと同じ書き方です。
---
name: hello
description: Greet the user with a friendly message
disable-model-invocation: true
---
Greet the user warmly and ask how you can help them today.
構成を点検してから、そのセッションだけプラグインを読み込んで呼び出します。
claude plugin validate ./my-first-plugin
claude --plugin-dir ./my-first-plugin
/my-first-plugin:hello
注意点が2つあります。.claude-plugin/ の中に入れるのは plugin.json だけで、skills/ はプラグインのルート直下に置きます(中に置くと読み込まれません)。また、ファイルを編集したら /reload-plugins で反映します。すでに .claude/skills/ にスキルがある場合は、cp -r .claude/skills my-plugin/ でプラグインのフォルダにコピーして移せます。移した後も元のスキルは残るので、動作を確かめてから元を消します。
公開されているスキルパック(第三者)を使うときの見方
Anthropic以外が公開しているスキルパックもあります。次の3つは、各配布元のページの記載にもとづく概要です(2026年10月20日確認)。いずれもAnthropicの審査を受けたものではありません。
| 名前 | 配布元のページの記載 | 入れ方 |
|---|---|---|
| gstack | Garry Tan氏が公開するスキル集(MITライセンス)。企画の見直し(/office-hours)、レビュー(/review)、QA(/qa)、出荷(/ship)など、開発の工程ごとのスキルを備えます | git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack のあと、フォルダ内の setup を実行 |
| Everything Claude Code(ECC) | 個人(affaan-m)が公開する、エージェント・スキル・フックなどの詰め合わせ(MITライセンス)。ページの記載では、エージェント71・スキル311・コマンド97 | /plugin marketplace add https://github.com/affaan-m/ECC のあと /plugin install ecc@ecc |
| skills.sh | Vercelが運営するスキルのディレクトリ。インストール数の順位表や、トピック別の一覧があります | サイトの案内に従う(コマンドは npx skills add <owner/repo> の形) |
第三者のスキルには実際に注意が必要です。セキュリティ企業のSnykは、2026年2月5日の調査で、ClawHubとskills.shの3,984件のスキルを調べました。何らかのセキュリティ上の問題があったのは36.82%(1,467件)、重大な問題を含むのは13.4%(534件)、人の確認で悪意ある内容と確認されたのは76件でした。Snykは、スキルを「ソフトウェアのサプライチェーン」として扱い、入れたスキルを点検するよう勧めています(点検のコマンドとして uvx mcp-scan@latest --skills を挙げています)。
どれも、入れた時点でスキルの description が文脈に常駐し、スキルの中のコマンドは自分の権限で動きます。入れる前に中身(SKILL.md、スクリプト、allowed-tools)を読んでください。公式ドキュメントも、プラグインは「自分の権限でコードを実行できる」ので、知らないマーケットプレイスのものは事前に確認するよう案内しています。数が増えたら、claude plugin details 名前 で毎ターン文脈に足されるトークン量を調べ、/plugin の Installed タブの「Not used recently」にある使っていないプラグインを無効にします。
Claude Code Skillsを使うときの注意点とセキュリティ:外部スキル・権限・トークン
他の人が作ったスキルを使う前は、SKILL.mdを開いて次の3点を確かめます。どれもファイルを読めば分かることです。
- 外部のスキルは
allowed-toolsを先に読みます。リポジトリに入っているプロジェクト用スキルのallowed-toolsは、フォルダを信頼していなくても適用されます。公開リポジトリやコミュニティ配布のスキルを使う前に、どのコマンドに事前許可を与えているかを必ず確認してください。組織で一律に制限したい場合は、管理用の設定allowManagedPermissionRulesOnly(v2.1.282以降)で、スキル側のallowed-toolsを無視させられます。 !`コマンド`はスキルを呼んだ時点で実行されます。中身を読まずに外部スキルを呼ぶと、意図しないコマンドが動くおそれがあります。設定のdisableSkillShellExecutionをtrueにすると、自作・プロジェクト・プラグインのスキルでこの実行を止められます(claude.aiから同期されたスキルでは、設定に関係なくローカルでは実行されません)。- 指示インジェクションへの備え:IPAの「AIセキュリティ短信 2026年3月号」は、AIエージェントへの指示の注入(Prompt Injection)を具体的な脅威として挙げています(IPA、2026年3月)。スキルでは、実行してよいコマンドを
allowed-toolsの許可リストで限定し、外部から来た文章(Issueの本文やWebの内容)をそのまま指示として扱わない書き方にします。Claudeに呼ばせたくないスキルは、/permissionsの拒否ルールSkill(名前)でも止められます。 - 文脈(コンテキスト)のコスト:スキルの名前と説明は毎ターン文脈に入ります。スキルが多いと一覧がモデルの文脈の1%の予算を超え、使う頻度の低いものから説明が落とされます。
/skill-doctor(v2.1.252以降)で各スキルのコストと使用回数を確認し、使っていないものはskillOverridesで"name-only"や"off"にします。 - 事前許可はそのターンだけ:
allowed-toolsの許可は、スキルを呼んだターンが終わる(次のメッセージを送る)と消えます。セッション全体で許可したいツールは、スキルではなく権限の設定に書きます。
スキルが呼ばれないとき・呼ばれすぎるとき
- 呼ばれない:
descriptionに、利用者が実際に言いそうな言葉を入れます。「What skills are available?(使えるスキルは?)」と聞いて読み込まれているかを確かめ、/スキル名で直接呼べるかも試します。frontmatterのYAMLが壊れていると、説明なしで読み込まれて自動では呼ばれません。claude --debugで解析エラーを見るか、claude plugin validate .claude/skills(v2.1.233以降)で壊れたSKILL.mdを探せます。 - 呼ばれすぎる:
descriptionをより具体的にするか、disable-model-invocation: trueにして自分で呼ぶ形にします。 - 途中で指示を守らなくなる:必ず守らせたい決まりはフックに移します。会話が圧縮されたあとは、スキルをもう一度呼び出すと本文全体が戻ります。
- 個人用のスキルが消えた:
~/.claude/skills/.trash/に移っていることがあります。既定では30日後に削除されるので、その前にフォルダを戻します。
Claude Codeの権限の考え方はClaude Codeのセキュリティ解説を、全体像はClaude Codeとはを、初めての方ははじめてのClaude Codeもあわせてご覧ください。
スキルの置き場所の選び方と、「作るべきか」の見極め
ここまでの内容から、迷いやすい2つの判断を整理します。どちらも、公式ドキュメントに書かれた仕様から導ける基準です。
置き場所の選び方:「誰が使うか」と「どこで使うか」で決める
| 迷う場面 | 置く場所 | 理由(仕様) |
|---|---|---|
| チームの決まった手順(テストの回し方・リリース手順など) | プロジェクト用(.claude/skills/) |
コミットすればリポジトリを開いた全員が同じ手順を使えます。どの端末でも同じ内容が再現されます |
| 自分の文章の癖・報告の型など、どの仕事でも使うもの | 個人用(~/.claude/skills/) |
そのパソコンのすべてのプロジェクトで効きます。端末ごとに別のファイルなので、複数の端末で使うときは内容を揃える手間が出ます |
| claude.aiとClaude Codeの両方で同じスキルを使いたい | claude.aiで有効にする | サインインしたClaude Codeに自動で取り込まれます(手元では読み取り専用) |
| 同じ手順を複数のリポジトリへ配りたい | プラグイン | マーケットプレイスから入れられ、バージョン管理もできます(前の章) |
| 組織の全員に強制したい | 管理設定(Enterprise) | 管理者が配布するフォルダのスキルは、組織の全員に読み込まれ、優先順位も最上位です |
同じ名前のスキルが複数の場所にあるときは「組織用 → 個人用 → プロジェクト用」の順に優先されます。迷ったら、まずプロジェクト用に置き、複数のプロジェクトで同じものが必要になった時点で個人用かプラグインへ移すと、端末ごとのずれを避けられます。
スキルにするか、CLAUDE.mdに書くか
公式ドキュメントは、スキルを作るタイミングを2つ挙げています。「同じ指示・チェックリスト・複数ステップの手順を、何度もチャットに貼り付けているとき」と、「CLAUDE.mdの一部が、事実ではなく手順に育ってきたとき」です。CLAUDE.mdの内容は毎回読み込まれますが、スキルの本文は使われたときだけ読み込まれるため、長い参照資料もスキルにしておけば、必要になるまでほとんど文脈を使いません。反対に、「このリポジトリはpnpmを使う」のような常に守らせたい短い事実は、CLAUDE.mdに置きます。
- 作りどき:同じ手順を何度も頼んでいて、手順が安定してきたとき。一度きりの作業は、スキルにしても保守の手間が勝ちます。
- 書き換えたら:スキルのファイルはセッション中の編集が自動で反映されます(セッション開始後に
.claude/skills/フォルダ自体を新しく作った場合だけ/reload-skills)。/skillsで一覧に出ているかを確認します。 - 増やしすぎない:スキルの名前と説明は毎ターン文脈に入ります。
/skill-doctorで使っていないスキルを見つけ、skillOverridesで"name-only"や"off"にして整理します。
よくある質問
Q. Claude Code Skillsとは何ですか?
A. Claude Codeに追加する手順書です。SKILL.mdというMarkdownファイル1つに「いつ使うか(description)」と「何をどう進めるか」を書き、.claude/skills/スキル名/ に置きます。Claudeが会話に合わせて自動で読み込むほか、/スキル名 で直接呼び出せます。本文は呼び出されたときだけ読み込まれます。
Q. カスタムコマンド(スラッシュコマンド)との違いは何ですか?
A. 以前の .claude/commands/ のカスタムコマンドはスキルに統合され、同じ frontmatter が使えます。古い形式も動きますが、新しく作るならスキルが推奨です。スキルは参照資料やスクリプトを同じフォルダに同梱でき、name と paths の項目も使えます。
Q. Skillsはどこに置きますか?
A. チームで共有するならプロジェクトの .claude/skills/スキル名/SKILL.md、自分のパソコン全体で使うなら ~/.claude/skills/スキル名/SKILL.md です。ほかにプラグイン・組織の管理設定・–add-dir のフォルダ・claude.aiアカウントからの同期があります。
Q. Claudeに勝手に実行させたくないときは?
A. frontmatterに disable-model-invocation: true を書くと、Claudeは自動で使わず、あなたが /スキル名 で呼んだときだけ動きます。デプロイやメッセージ送信のような作業に向いています。
Q. 使えるスキルの一覧はどう確認しますか?
A. /skills で読み込まれているスキルの一覧とトークン数を確認できます。入力欄に / と打つと、コマンドとスキルの候補が説明つきで表示されます。
Q. Anthropicが公開している公式のスキルには何がありますか?
A. GitHubのanthropics/skillsに19個あります(2026年10月27日時点)。Word・Excel・PowerPoint・PDFの4つ(document-skills)、デザインや社内文書・開発・スキル作りの12個(example-skills)、claude-api・academy-guide・discernment-nudge の3つが別のプラグインです。/plugin marketplace add anthropics/skills で登録し、/plugin install でプラグインごとに入れます。リポジトリは「デモと学習用」とされているので、重要な作業に使う前に試してください。
Q. Claude Codeに最初から入っているスキルは何ですか?
A. /doctor(セットアップの点検)・/code-review・/simplify・/debug・/batch・/loop・/claude-api・/run・/verify・/run-skill-generator などです。呼び方は自分で作ったスキルと同じで、/ に続けて名前を入力します。まとめて止めたいときは設定の disableBundledSkills を使います。
Q. Claude Code Skillsは無料で使えますか?
A. スキルはClaude Codeの機能で、スキルだけの追加料金は公式ドキュメントに記載がありません。ただしClaude Code自体を使うには、Claudeのサブスクリプション(Pro・Max・Team・Enterprise)かClaude Consoleのアカウント(APIの従量課金)などが必要です(公式のクイックスタートによる)。自分で作るスキルも、Anthropicの公開スキル(Apache 2.0など)も、使うのはこの枠の中です。料金の詳細は料金解説記事をご覧ください。
Q. スキルとCLAUDE.mdはどう使い分けますか?
A. CLAUDE.mdは毎回読み込まれる常時の決まり、スキルは使われたときだけ本文を読み込む手順書です。同じ手順を何度もチャットに貼っているときや、CLAUDE.mdの一部が事実でなく手順に育ってきたときは、スキルに移すのが公式の目安です。
Q. claude.aiで作ったスキルはClaude Codeでも使えますか?
A. 使えます。claude.aiのアカウントでサインインしたターミナルのセッションでは、claude.aiで有効にしたスキルが ~/.claude/skills/synced/ に自動で同期されます(Claude Code v2.1.273以降)。ただし同期されたスキルの !`コマンド` はローカルでは実行されません。
Q. サブエージェントやMCPとの使い分けは?
A. 外部ツールやデータへの接続はMCP、独立した文脈での並列作業はサブエージェント、繰り返す手順や知識の共有はSkillsが基本です。スキルに context: fork を付ければ、スキルをサブエージェントとして動かすこともできます。
Q. スキルパック(プラグイン)はどう入れますか?
A. プラグインのマーケットプレイスを追加し、/plugin install プラグイン名@マーケットプレイス名 を実行します。公式のマーケットプレイス(claude-plugins-official)は初回起動時に自動で追加されます。Anthropicのスキル集は /plugin marketplace add anthropics/skills で追加し、document-skills@anthropic-agent-skills などを入れます(プラグインは5つあります)。入れたスキルは「/プラグイン名:スキル名」で呼びます。
Q. プラグインのスキルは、自分のスキルと名前がぶつかりませんか?
A. ぶつかりません。プラグインのスキルは名前の頭にプラグイン名が付くため、同じ名前のスキルが自分のフォルダやほかのプラグインにあっても、両方が読み込まれます。
まとめ
Claude Code Skillsは、Claude Codeに「自分たちの手順」を覚えさせる仕組みです。この記事で確認した要点を整理します(出典:code.claude.com/docs/en/skills)。
- スキルの実体は SKILL.md 1つ。プロジェクト共有は
.claude/skills/スキル名/、個人用は~/.claude/skills/スキル名/に置き、再起動なしで使えます。 - frontmatterはすべて省略可能で、推奨は
descriptionだけ。disable-model-invocation・user-invocable・allowed-tools・context: forkなどで、呼び方と動き方を細かく決められます。 - 本文は呼び出されたときだけ読み込まれ、常に読み込まれるCLAUDE.mdよりトークン効率がよい設計です。一覧と表示の切り替えは
/skills、コストの確認は/skill-doctor。 - 外部スキルは
allowed-toolsと!`コマンド`を読んでから使います。必ず守らせたい決まりはフックに置きます。 - 以前のカスタムコマンドはスキルに統合されました。claude.aiのスキルも同じ形式で、サインインしたClaude Codeに同期されます。
- 使えるスキルは、最初から入っている同梱スキルと、Anthropicが公開している19個(プラグインで入れる)、自分やチームで作るスキルの3種類です。公開スキルは中身を読んでから入れます。
まずは「毎回同じ手順で頼んでいる作業」を1つ選び、この記事の「作り方」のとおりにSKILL.mdを1枚書いてみてください。導入のコストはClaude Codeの料金解説記事を、活用の幅はClaude Codeでできること・活用事例をあわせてご覧ください。
参考文献
- Extend Claude with skills(Claude Code公式ドキュメント・英語)
https://code.claude.com/docs/en/skills - Claude をスキルで拡張する(Claude Code公式ドキュメント・日本語)
https://code.claude.com/docs/ja/skills - Claude Code Sub-agents 公式ドキュメント
https://code.claude.com/docs/en/sub-agents - Claude Code MCP 公式ドキュメント
https://code.claude.com/docs/en/mcp - Claude Code Commands reference 公式ドキュメント
https://code.claude.com/docs/en/commands - Create a Claude Code plugin(公式ドキュメント・英語)
https://code.claude.com/docs/en/plugins/create - Install and manage plugins(公式ドキュメント・英語)
https://code.claude.com/docs/en/plugins/install - Anthropic’s marketplaces(公式ドキュメント・英語)
https://code.claude.com/docs/en/plugins/anthropic-marketplaces - anthropics/skills(Anthropicの公開リポジトリ)
https://github.com/anthropics/skills - gstack(配布元リポジトリ)
https://github.com/garrytan/gstack - Everything Claude Code(配布元リポジトリ)
https://github.com/affaan-m/everything-claude-code - skills.sh(Vercel)
https://skills.sh - ToxicSkills(Snyk、2026年2月5日)
https://snyk.io/blog/toxicskills-malicious-ai-agent-skills-clawhub - Commands reference(Claude Code公式ドキュメント・英語・同梱スキルの説明)https://code.claude.com/docs/en/commands
- Agent Skills 仕様
https://agentskills.io - PLATEAU Agent Skills概要(国土交通省)
https://docs.plateauview.mlit.go.jp/skills/overview/ - AIセキュリティ短信 2026年3月号(IPA)
https://www.ipa.go.jp/digital/ai/security/rcu1hd0000007gji-att/2-1_202603.pdf
この記事の仕様・コマンド・項目名は、2026年10月27日(プラグインとスキルの共有の章は10月20日、claude.aiとの関係の表は10月23日)に上記の公式ドキュメントで確認した内容です。
関連記事
- Claude Skillsとは?作り方・一覧・活用例(claude.ai側のスキル)
- Claude Codeとは
- Claude Codeでできること・活用事例
- Claude Codeで自動化・定期実行する方法
- Claude CodeのメモリとCLAUDE.md活用
- Claude Codeのベストプラクティス
Claude Code・AIエージェントの業務活用をご検討の方へ
クリスタルメソッドは、Claude Codeを日々の業務で使いながら、AIエージェント・社員AIの導入と開発効率化を支援しています。自社サイトの表示速度をAI社員(Claude Code)で12.89秒→2.03秒に短縮した実例も事例記事として公開しています。「自社の開発・業務にAIをどう組み込むか」といったご相談を承っています。
- 無料相談・お問い合わせ:ご相談はこちら
- サービスの内容:Claude Code導入支援(AI社員)
Read next
あわせて読みたい
-
Claude Codeのサブエージェントとは?仕組み・作り方・設定・使い方をわかりやすく解説【2026年版】
Claude Codeのサブエージェントとは Claude Codeのサブエージェントとは、メインの会話から特定の作業を任される、専用の文脈(コンテキスト)を持...
-
Claude Codeを拡張するコマンド|/plugin /deep-research /claude-api ほか【2026年版】
監修 河合 継(クリスタルメソッド株式会社 代表取締役) AI・ディープラーニングに関する特許16件の発明者。過去、国立がん研究センターとの共同研究や、テレビ番...
-
Claude Code Agentとは?サブエージェント・Agent Teams・Agent Viewの違いと使い方【2026年版】
Claude Code Agentとは?エージェント機能の全体像 Claude Code Agent(エージェント機能)とは、Claude Codeが作業の一部...