Claude Skillsとは？設定からSKILL.md作成まで手順解説
「Claude Skills」を活用してタスクを自動化したいが、具体的な設定方法やSKILL.mdの書き方が分からず悩んでいませんか？
本記事では、Claudeの能力を拡張する「Skills」の基本概念から、実用的なセットアップ手順、環境別の実行方法までをステップバイステップで解説します。
競合情報では曖昧だったファイル構成やコード記述例も網羅しているため、記事を読みながら操作するだけで、あなたの環境でもClaude Skillsを再現・実行できるようになります。
AIエージェント・AIシステム開発ならKAGEMUSHA！
株式会社KAGEMUSHAが提供する自律型AIエージェントは、定型業務の自動化から複雑なタスク進行まで、一連の業務フローをAIが主体的に遂行します。
社内データを統合した高い業務理解度と、現場オペレーションに合わせた柔軟なカスタマイズが強みです。
導入直後から成果が見える運用設計も特徴で、「何から自動化できるのか」を資料で詳しく解説しています。こちらのバナーから無料でダウンロードしてください。
Claude Skillsとは？基本概念と仕組み
Claude Skillsは、AIアシスタントであるClaudeに対して、特定のタスクを実行するための「専門的な手順」や「能力」を外付けで追加する機能です。
まずはその仕組みと、既存機能との違いを理解しましょう。
タスク特化型の拡張機能「Claude Skills」の概要
Claude Skillsは、特定の文脈やタスクが発生した際にのみ動的にロードされる拡張機能です。
通常、Claudeは広範な知識を持っていますが、特定の社内ルールに基づいたコードレビューや、独自のフォーマットに従ったレポート作成など、個別具体的な作業手順までは知りません。
Skillsを使用すると、以下のような動作が可能になります。
- 動的な読み込み：ユーザーが「レポートを作成して」と依頼した時だけ、関連する「レポート作成スキル」をメモリに読み込みます。
- 手順の標準化：誰が指示しても、定義された手順（Skill）に従って同じ品質の成果物を出力します。
- 外部ツール連携：必要に応じてスクリプトを実行したり、特定のファイルを参照したりする権限を付与できます。
常時参照設定（CLAUDE.md）とSkillsの違い
Claudeの開発環境では、プロジェクトのルールを定義するCLAUDE.mdというファイルがよく利用されますが、Skillsとは役割が異なります。
それぞれの特徴は以下の通りです。
- CLAUDE.md（常時参照）
- 役割：コーディング規約やプロジェクトの基本方針など、常に意識すべきルール。
- 挙動：会話の開始時に常にコンテキストとして読み込まれます。
- デメリット：情報量が増えるとコンテキストウィンドウ（メモリ）を圧迫し、動作が重くなったりコストが増加したりします。
- Claude Skills（オンデマンド）
- 役割：特定のタスク（例：バグ調査、ドキュメント生成）に必要な手順書。
- 挙動：必要な時だけ呼び出され、タスク完了後はメモリから解放されることもあります。
- メリット：コンテキストの節約になり、大量のスキルを登録しても基本性能に影響を与えません。
Skillsは必要な時だけ読み込まれるため、メモリ消費を抑えつつ高度なタスクを実行できる点が最大の特徴です。
Skillsを構成するファイル構造（SKILL.mdとBundled files）
Skillsは基本的にフォルダ単位で管理され、以下の要素で構成されます。
- スキルディレクトリ：スキルごとに作成するフォルダ（例：
skills/code-review/）。 - SKILL.md：スキルの定義ファイル。YAML形式のメタデータ（名前や説明）と、Markdown形式の指示書で構成されます。
- Bundled files（参照ファイル）：スキル実行時に参照するスクリプトやテンプレートファイル。
SKILL.mdから直接呼び出すことができます。
この構造により、複雑なタスクも一つのパッケージとして管理・配布することが可能です。
利用に向けた事前準備・環境セットアップ
実際にSkillsを作成・利用するための環境を構築します。ここではClaude Desktopアプリと、開発者向けのSDK環境の両方を解説します。
Claudeアカウントの準備とAPIキーの取得
Skillsを利用するには、Anthropicのアカウントが必要です。
- アカウント作成：Anthropic公式サイトにアクセスし、アカウントを作成します。
- Consoleへのアクセス：開発者向けコンソール（Console）にログインします。
- API Keyの発行：
- ダッシュボードの「Get API Keys」をクリックします。
- 「Create Key」を選択し、名前（例：
my-skills-env）を付けてキーを発行します。 - 表示されたキー（
sk-ant-...）をコピーし、安全な場所に保管してください。
※ 有料のProプランやTeamプラン、またはAPIクレジットが必要になる場合があります。残高を確認しておきましょう。
Claude Desktopアプリの導入とSkills設定の有効化
GUIで手軽にSkillsを利用する場合、公式のDesktopアプリを使用します。
- アプリのダウンロード：Anthropic公式サイトから、OS（macOS/Windows）に合わせたインストーラーをダウンロードし、インストールします。
- ログイン：アプリを起動し、アカウントでログインします。
- 機能の有効化：
- 画面左下のユーザーアイコンをクリックし、「Settings」を開きます。
- 「Beta」または「Features」タブを確認し、「Skills」や「Developer Mode」に関連する項目があればONにします（バージョンによりUIが異なる場合があります）。
- 設定変更後、アプリを再起動してください。
【開発者向け】Anthropic SDK・Claude Codeの導入
PythonなどのプログラムからSkillsを呼び出す場合、SDKのセットアップが必要です。
1. Python環境の確認
ターミナルで python --version を実行し、Python 3.7以上がインストールされていることを確認します。
2. ライブラリのインストール
以下のコマンドを実行し、Anthropicの公式ライブラリをインストールします。
pip install anthropic3. 環境変数の設定
取得したAPIキーを環境変数に設定します。
export ANTHROPIC_API_KEY='your-api-key-here'（Windowsの場合は set ANTHROPIC_API_KEY=your-api-key-here）
APIキーは「sk-ant-」から始まる文字列です。他人に共有せず安全に保管してください。
【実践】カスタムClaude Skillsの作成手順
環境が整ったら、実際に独自のスキルを作成してみましょう。ここでは例として「コードレビュー用スキル」を作成します。
Skills用ディレクトリの作成と配置ルール
Skillsは特定のディレクトリに配置することで認識されます。
1. プロジェクトルートへの配置
作業中のプロジェクトフォルダ直下に .claude/skills または skills というフォルダを作成します。
mkdir -p .claude/skills/code-reviewer2. フォルダの役割code-reviewer フォルダの中に、このスキル専用のファイルをすべて格納します。
SKILL.mdの記述テンプレート（YAML + Markdown）
スキルの核となる SKILL.md を作成します。以下のテンプレートをコピーして、code-reviewer フォルダ内に保存してください。
ファイル名: .claude/skills/code-reviewer/SKILL.md
---
name: Code Reviewer
description: Pythonコードの品質チェックとリファクタリング提案を行うスキル
version: 1.0.0
triggers:
- コードレビュー
- リファクタリング
- バグチェック
---
# Code Reviewer 指示書
あなたはシニアPythonエンジニアとして振る舞ってください。
ユーザーから提供されたコードに対して、以下の観点でレビューを行ってください。
1. **可読性**: PEP8に準拠しているか
2. **安全性**: セキュリティリスクがないか
3. **パフォーマンス**: 計算量は適切か
## 出力フォーマット
- 指摘箇所: [行番号]
- 問題点: [説明]
- 修正案: [コードブロック]
レビュー完了後、修正案を適用したコード全体を提示してください。YAML Frontmatter（上部の --- で囲まれた部分）の解説：
name：スキルの表示名。description：スキルの概要。Claudeがいつこのスキルを使うべきか判断する材料になります。triggers：このスキルを呼び出すきっかけとなるキーワード。
参照ファイル（Bundled files）の作成と連携記述
スキル内で特定のガイドラインやテンプレートを参照させたい場合、同じフォルダにファイルを置き、SKILL.md からリンクします。
1. 参照ファイルの作成
同じフォルダに guidelines.txt を作成します。
【社内規定】
- 変数名はスネークケースを使用すること
- 関数には必ずDocstringを記述すること2. SKILL.mdへの追記SKILL.md の指示部分に以下のように記述します。
レビューの際は、以下の社内規定を厳守してください：
![[guidelines.txt]]この ![[filename]] 構文により、スキル実行時にファイルの中身が自動的に展開され、Claudeに読み込まれます。
「Skills作成スキル」を使った自動生成テクニック
手動での記述に慣れてきたら、Claude自身にスキルを作らせるのが効率的です。以下のプロンプトをClaudeに入力してください。
プロンプト例：
「新しいClaude Skillを作成したいです。目的は『会議議事録の要約』です。必要なYAMLメタデータと、Markdown形式の指示書を含む SKILL.md のテンプレートを生成してください。また、フォーマットを指定するための参照ファイル template.md の例も併せて作成してください。」
これにより、構文エラーのない正確なテンプレートを素早く入手できます。
環境別・Skillsの実行と呼び出し方法
作成したスキルを実際に使用する手順を解説します。
Claude Desktopでの利用：自動ロードと対話操作
Desktopアプリでは、配置したスキルが自動的に認識されます。
- チャットの開始：新しいチャットを開きます。
- トリガーの発火：
SKILL.mdのtriggersに設定したキーワードを含めて指示を出します。
例：「このPythonスクリプトのコードレビューをお願いします」 - 動作確認：Claudeが「Code Reviewerスキルを使用します」といった応答（またはアイコン表示）を行い、定義された手順に従って回答を生成すれば成功です。
※ UI上で「Available Skills」などの一覧から手動選択できる場合もあります。
Anthropic SDKでの利用：コードによる呼び出し実装
Pythonコードからスキルを利用する場合、APIリクエスト時にスキル定義を含めるか、ツールとして指定します。以下は概念的な実装例です。
import anthropic
client = anthropic.Anthropic()
# スキル定義（実際にはファイルを読み込んで構成します）
skills_def = [
{
"name": "Code Reviewer",
"description": "Pythonコードの品質チェックを行う",
"input_schema": { ... } # 必要に応じて定義
}
]
response = client.messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=1024,
messages=[
{"role": "user", "content": "このコードをレビューして: print('hello')"}
],
# 環境やライブラリのバージョンにより指定方法が異なる場合があります
# 一般的にはtools引数やsystemプロンプトでスキルを注入します
# ここでは構成案に基づきskills引数をイメージとして記述します
# skills=skills_def
)
print(response.content)※ 注意：SDKのバージョンにより、Skillsは「Tools (MCP)」として実装する場合と、独自のラッパーを経由する場合があります。基本的には SKILL.md の内容を System Prompt に変換して注入するか、Toolsとして定義して渡す処理が必要です。
スキルが反応しない場合の確認ポイント
スキルが意図通りに動かない場合は以下を確認してください。
- ログの確認：Desktopアプリのログや、SDKのレスポンスログを確認し、エラーが出ていないか見ます。
- トリガーの具体性：プロンプトにトリガーキーワード（例：「コードレビュー」）が明確に含まれているか確認します。
- パスの確認：
.claude/skillsフォルダが正しい位置にあるか、ファイル名がSKILL.md（大文字）になっているか再確認してください。
スキルが反応しない時は、プロンプトに「トリガーキーワード」が含まれているか再確認しましょう。
【法人向け】現場で使える実践型AI研修！
株式会社KAGEMUSHAのAI研修は、現場業務に直結する実践型カリキュラムで、AI活用を「知識」で終わらせず「使えるスキル」として定着させます。
DX担当者・現場メンバーそれぞれのレベルに合わせ、生成AI・業務自動化・AIエージェント活用まで幅広く対応。
対面からオンライン・eラーニングと幅広い研修形式に対応しており、内製化や業務改善につながる設計が強みです。
研修内容・導入事例・カリキュラム詳細は、こちらのAI研修資料でご確認ください。
よくあるエラーと失敗しないための注意点
最後に、Skills運用時によく発生するトラブルとその回避策を紹介します。
YAML構文エラーとインデントの修正
SKILL.md が読み込まれない最大の原因は、先頭のYAML Frontmatterの記述ミスです。
- インデント：YAMLはインデント（スペース）に敏感です。タブを使わず、半角スペース2つで統一してください。
- 区切り線：必ずファイルの先頭とYAMLの終わりに
---を記述してください。 - コロン：キーと値の間には必ず半角スペースを入れてください（例:
name: Code Reviewer）。
YAMLの記述ミスはエラーの元です。インデントにはタブを使わず、半角スペース2つを使用してください。
コンテキストウィンドウ圧迫の回避策
大量のSkillsを作成し、それらをすべて一度に読み込もうとすると、Claudeのコンテキストウィンドウ（記憶容量）を圧迫します。
これを防ぐには、プログレッシブディスクロージャ（段階的開示）の考え方が有効です。
すべてのスキル詳細を最初から読み込ませるのではなく、最初は「スキル名と概要」だけをClaudeに認識させます。Claudeが「このスキルが必要だ」と判断した段階で、初めて SKILL.md の中身（詳細な指示）をロードするように設計・実装するのがベストプラクティスです。
Team/Enterpriseプラン利用時の管理者権限
組織（Team/Enterpriseプラン）でClaudeを利用している場合、管理者がセキュリティポリシーにより「Custom Skills」や「Beta Features」の使用を制限していることがあります。
設定画面にSkillsの項目が表示されない場合は、組織の管理者に問い合わせ、機能の有効化（Allowlistへの追加など）を依頼してください。
まとめ
Claude Skillsは、Claudeを単なるチャットボットから「特定の業務に特化したアシスタント」へと進化させる強力な機能です。
- 基本構造：
SKILL.md（YAML+Markdown）と参照ファイルで構成されます。 - セットアップ：Desktopアプリの設定有効化や、SDKの導入が必要です。
- 作成のコツ：フォルダで管理し、
![[filename]]構文で外部ファイルを取り込むことで、メンテナンス性を高められます。
まずは、よく行う定型業務（日報作成やコードチェックなど）を一つ選び、本記事の手順に沿って SKILL.md を作成してみてください。一度設定すれば、次回からは自動的にその手順が適用され、業務効率が劇的に向上します。
【法人向け】現場で使える実践型AI研修！
株式会社KAGEMUSHAのAI研修は、現場業務に直結する実践型カリキュラムで、AI活用を「知識」で終わらせず「使えるスキル」として定着させます。
DX担当者・現場メンバーそれぞれのレベルに合わせ、生成AI・業務自動化・AIエージェント活用まで幅広く対応。
対面からオンライン・eラーニングと幅広い研修形式に対応しており、内製化や業務改善につながる設計が強みです。
研修内容・導入事例・カリキュラム詳細は、こちらのAI研修資料でご確認ください。
バズコネのおすすめ投稿
この記事が気に入ったら
フォローしてね！
