最終更新: 2025年10月20日
はじめに
Claude Skillsは、AnthropicのClaude AIに特定の専門知識や手順を組み込むための革新的なシステムです。本ガイドでは、Claude Skillsの仕組みから実践的なカスタムスキルの作成方法まで、開発者向けに詳しく解説します。
Claude Skillsとは
Claude Skillsは、以下の3つのコア機能を提供します:
- 専門知識の統合: 特定分野の手順、ベストプラクティス、ガイドラインをClaudeに組み込み
- 反復作業の効率化: 繰り返し使用する指示をスキルとして保存し、毎回のプロンプト入力を削減
- 一貫性の確保: 標準化されたワークフローにより、タスク実行の品質を維持
Progressive Disclosure アーキテクチャ
Claude Skillsの最大の特徴は、Progressive Disclosure（段階的開示）アーキテクチャです。これは、トークン効率を最大化しながら、実質的に無制限のコンテキストを提供する革新的なアプローチです。
仕組みの3段階
Step 1: Initial Context（初期コンテキスト）
ユーザーのプロンプトが送信されると、Claudeは全スキルの概要（name、description、location）のみを受け取ります。これは数百バイト程度の軽量な情報です。
Step 2: Skill Discovery（スキル発見）
Claudeはプロンプトとスキルのdescriptionを照合し、関連性のあるスキルを特定します。該当スキルがあれば、そのSKILL.mdファイル全体を読み込みます。
Step 3: Execution（実行）
読み込んだスキルの指示に従って、file_readツールで追加リソースを取得しながらタスクを実行します。
Progressive Disclosureのメリット
- トークン効率: 必要なスキルのみを読み込むため、不要なトークン消費を回避
- スケーラビリティ: 数百のスキルを管理しても、初期ロードは数KB程度
- 柔軟性: スキル数に実質的な制限がない
- パフォーマンス: 初期レスポンスが高速
スキルのディレクトリ構造
Claude Skillsは、ファイルシステムベースで管理されます。スキルは以下のディレクトリ構造に配置されます:
/mnt/skills/ ├─ public/ # Anthropic提供の公式スキル │ ├─ docx/ # Word文書作成・編集 │ ├─ pptx/ # PowerPoint作成・編集 │ ├─ xlsx/ # Excel作成・編集 │ └─ pdf/ # PDF操作 ├─ user/ # ユーザー作成のカスタムスキル │ └─ my-skill/ │ ├─ SKILL.md │ └─ resources/ └─ examples/ # サンプル・テンプレートスキル └─ skill-creator/
SKILL.mdファイルの構造
スキルの核となるファイルはSKILL.mdです。このファイルは、YAMLフロントマターとMarkdown本文で構成されます。
YAMLフロントマター（必須）
--- name: my-custom-skill description: > このスキルの簡潔な説明を200文字以内で記述。 Claudeがスキルを発見するための重要な要素。 license: MIT ---
必須フィールド
- name: スキルの一意な識別子（64文字以内、英数字とハイフンのみ）
- description: スキル発見用の説明（200文字以内）。これが最も重要な要素です
オプショナルフィールド
- license: ライセンス情報（例: MIT, Apache-2.0）
Markdown本文
YAMLフロントマターの後に、スキルの詳細な指示をMarkdown形式で記述します。推奨される構成:
- 目的セクション: スキルの目的を明確に説明
- 使用方法セクション: ステップバイステップの詳細な指示
- 例セクション: 入力と出力のペアを3-5個提供
- ベストプラクティス: 推奨事項や注意点
カスタムスキルの作成方法
カスタムスキルを作成する方法は2つあります: 会話型作成と手動作成です。
方法1: 会話型作成（推奨）
Claudeと対話しながらスキルを作成する最も簡単な方法です。
手順
- Claudeに「新しいスキルを作成したい」と伝える
- スキルの目的と使用シナリオを説明
- Claudeが
skill-creatorスキルを使用して、SKILL.mdファイルを自動生成 - 生成されたスキルをレビューし、必要に応じて修正
- /mnt/skills/user/配下に配置
会話例
ユーザー: ブランドガイドラインに従って一貫したデザインを作成するスキルを作りたいです。 Claude: かしこまりました。ブランドガイドラインスキルを作成します。 以下の情報を教えてください: 1. 適用するブランドカラー 2. 使用するフォント 3. デザインの制約事項 [Claudeがskill-creatorを使用してSKILL.mdを生成]
方法2: 手動作成
テキストエディタで直接SKILL.mdファイルを作成します。
ステップバイステップ手順
Step 1: ディレクトリ作成
mkdir -p /mnt/skills/user/my-skill cd /mnt/skills/user/my-skill
Step 2: SKILL.mdファイル作成
--- name: data-analyzer description: > データ分析とビジュアライゼーションを実行するスキル。 CSV、Excel、JSONファイルを読み込み、統計分析と グラフ作成を行います。 license: MIT --- # データ分析スキル ## 目的 このスキルは、構造化データの分析とビジュアライゼーションを 自動化します。 ## 使用方法 ### ステップ1: データ読み込み まず、file_readツールを使用してデータファイルを読み込みます。 ### ステップ2: データ分析 pandasを使用して基本的な統計分析を実行します。 ### ステップ3: ビジュアライゼーション matplotlibまたはseabornでグラフを作成します。 ## 例 <example> ユーザー: sales.csvを分析して売上トレンドを可視化してください Claude: [データ読み込み → 分析 → グラフ作成] </example>
Step 3: リソースファイル追加（オプション）
テンプレートや設定ファイルが必要な場合は、同じディレクトリに配置します。
my-skill/ ├─ SKILL.md ├─ templates/ │ └─ report_template.html └─ config/ └─ default_settings.yaml
Step 4: スキルのテスト
Claudeに以下のように指示してスキルをテストします:
「data-analyzerスキルを使用して、このCSVファイルを分析してください」
実装例: 5つの実践的なスキル
例1: ブランドガイドラインスキル
企業のブランドガイドラインを適用し、一貫したビジュアルコンテンツを作成するスキル。
--- name: brand-guidelines description: > 企業ブランドガイドラインに従って一貫したデザインと コンテンツを作成。カラーパレット、フォント、 トーン、ビジュアルスタイルを適用します。 --- # ブランドガイドライン適用スキル ## ブランド要素 ### カラーパレット - プライマリ: #1E40AF（ブルー） - セカンダリ: #7C3AED（パープル） - アクセント: #F59E0B（オレンジ） ### フォント - 見出し: Montserrat Bold - 本文: Inter Regular ### トーンとボイス - プロフェッショナルかつフレンドリー - 技術的だが親しみやすい - 簡潔で明確 ## 使用方法 すべてのビジュアルコンテンツ、プレゼンテーション、 ドキュメントにこれらの要素を適用します。
例2: PDFフォーム処理スキル
PDFフォームの入力を自動化するスキル。
--- name: pdf-form-filler description: > PDFフォームを自動入力するスキル。構造化データから フィールドをマッピングし、バッチ処理をサポート。 --- # PDFフォーム自動入力スキル ## 処理フロー 1. PDFフォームの読み込み 2. フィールド名の抽出 3. データソースとのマッピング 4. 一括入力処理 5. 完成したPDFの出力 ## 例 <example> ユーザー: employee_data.csvのデータを使って employment_form.pdfを埋めてください Claude: [PDFスキルを読み込み → フォーム解析 → データマッピング → 入力実行] </example>
例3: データ分析・可視化スキル
--- name: data-viz description: > データ分析とビジュアライゼーションの実行。 統計分析、トレンド検出、インタラクティブな グラフ作成をサポート。 --- # データ可視化スキル ## サポートするファイル形式 - CSV - Excel (.xlsx, .xls) - JSON - Parquet ## 分析機能 - 記述統計 - 相関分析 - トレンド検出 - 外れ値検出 ## ビジュアライゼーション - 折れ線グラフ - 棒グラフ - 散布図 - ヒートマップ - ボックスプロット
例4: Webテスト自動化スキル
--- name: web-testing description: > Webアプリケーションの自動テストを実行。 E2Eテスト、UIテスト、パフォーマンステストを Playwrightを使用して実装。 --- # Webテスト自動化スキル ## テストタイプ 1. 機能テスト 2. UIテスト 3. パフォーマンステスト 4. アクセシビリティテスト ## 使用ツール - Playwright - pytest - Lighthouse ## ワークフロー 1. テストシナリオの定義 2. テストコードの生成 3. テスト実行 4. レポート作成
例5: 財務分析スキル
--- name: financial-analysis description: > 財務諸表の分析と予測。収益性、流動性、 効率性の指標計算と可視化。 --- # 財務分析スキル ## 分析指標 ### 収益性 - ROE（自己資本利益率） - ROA（総資産利益率） - 売上高利益率 ### 流動性 - 流動比率 - 当座比率 - 現金比率 ### 効率性 - 総資産回転率 - 在庫回転率 - 売掛金回転率 ## 出力形式 - エグゼクティブサマリー - 詳細分析レポート - ビジュアルダッシュボード
ベストプラクティスと最適化
1. Description の最適化
descriptionはスキル発見の最重要要素です。以下のポイントを押さえましょう:
- 具体的なキーワード: ユーザーが使いそうな言葉を含める
- 明確な機能説明: 何ができるかを簡潔に
- 使用条件: いつ使うべきかを示唆
良い例
description: "PowerPointプレゼンテーションの作成と編集。スライドレイアウト、 グラフ、画像の挿入をサポート。ビジネス、教育、マーケティング用途に対応。"
悪い例
description: "プレゼンテーションツール"
2. スキルのサイズ管理
- 500行以内を推奨: 長すぎるとトークン効率が低下
- モジュール化: 大きな機能は複数のスキルに分割
- リソースの外部化: テンプレートや設定は別ファイルに
3. 明確な指示の記述
- 曖昧さの排除: 具体的で明確な指示を記述
- 段階的な手順: 複雑なタスクはステップに分解
- エッジケースの考慮: 例外的な状況への対処を明記
4. 豊富な例の提供
- 3-5個の例: 様々なユースケースをカバー
- 入出力ペア: ユーザー入力とClaude出力の両方を示す
- 実践的なシナリオ: 実際の使用状況を反映
5. スキルの構成
効果的なスキル構成の例:
- 概要 (50-100語): スキルの目的と主要機能
- 前提条件: 必要なツールや依存関係
- 使用方法 (200-400語): 詳細な手順
- 例 (3-5個): 多様なユースケース
- ベストプラクティス: 推奨事項
- トラブルシューティング: よくある問題と解決策
トラブルシューティングとデバッグ
よくある問題と解決策
問題1: Claudeがスキルを使用しない
原因:
- descriptionが曖昧すぎる
- 関連するキーワードが不足
- ユーザーのプロンプトとスキルの関連性が低い
解決策:
- descriptionをより具体的で明確に書き換える
- ユーザーが使いそうな言葉を含める
- スキルの使用条件を明示
問題2: スキルが読み込まれない
原因:
- YAMLフロントマターの構文エラー
- ファイルパスが正しくない
- 必須フィールド（name、description）の欠落
解決策:
- YAML構文を検証（インデント、クオート等）
- ファイルパスを確認
- 必須フィールドが存在することを確認
問題3: スキルの動作が不安定
原因:
- 指示が曖昧
- エラーハンドリングの不足
- リソースファイルへのパスが相対的
解決策:
- より明確で具体的な指示に改善
- エラーケースへの対処を追加
- 絶対パスまたはfile_readを使用
デバッグテクニック
- 段階的テスト: 小さな変更ごとにテスト
- ログの確認: Claudeの応答から問題箇所を特定
- 最小限の例: 問題を再現する最小のケースを作成
- バージョン管理: 動作する版を保持して変更を追跡
技術仕様とガイドライン
制約と制限
| 要素 | 制約 | 理由 |
|---|---|---|
| name | 64文字以内 | システム識別子の制限 |
| description | 200文字以内 | トークン効率 |
| リクエストあたりスキル数 | 最大8 | パフォーマンス維持 |
| スキルアップロードサイズ | 最大8MB | ストレージ制限 |
| SKILL.md推奨サイズ | 500行以内 | 読み込み効率 |
セキュリティとプライバシー
- 機密情報の保護: APIキーやパスワードをスキルに含めない
- アクセス制御: user/ディレクトリのスキルは自分のみアクセス可能
- データの暗号化: 機密データは暗号化して保存
Anthropic提供の公式スキル
Claude Skillsには、以下の公式Document Skillsが含まれています:
xlsxスキル
Excel スプレッドシート作成・編集・分析。数式、書式設定、データビジュアライゼーションをサポート。
pptxスキル
PowerPoint プレゼンテーション作成・編集・分析。レイアウト、コメント、スピーカーノートに対応。
docxスキル
Word ドキュメント作成・編集・分析。変更履歴、コメント、書式保持をサポート。
pdfスキル
PDF操作（テキスト抽出、テーブル抽出、フォーム処理、結合・分割）。
参考リソース
公式ドキュメント
- Claude Skills概要: https://support.claude.com/en/articles/12512176-what-are-skills
- カスタムスキル作成: https://support.claude.com/en/articles/12512198-how-to-create-custom-skills
- ベストプラクティス: https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices
- API ドキュメント: https://docs.claude.com/en/api/skills-guide
GitHubリポジトリ
- 公式スキル例: https://github.com/anthropics/skills
- Agent Skills仕様: https://github.com/anthropics/skills/blob/main/agent_skills_spec.md
- コミュニティスキル集: https://github.com/BehiSecc/awesome-claude-skills
まとめ
Claude Skillsは、Progressive Disclosureアーキテクチャを採用した革新的なシステムで、トークン効率を維持しながら実質的に無制限のコンテキストをClaudeに提供します。ファイルシステムベースの設計により、Markdownファイルとスクリプトを使用した簡単なスキル作成が可能で、エンタープライズからパーソナルユースまで幅広い用途に対応します。
成功のための5つの鍵
- 明確なdescription: スキル発見の最重要要素
- 簡潔な指示: トークンを節約し、性能向上（500行以内）
- 段階的開発: 小さく始めて拡張
- 実際のテスト: 仮想シナリオでなく実タスクで検証
- 継続的改善: 使用パターンから学習し反復
Claude Skillsを活用することで、組織の手続き的知識とコンテキストをClaude AIと共有し、繰り返しのプロンプト入力を削減し、一貫性のある高品質な結果を得ることができます。本ガイドのベストプラクティスに従い、効率的で安全な、実用的なカスタムスキルを開発してください。
