Claude Code: Agent Skills と skill-creator
最終更新:2026-08-31
Agent Skills は Claude Code の「専門スキルパック」です — Skill をインストールすれば、Claude Code は完全な専門ワークフローを獲得します。
💡 ヒント: Skills はシンプルなプロンプトテンプレートではなく、ステップ、チェックリスト、出力形式、検証ロジックを含む完全なワークフロー定義です。skill-creator でこれらのスキルをカスタマイズできます。
📋 前提条件: 第15章 - メモリシステム
1. 学ぶ内容
- Agent Skills の概念とアーキテクチャ
- 内蔵およびコミュニティ Skills
- Skills の使用例
- skill-creator によるカスタム Skills の作成
- Skills のベストプラクティス
2. Agent Skills の概念
(1) Skill とは
| コンポーネント | 説明 |
|---|---|
| トリガー条件 | どのタスクがこの Skill をアクティブにするか |
| 作業ステップ | 順序付きの実行ステップ |
| チェックポイント | 各ステップ後の検証チェックリスト |
| 出力形式 | 最終出力の標準形式 |
| ツール依存 | どのツールが必要か |
(2) Skill と通常の指示の比較
| 次元 | 通常の指示 | Skill |
|---|---|---|
| 構造 | 自由テキスト | 構造化ワークフロー |
| 完全性 | ステップを見落とす可能性 | チェックポイントが完全性を保証 |
| 一貫性 | 毎回異なる可能性 | 毎回同じフロー |
| 再利用性 | 一回限り | プロジェクト間で再利用可能 |
| 検証 | 自動検証なし | 内蔵検証チェック |
▶ 例1:Skill と通常の指示の比較
TEXT
📖 参照専用
# 通常の指示
> Review this file's code quality
[自由形式のレビュー、側面を見落とす可能性]
# Skill を使用
> /skill code-review
[code-review Skill の構造化フローに従う]
Step 1: ファイル読み取り ✓
Step 2: セキュリティチェック ✓(SQL インジェクション、XSS、機密データ露出)
Step 3: パフォーマンスチェック ✓(N+1 クエリ、メモリリーク)
Step 4: スタイルチェック ✓
Step 5: レポート生成 ✓
すべてのチェックポイント通過
3. 内蔵およびコミュニティ Skills
(1) 内蔵 Skills
| Skill | 機能 | トリガー |
|---|---|---|
| code-review | コードレビュー | /skill code-review |
| bug-fix | バグ修正ワークフロー | /skill bug-fix |
| refactor | リファクタリングワークフロー | /skill refactor |
| test-gen | テスト生成 | /skill test-gen |
| api-design | API 設計 | /skill api-design |
| security-audit | セキュリティ監査 | /skill security-audit |
(2) Skill 管理
BASH
# 利用可能な Skills 一覧
claude /skills
# コミュニティ Skill をインストール
claude /skill install @community/pr-review
# Skill の詳細を確認
claude /skill info code-review
4. Skills の使用例
▶ 例2:bug-fix Skill ワークフロー
TEXT
📖 参照専用
> /skill bug-fix "TypeError: Cannot read property 'id' of undefined at UserController.getProfile"
Claude Code [bug-fix Skill]:
Step 1: Bug を特定 ✓
→ 発見:getProfile() が null チェックなしで req.user.id にアクセス
Step 2: 根本原因を分析 ✓
→ req.user は auth ミドルウェアが暗黙的に失敗した時に undefined
Step 3: 修正を設計 ✓
→ getProfile() に null チェックを追加
→ auth ミドルウェアを修正して失敗時に throw
Step 4: 修正を実装 ✓
→ UserController.ts と auth.ts を修正
Step 5: 修正を検証 ✓
→ テスト実行:5/5 合格 ✓
Step 6: 再発防止 ✓
→ null user のエッジケーステストを追加
Bug 修正完了 ✓ | 2ファイル修正 | 1テスト追加
5. skill-creator によるカスタム Skills の作成
(1) Skill 定義の構造
YAML
# .claude/skills/my-deployment.yaml
name: deployment
description: "Standardized deployment workflow"
trigger:
keywords: ["deploy", "deployment"]
steps:
- name: "Pre-check"
actions:
- "Confirm all tests pass"
- "Check no uncommitted changes"
checkpoints:
- "npm test exit code = 0"
- "git status clean"
- name: "Build"
actions:
- "Run build command"
checkpoints:
- "build/ directory exists"
- name: "Deploy"
actions:
- "Push code to remote"
- "Trigger CI/CD pipeline"
checkpoints:
- "git push successful"
- name: "Verify"
actions:
- "Wait for deployment"
- "Access health check endpoint"
checkpoints:
- "HTTP 200 from /health"
output:
format: "markdown"
▶ 例3:skill-creator の使用
TEXT
📖 参照専用
> /skill-creator create a "database migration" Skill
Claude Code:
DB マイグレーション Skill を作成します。いくつか質問:
1. データベースツール? Prisma
2. マイグレーションステップ? スキーマ修正、マイグレーション生成、実行、検証
3. 安全性チェック? データベースのバックアップ、可逆性の確認
4. 出力形式? Markdown レポート
→ .claude/skills/db-migration.yaml を作成中
→ Skill 作成完了 ✓
使用方法:/skill db-migration
6. Skills のベストプラクティス
Skill を作成するタイミング
| シナリオ | Skill 作成? | 理由 |
|---|---|---|
| 反復的なワークフロー | ✅ はい | 標準化が有益 |
| 重要なプロセス | ✅ はい | チェックポイントが見落としを防止 |
| チームコラボレーション | ✅ はい | 統一された作業基準 |
| 一回限りのタスク | ❌ いいえ | 通常の指示で十分 |
| シンプルなクエリ | ❌ いいえ | 過剰エンジニアリング |
設計原則
| 原則 | 説明 |
|---|---|
| ミニマル | ステップは6つ以内 |
| 検証可能 | 各ステップに明確なチェックポイント |
| 可逆的 | 重要な操作にはロールバック計画 |
| 合成可能 | Skills はネスト可能 |
❓ よくある質問
Q Skill と Plugin の違いは?
A Skills はワークフロー定義(ステップ+チェックポイント)です。プラグインは機能拡張(ツール+フック)です。Skills はプラグインが提供するツールを使用しますが、独立した概念です。
Q Skill は品質を保証しますか?
A 100%ではありません。Skills は構造化フローとチェックポイントを提供しますが、実行品質はモデルの能力に依存します。重要な操作には人間のレビューが必要です。
Q Skills はプロジェクト間で再利用できますか?
A はい。
~/.claude/skills/ に配置でグローバル、.claude/skills/ に配置でプロジェクト固有。Q skill-creator が生成した Skills の品質は?
A 最初のバージョンは使用可能ですが、調整が必要です。skill-creator は枠組みを生成し、ニーズに応じてステップとチェックポイントを洗練させてください。
📖 まとめ
- Skills は構造化ワークフロー:ステップ + チェックポイント + 出力形式
- 内蔵 Skills:code-review、bug-fix、security-audit 等
/skill <name>で Skill の実行をトリガーしフローに従う- skill-creator でインタラクティブにカスタム Skills を作成
- 反復的なワークフローや重要なプロセスに Skill が有益。一回限りのタスクには不要
📝 練習問題
- 基本 (⭐): 内蔵
code-reviewSkill を使ってファイルをレビューし、通常の指示と比較してください。 - 応用 (⭐⭐): skill-creator でカスタム Skill(例:デプロイワークフロー)を作成し、実行をテストしてください。
- 高度 (⭐⭐⭐): チームの開発→テスト→デプロイをカバーする3つのコア Skills を作成し、完全なチェックポイントを含めてください。