「Claude Code Skillsって何ですか」と聞かれて、うまく答えられなかった方は多いのではないでしょうか。SkillsはClaude Codeに搭載されている機能のひとつで、簡単に言えば「Claudeに専用の作業手順書を持たせる仕組み」です。
この記事では、Anthropic公式ドキュメント(Claude Code Docs、Claude Platform Docs)で確認できた情報だけをもとに、Skillsとは何か、何ができるか、どう使うかを非エンジニア向けにわかりやすく解説します。なお、本記事で扱うclaudecode道場(claudedojo.com)は、Anthropic公式の製品ではなく、malna株式会社が独自に提供する学習サービスです。この点をあらかじめご了承ください。
目次
- Skillsとは何か
- Skillsで何ができるようになるか(具体例)
- 基本的な使い方
- 非エンジニアにとって役立つ活用シーン
- 注意点
- よくある質問(FAQ)
- まとめ
1. Skillsとは何か
公式の定義
Anthropicの公式ドキュメント(Claude Platform Docs「Agent Skills」)によると、Agent Skillsは次のように説明されています。
Agent Skills are modular capabilities that extend Claude's functionality. Each Skill packages instructions, metadata, and optional resources (scripts, templates) that Claude uses automatically when relevant.
(訳:Agent Skillsは、Claudeの機能を拡張するモジュール式の能力です。各Skillは、指示・メタデータ・任意のリソース(スクリプトやテンプレート)をひとまとめにしたもので、Claudeは関連性があるときに自動的にこれを使用します。)
出典:Agent Skills - Claude Platform Docs
つまりSkillsとは、「特定の作業をどう進めるべきか」という手順・知識・チェックリストをファイルとしてまとめておき、Claudeが必要な場面で自動的に読み込んで活用する仕組みです。
社内で言えば、新入社員に渡す「業務マニュアル」に近いイメージです。マニュアルがあれば、担当者が変わっても同じ品質で業務が回ります。Skillsは、それをClaudeに渡すための仕組みだと考えるとわかりやすいでしょう。
CLAUDE.mdとの違い
Claude Codeを使ったことがある方は「CLAUDE.md」というプロジェクト設定ファイルをご存知かもしれません。公式ドキュメント(Claude Code Docs「Extend Claude with skills」)では、この違いについて次のように説明されています。
Create a skill when you keep pasting the same instructions, checklist, or multi-step procedure into chat, or when a section of CLAUDE.md has grown into a procedure rather than a fact. Unlike CLAUDE.md content, a skill's body loads only when it's used, so long reference material costs almost nothing until you need it.
(訳:同じ指示・チェックリスト・複数ステップの手順を何度もチャットに貼り付けている場合、あるいはCLAUDE.mdの一節が単なる事実ではなく手順にまで育ってきた場合は、Skillを作るタイミングです。CLAUDE.mdの内容と異なり、Skillの本文は使われるときにだけ読み込まれるため、長い参考資料であっても、必要になるまではほとんどコストがかかりません。)
出典:Extend Claude with skills - Claude Code Docs
CLAUDE.mdは会話の最初から常に読み込まれる「基本情報」、Skillsは必要なときだけ呼び出される「専門知識の引き出し」というイメージで区別すると理解しやすくなります。
仕組み(段階的な読み込み)
公式ドキュメントでは、Skillsが「段階的開示(progressive disclosure)」という仕組みで動くと説明されています。具体的には次の3段階です(出典:Claude Platform Docs「Agent Skills」)。
| 段階 | 読み込まれるタイミング | 内容 |
|---|---|---|
| レベル1:メタデータ | 常時(起動時) | Skillの名前と説明文のみ |
| レベル2:本文の指示 | Skillが呼び出されたとき | SKILL.mdの手順・ガイダンス |
| レベル3:付属資料・コード | 必要になったとき | 参考ファイル・実行スクリプトなど |
この仕組みにより、Skillsをいくつ用意していても、実際に使われるまではごくわずかなコスト(トークン消費)しかかからないとされています。
2. Skillsで何ができるようになるか(具体例)
公式ドキュメントで紹介されている例をもとに、Skillsがどんな場面で役立つかを見てみましょう。
例1:Gitの変更差分を要約するSkill
公式のチュートリアルでは、「未コミットの変更内容を要約し、リスクがあれば指摘する」というSkillの作成例が紹介されています(出典:Claude Code Docs「Extend Claude with skills」)。このSkillを用意しておけば、「今回何を変更した?」と聞くだけで、Claudeが変更点の要約とリスク指摘を自動で行ってくれます。
例2:PDF・Excel・Word・PowerPointの操作
Anthropicは、PDF処理、Excel(xlsx)、Word(docx)、PowerPoint(pptx)を扱うための「あらかじめ用意されたAgent Skills(Pre-built Agent Skills)」を提供しています。これらはClaude APIやclaude.aiで利用可能です(出典:Claude Platform Docs「Agent Skills」)。
なお、この事前構築版のSkillsは、Claude Code上では利用できません。Claude Code向けには、オープンソースで公開されている「Claude APIスキル」が同梱されている、と公式ドキュメントに明記されています。
例3:社内独自の業務ルールを反映させる
Skillsは自分で作成することもできます。たとえば「請求書の記載ルール」「デプロイ前のチェックリスト」「コードレビューの観点」といった、自社・自分だけの業務ルールをSkillとして作成し、Claudeに繰り返し正確に実行させることができます。
3. 基本的な使い方
Skillの保存場所
Claude Codeでは、Skillsはファイルとして保存され、保存場所によって適用範囲が変わります(出典:Claude Code Docs「Extend Claude with skills」)。
| 保存場所 | パス | 適用範囲 |
|---|---|---|
| 個人用(パーソナル) | ~/.claude/skills/<スキル名>/SKILL.md | 自分が使うすべてのプロジェクト |
| プロジェクト用 | .claude/skills/<スキル名>/SKILL.md | そのプロジェクトのみ |
| プラグイン経由 | <プラグイン>/skills/<スキル名>/SKILL.md | プラグインが有効な範囲 |
| エンタープライズ(組織管理) | 管理設定ファイル内 | 組織内の全ユーザー |
非エンジニアの方がまず触るのは「個人用」か「プロジェクト用」になるでしょう。個人用は自分のパソコン全体で使える設定、プロジェクト用は特定のフォルダ(プロジェクト)だけで使える設定、という違いです。
作成の基本手順
公式ドキュメントの手順に沿うと、大まかな流れは次のとおりです。
- Skill用のフォルダを作成する(例:
summarize-changesという名前のフォルダ) - その中に
SKILL.mdというファイルを作成する - ファイルの先頭に、Skillの名前や説明を書いた「YAMLフロントマター」という設定部分を書く
- その下に、Claudeに実行してほしい手順を通常の文章(Markdown)で書く
SKILL.mdの基本構造は次のようになります(出典:Claude Platform Docs「Agent Skills」)。
---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---
# Your Skill Name
## Instructions
(Claudeに実行してほしい手順を具体的に書く)
## Examples
(具体的な使用例)
name(名前)とdescription(説明)は、公式ドキュメントで「必須フィールド」と明記されています。特にdescriptionは、Claudeが「このSkillをいつ使うべきか」を判断するための重要な情報になるため、「何をするSkillか」と「いつ使うべきか」の両方を書く必要があるとされています。
呼び出し方法
作成したSkillは、次の2通りの方法で使えます(出典:Claude Code Docs「Extend Claude with skills」)。
- 自動で呼び出される:ユーザーの依頼内容がSkillの説明文(description)と一致すると判断した場合、Claudeが自動的にそのSkillを読み込んで実行します
- 手動で呼び出す:
/スキル名という形式で直接指定して実行することもできます
つまり、いちいち「あのSkillを使って」と指示しなくても、Claudeが文脈から判断して自動的に適用してくれる場合があります。逆に、確実に決まった手順を実行させたい場合は、コマンドのように直接呼び出すことも可能です。
4. 非エンジニアにとって役立つ活用シーン
Skillsは本来プログラミングの知識がなくても作成・利用できる仕組みです。非エンジニアの業務での活用が考えられる場面としては、次のようなものが挙げられます。ここから先は公式ドキュメントに直接の記載があるわけではなく、Skillsの仕組みから考えられる活用例(推論)として提示します。
- 定型文書の作成ルールの統一:議事録・提案書・報告書のフォーマットや書き方のルールをSkillにまとめておけば、担当者が変わっても同じ品質で文書が作成できると考えられます
- 繰り返し行うチェック作業の手順化:契約書の確認観点、SNS投稿前のチェックリストなど、毎回同じ確認をする作業をSkillとして手順化できる可能性があります
- 社内特有の言い回し・ルールの徹底:「この言葉は使わない」「この順番で報告する」といった社内ルールを、毎回説明し直す手間を減らせると考えられます
これらは仕組み上可能と考えられる活用例であり、実際の効果は業務内容や運用方法によって異なります。導入を検討する際は、まず小さな範囲で試すことをおすすめします。
5. 注意点
Skillsを利用する際は、公式ドキュメントが明記しているセキュリティ上の注意点を必ず確認してください。
信頼できる提供元のSkillsのみを使う
公式ドキュメントには、次のように明記されています(出典:Claude Platform Docs「Agent Skills」)。
Use Skills only from trusted sources: those you created yourself or obtained from Anthropic. Skills give Claude new capabilities through instructions and code, which also means a malicious Skill can direct Claude to invoke tools or execute code in ways that don't match the Skill's stated purpose.
(訳:Skillsは信頼できる提供元、つまり自分自身が作成したもの、またはAnthropicから入手したもののみを使用してください。Skillsは指示とコードを通じてClaudeに新しい能力を与えるものであるため、悪意のあるSkillは、そのSkillが表向き主張している目的とは異なる形で、ツールの呼び出しやコードの実行をClaudeに指示する可能性があります。)
出所が不明なSkillsを安易にインストールすることは避け、社内で共有する際も、内容を必ず確認したうえで使用することが推奨されます。
提供範囲は場所ごとに独立している
公式ドキュメントによると、claude.aiにアップロードしたカスタムSkills、Claude APIにアップロードしたカスタムSkills、Claude Codeのファイルベースのカスタムskillsは、それぞれ独立しており自動的には同期されません。ある場所で作ったSkillを別の場所でも使いたい場合は、それぞれの場所で個別に用意する必要があります。
データの取り扱い
公式ドキュメントには「Agent SkillsはZDR(ゼロデータ保持)の対象外であり、Skillの定義や実行データはAnthropicの標準的なデータ保持ポリシーに従って保持される」と明記されています。機密情報や個人情報を含む内容をSkillに書き込む場合は、この点をふまえて慎重に判断する必要があります。
動作環境による制約
Claude Codeで使うSkillsは、ユーザーのパソコン上の他のプログラムと同じレベルのネットワークアクセス権を持つ、と公式ドキュメントに記載されています。一方でClaude APIで使うSkillsは、ネットワークアクセスができないサンドボックス環境で動作するなど、利用する製品によって制約が異なります。
6. よくある質問(FAQ)
Q. SkillsはClaude Codeだけの機能ですか?
A. いいえ。公式ドキュメントによると、Agent SkillsはClaude Code、Claude API、claude.aiのそれぞれで利用できます。ただし、各製品でのSkillsの管理方法(アップロード方法や共有範囲)は異なり、自動的には同期されません。
Q. プログラミングの知識がなくてもSkillsは作れますか?
A. SKILL.mdの作成自体は、Markdown形式の文章とシンプルな設定(YAMLフロントマター)を書くだけなので、プログラミング未経験でも作成できる仕組みです。ただし、スクリプト(実行可能なプログラム)を組み込む高度な使い方をする場合は、別途知識が必要になります。
Q. Skillsを使うと追加料金がかかりますか?
A. Skillsの利用そのものに独立した追加料金があるかどうかは、本記事執筆時点で公式ドキュメントから明確に確認できませんでした。Claude Codeのプラン・料金体系については、契約中のプランの公式情報を確認してください(未確認)。
Q. claudecode道場でSkillsについて学べますか?
A. claudecode道場はAnthropic公式の製品ではなく、malna株式会社が独自に提供するClaude Code学習サービスです。Skillsを含むClaude Codeの活用方法について、非エンジニア向けにわかりやすい学習コンテンツを提供しています。
7. まとめ
- Skillsとは、Claudeに「いつ・どう動くべきか」という手順や知識をファイルとして持たせ、必要な場面で自動的に使わせる公式機能です(出典:Anthropic公式ドキュメント)
- CLAUDE.mdが常時読み込まれる基本情報であるのに対し、Skillsは必要なときにだけ読み込まれる点が異なります
- Claude Codeでは、
~/.claude/skills/(個人用)または.claude/skills/(プロジェクト用)にSKILL.mdファイルを置くことで作成でき、nameとdescriptionが必須の設定項目です - 呼び出し方は、Claudeが自動判断する方法と、
/スキル名で手動指定する方法の2通りがあります - 信頼できる提供元のSkillsのみを使うこと、データ保持ポリシーの対象であること、利用製品によって動作環境の制約が異なることには注意が必要です
Skillsは、プログラミングの知識がなくても、日々の業務ルールをAIに正しく理解させるための実用的な仕組みです。まずは自分が繰り返している定型作業をひとつ選び、小さなSkillとして試してみることから始めてみてはいかがでしょうか。


