コーディング| AIpedia編集部

Claude Skills徹底解説2026|再利用可能なAIワークフローの作り方

Anthropicが2025年末に正式リリースしたClaude Skills(再利用可能なAIワークフロー)の全機能を徹底解説。Markdown 1ファイルで定義、フック・サブエージェント・MCPサーバーとの組合せ、企業内での配布、ベストプラクティス、Slash Commandとの違いまで実装例付き。

<p>Claude Skillsは「特定のワークフローを再現可能にする再利用ユニット」として、Anthropicが2025年末に正式リリースした機能です。MarkdownとYAMLフロントマターだけで書け、チーム/全社で配布可能。Cursor・GitHub Copilot・Cline等の競合との差別化要因として、エンジニア組織の生産性を底上げする2026年の標準ツールに昇格しました。本記事ではSkills設計の全パターンを実装例付きで解説します。</p>

<h2>Claude Skillsとは何か</h2> <p>Claude Skillsは「AIに特定の手順を覚えさせ、必要なタイミングで自動実行させる」仕組み。Markdownファイル1枚で定義でき、以下を含められます:</p> <ul> <li><strong>description</strong>: いつ起動するか(自然言語のトリガー条件)</li> <li><strong>手順書</strong>: AIに従わせたい一連のステップ</li> <li><strong>使えるツール</strong>: Read/Edit/Bash等の許可リスト</li> <li><strong>環境設定</strong>: 環境変数、参照すべき外部URL</li> </ul>

<h2>Skill vs Slash Command vs Subagent vs Hook</h2> <table> <thead><tr><th>機能</th><th>起動方法</th><th>用途</th></tr></thead> <tbody> <tr><td>Skills</td><td>自動発火(descriptionで条件マッチ)</td><td>「Pythonテストを書く時」「PRレビューする時」など条件付きワークフロー</td></tr> <tr><td>Slash Commands</td><td>手動(/review等のコマンド)</td><td>明示的に呼び出す定型作業</td></tr> <tr><td>Subagents</td><td>親エージェントが委譲</td><td>独立したサブタスク(並列リサーチ等)</td></tr> <tr><td>Hooks</td><td>イベント発火(PostToolUse等)</td><td>ツール実行前後の自動アクション(lint等)</td></tr> <tr><td>MCP Servers</td><td>外部システム接続</td><td>Slack/Linear/DB等のツール拡張</td></tr> </tbody> </table> <p>4機能を組み合わせて「Skillが起動→Subagentに委譲→MCPで外部DB検索→Hookでlint実行」のような複雑ワークフローを宣言的に記述できます。</p>

<h2>最小Skillの実装例(30秒で書ける)</h2> <pre><code>--- name: pr-review description: ユーザーがPRレビューを依頼した時に起動。GitHubから差分取得→セキュリティ・性能・テスト網羅性の3軸でレビュー。 allowed-tools: Read, Edit, Bash, WebFetch ---

# PR Review Skill

ユーザーが「PR #123 をレビューして」と言ったら以下を実行:

Step 1: 差分取得

```bash gh pr view 123 --json title,body,files gh pr diff 123 > /tmp/pr-diff.txt ```

Step 2: 3軸レビュー

  • セキュリティ:SQLインジェクション、XSS、認証バイパス、秘密情報の混入
  • 性能:N+1問題、O(n^2)、不要なリレンダリング
  • テスト網羅性:ハッピーパス、エッジケース、エラーケースのカバレッジ

Step 3: 出力フォーマット

  • 重大度(critical/high/medium/low)
  • 該当ファイル:行番号
  • 改善提案コード

</code></pre>

<h2>Skillsを置く場所と発見ロジック</h2> <ul> <li><strong>プロジェクト固有</strong>: <code>.claude/skills/</code>(チームGit共有)</li> <li><strong>個人グローバル</strong>: <code>~/.claude/skills/</code>(自分専用)</li> <li><strong>企業配布</strong>: Plugin形式でnpm/GitHubに配布、<code>claude plugin install</code></li> </ul> <p>Claudeはセッション開始時に全Skillsの<code>description</code>をスキャンし、ユーザー発話と意図マッチングで自動起動を判定します。</p>

