【Claude Code】Agent Skills完全ガイド - Progressive Disclosureで効率的な知識注入を実現

Agent Skillsは、Claude Codeで必要なタイミングに自動的に専門知識を読み込む機能です。新入社員へのオンボーディングガイドのように、指示・スクリプト・リソースをパッケージ化し、関連タスクで自動的に発動します。

この記事では、Agent Skillsの仕組み、他機能との違い、実践的な活用例、ベストプラクティスを解説します。

Agent Skillsが解決する課題

LLMはステートレスであり、トークン制約の中で動作します。新しいセッションを開始すると、Claudeは以前の指示を保持していません。

Skillsは**Progressive Disclosure（段階的開示）**によってこの課題を解決します。必要な情報を必要なタイミングでのみ読み込むことで、コンテキストを効率的に使用します。

Progressive Disclosure（3段階の情報読み込み）

Skillsは3段階で情報を読み込みます。

他機能との違い

Claude Codeには似た機能がいくつかあります。それぞれの役割を理解しましょう。

機能	目的
CLAUDE.md	プロジェクトコンテキスト
Commands	手動ショートカット
Hooks	自動イベントトリガー
Subagents	独立した専門プロセス
Skills	コンテキスト共有の知識注入

Skills vs Subagents

実践的な活用例

セキュリティレビュースキル

「セキュリティレビュー」という言葉がトリガーになり、OWASP API Security Top 10チェックリストや言語固有の脆弱性情報を自動的に読み込みます。

# セキュリティレビュースキル

## 説明
コードのセキュリティレビューを実行します。

## 手順
1. OWASP Top 10に基づく脆弱性チェック
2. 言語固有のセキュリティパターン確認
3. 認証・認可の実装確認
4. 入力検証の確認

ビルド＆テストスキル

標準化されたシーケンスを実行します。

QAチェックスキル（Progressive Disclosure活用）

バックエンド、フロントエンド、インフラの基準を別ファイルで管理し、関連する基準のみを読み込みます。

skills/
└── qa-check/
    ├── SKILL.md           # メインのスキル定義
    ├── backend.md         # バックエンド基準
    ├── frontend.md        # フロントエンド基準
    └── infrastructure.md  # インフラ基準

ビルトインスキル

Anthropicが提供する公式スキルがあります。

スキル	機能
PowerPoint (pptx)	プレゼンテーション作成
Excel (xlsx)	スプレッドシート分析
Word (docx)	ドキュメント編集
PDF (pdf)	生成とフォーム入力

ベストプラクティス

自由度の設定例

実際の課題と対策

Skillsには以下のような課題があります。

定義ファイルの複雑さ

50以上のSkillsがあると、LLMの選択判断が不透明になり管理が困難になります。

説明文のチューニング

適切なトリガー言語を見つけるには試行錯誤が必要です。

デバッグの不透明さ

なぜSkillが選択された/されなかったかを直接観察できません。

スキルの競合

似た説明文があると、予測不可能なスキル選択が起こる可能性があります。

「作る、試す、直す」メソッド

完璧を追求するのではなく、反復的なアプローチを推奨します。

はじめ方

カスタムスキルの作成

mkdir -p ~/.claude/skills/hello-skill

~/.claude/skills/hello-skill/SKILL.mdを作成：

---
description: 挨拶をカスタマイズするスキル
---

# Hello Skill

ユーザーに挨拶するときは、必ず「こんにちは！」から始めてください。

コミュニティの例を探索

awesome-claude-skillsでコミュニティが作成したスキルを参照できます。

まとめ

Agent Skillsは、プロンプトエンジニアリングからワークフローエンジニアリングへのパラダイムシフトを表しています。

従来のアプローチ	Skillsのアプローチ
個々のプロンプトを最適化	組織の知識をパッケージ化
毎回同じ説明を繰り返す	再利用可能なスキルとして共有
セッションごとにリセット	時間とともに進化

Progressive Disclosureによる効率的な知識管理で、Claude Codeをより効果的に活用しましょう。

参考文献

• Claude Code Agent Skills Configuration Guide - はてなブログ
• Claude Code 公式ドキュメント - Skills
• awesome-claude-skills - GitHub