コーディング| AIpedia編集部

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

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

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

Claude Skillsとは何か

Claude Skillsは「AIに特定の手順を覚えさせ、必要なタイミングで自動実行させる」仕組み。Markdownファイル1枚で定義でき、以下を含められます:

  • description: いつ起動するか(自然言語のトリガー条件)
  • 手順書: AIに従わせたい一連のステップ
  • 使えるツール: Read/Edit/Bash等の許可リスト
  • 環境設定: 環境変数、参照すべき外部URL

Skill vs Slash Command vs Subagent vs Hook

機能起動方法用途
Skills自動発火(descriptionで条件マッチ)「Pythonテストを書く時」「PRレビューする時」など条件付きワークフロー
Slash Commands手動(/review等のコマンド)明示的に呼び出す定型作業
Subagents親エージェントが委譲独立したサブタスク(並列リサーチ等)
Hooksイベント発火(PostToolUse等)ツール実行前後の自動アクション(lint等)
MCP Servers外部システム接続Slack/Linear/DB等のツール拡張

4機能を組み合わせて「Skillが起動→Subagentに委譲→MCPで外部DB検索→Hookでlint実行」のような複雑ワークフローを宣言的に記述できます。

最小Skillの実装例(30秒で書ける)

---
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)
- 該当ファイル:行番号
- 改善提案コード

Skillsを置く場所と発見ロジック

  • プロジェクト固有: .claude/skills/(チームGit共有)
  • 個人グローバル: ~/.claude/skills/(自分専用)
  • 企業配布: Plugin形式でnpm/GitHubに配布、claude plugin install

Claudeはセッション開始時に全Skillsのdescriptionをスキャンし、ユーザー発話と意図マッチングで自動起動を判定します。

実用Skill 5選(コピペで即使える)

Skill 1: deploy-checker

「デプロイ前に」と言われたらビルド・テスト・lint・セキュリティスキャンを並列実行し、レポート。

Skill 2: security-review

変更されたファイルでOWASP Top 10をチェック。Subagentに委譲して並列分析、Critical発見で即停止。

Skill 3: db-migration-safety

SQLマイグレーションファイル変更時に自動起動。NOT NULL追加・カラム削除等の危険操作を警告。

Skill 4: doc-from-pr

PRマージ後にCHANGELOG・ユーザードキュメントを自動更新。

Skill 5: incident-postmortem

「インシデント振り返り」で起動。Slack/Datadog/PagerDutyログを集約してテンプレート埋め込み。

Skill設計のベストプラクティス

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

企業導入のロードマップ

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

2026年トレンド:Skills Marketplace

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

Skills導入企業の生産性向上ベンチマーク

  • Shopify:エンジニア1人あたりPR数 +40%(社内Skills 30種を全社配布)
  • Stripe:オンコール対応時間 -30%(incident-postmortem Skill)
  • Anthropic自社:CIフロー90%以上をSkill化、新人オンボーディング1日に短縮

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

この記事の執筆・検証

A

AIpedia編集部

AIpedia編集部は、AIツールの調査・比較・検証を専門とするチームです。紹介するツールは実際にアカウントを作成して操作し、料金体系・主要機能・使用感を確認した上で執筆しています。記事は定期的に見直し、情報の更新に努めています。