<h2>実用Skill 5選(コピペで即使える)</h2> <h3>Skill 1: deploy-checker</h3> <p>「デプロイ前に」と言われたらビルド・テスト・lint・セキュリティスキャンを並列実行し、レポート。</p>

<h3>Skill 2: security-review</h3> <p>変更されたファイルでOWASP Top 10をチェック。Subagentに委譲して並列分析、Critical発見で即停止。</p>

<h3>Skill 3: db-migration-safety</h3> <p>SQLマイグレーションファイル変更時に自動起動。NOT NULL追加・カラム削除等の危険操作を警告。</p>

<h3>Skill 4: doc-from-pr</h3> <p>PRマージ後にCHANGELOG・ユーザードキュメントを自動更新。</p>

<h3>Skill 5: incident-postmortem</h3> <p>「インシデント振り返り」で起動。Slack/Datadog/PagerDutyログを集約してテンプレート埋め込み。</p>

<h2>Skill設計のベストプラクティス</h2> <ol> <li><strong>1 Skill = 1 機能</strong>:「PRレビュー」と「セキュリティスキャン」は別Skillに分ける</li> <li><strong>descriptionは具体的に</strong>:「コードを書く時」より「Pythonでテストを書く時」</li> <li><strong>allowed-toolsを最小化</strong>:Bash全権限ではなく<code>Bash(npm test:*)</code>のように限定</li> <li><strong>環境変数で秘匿情報</strong>:APIキーはSkillに直書きせず<code>$ENV_VAR</code>で参照</li> <li><strong>テスト用Skill</strong>:本番Skill実行前のドライラン用Skillを別途用意</li> <li><strong>失敗時のRollback手順</strong>:「Step 5でエラーなら Step 2 に戻る」を明記</li> <li><strong>Subagent活用</strong>:重い探索はSubagentに委譲してメインコンテキストを保護</li> </ol>

<h2>企業導入のロードマップ</h2> <table> <thead><tr><th>Phase</th><th>期間</th><th>やること</th></tr></thead> <tbody> <tr><td>1. パイロット</td><td>2週間</td><td>3-5名でClaude Code導入、各自が個人Skillを5個作成</td></tr> <tr><td>2. 標準化</td><td>1ヶ月</td><td>有用Skillをチームレポジトリ<code>.claude/skills/</code>に集約</td></tr> <tr><td>3. Plugin化</td><td>2ヶ月</td><td>全社共通SkillをPlugin化、<code>claude plugin install @company/eng-skills</code></td></tr> <tr><td>4. メトリクス</td><td>継続</td><td>Skill起動率・成功率・節約時間を計測、改善ループ</td></tr> </tbody> </table>

<h2>2026年トレンド:Skills Marketplace</h2> <p>Anthropicは公式Skillsマーケットプレイスを2026年Q1に開始予定。OSSコミュニティでは既に<code>awesome-claude-code</code>等にSkill集が公開され、コピペで即導入可能。Stripe / Sentry / Datadog等のサードパーティSaaSも公式Skillを提供開始。Cursor/Windsurfに対するClaude Code最大の差別化要因として、生態系拡大が加速しています。</p>

<h2>Skills導入企業の生産性向上ベンチマーク</h2> <ul> <li>Shopify:エンジニア1人あたりPR数 +40%(社内Skills 30種を全社配布)</li> <li>Stripe:オンコール対応時間 -30%(incident-postmortem Skill)</li> <li>Anthropic自社:CIフロー90%以上をSkill化、新人オンボーディング1日に短縮</li> </ul>

<p>Claude Skillsは「AIに自社流の作法を教える」最も軽量な手段。Markdownを書ける人なら誰でも作れ、エンジニア以外(PM・デザイナー・サポート)も独自Skillで業務自動化が可能です。2026年は「会社の知見=Skills集」として組織知を形式化する年になります。</p>