Claude Code: Agent Skills と skill-creator

最終更新:2026-08-31

Agent Skills は Claude Code の「専門スキルパック」です — Skill をインストールすれば、Claude Code は完全な専門ワークフローを獲得します。

💡 ヒント: Skills はシンプルなプロンプトテンプレートではなく、ステップ、チェックリスト、出力形式、検証ロジックを含む完全なワークフロー定義です。skill-creator でこれらのスキルをカスタマイズできます。

📋 前提条件: 第15章 - メモリシステム

1. 学ぶ内容


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 は枠組みを生成し、ニーズに応じてステップとチェックポイントを洗練させてください。

📖 まとめ


📝 練習問題

  1. 基本 (⭐): 内蔵 code-review Skill を使ってファイルをレビューし、通常の指示と比較してください。
  2. 応用 (⭐⭐): skill-creator でカスタム Skill(例:デプロイワークフロー)を作成し、実行をテストしてください。
  3. 高度 (⭐⭐⭐): チームの開発→テスト→デプロイをカバーする3つのコア Skills を作成し、完全なチェックポイントを含めてください。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%