Claude Code Skillsは、カスタム機能をディレクトリ構造とフロントマターで定義し、Claudeに専門知識を注入する仕組みだ。ビルトインスキルの活用から独自スキルの作成まで、開発者が知るべき全てを解説する。
Skillsとは何か|Claude Codeの拡張ポイント
Skillsは、Claude Codeに特定のタスク用の知識と手順を追加する拡張機能だ。通常のCLAUDE.mdがプロジェクト全体のルールを定義するのに対し、Skillsは特定のタスク実行時にのみ動的にロードされる。
各スキルはSKILL.mdファイルを中心としたディレクトリで構成され、フロントマターでメタデータ(名前、説明、呼び出し制御)を定義する。
ビルトインスキル一覧
2026年時点のClaude Codeには以下のビルトインスキルが搭載されている。
- /batch — worktree上で大規模並列コード変更をオーケストレーション
- /claude-api — 使用言語に応じたClaude API リファレンスをロード
- /debug — デバッグログを有効化
- /loop — 指定間隔でプロンプトを繰り返し実行
- /simplify — 3つの並列レビューエージェントで変更ファイルの品質チェック
SKILL.mdの書き方|テンプレート
独自スキルを作成するには、.claude/skills/ディレクトリにフォルダを作成し、SKILL.mdを配置する。
---
name: my-custom-skill
description: |
カスタムスキルの説明。Claudeがこのスキルを
いつ使うべきか判断するための情報。
---
# スキル名
## 手順
1. まず○○を確認する
2. 次に△△を実行する
3. 結果を□□形式で出力する
## 参考情報
- APIエンドポイント: https://...
- 認証方法: Bearer token
スキル呼び出しの制御
スキルの呼び出し方は2パターンある。
# ユーザーが明示的に呼び出す(スラッシュコマンド)
/my-custom-skill
# Claudeが自動的に判断して呼び出す
# → descriptionフィールドにトリガー条件を記述
フロントマターのdescriptionに「○○の時に使う」と書くことで、Claudeが関連タスクを検知した際に自動的にスキルをロードする。
サブエージェントとの連携
スキル内からサブエージェントを起動して、タスクを並列実行できる。
# SKILL.md内でサブエージェントを指示
## 実行手順
1. Agent toolで以下を並列実行:
- エージェント1: セキュリティ分析
- エージェント2: パフォーマンスレビュー
- エージェント3: 型チェック
各サブエージェントは独立したコンテキストで動作し、結果をメインセッションに返す。
実践的なスキル設計パターン
効果的なスキルを設計するためのパターンを紹介する。
- リサーチ→実行パターン: まずWebSearchで情報収集し、結果に基づいてコード生成
- QAゲートパターン: 実行後にチェックリストで品質検証
- テンプレート生成パターン: 定型作業をスキルで自動化
参考文献
- Extend Claude with skills – Claude Code Docs(参照日: 2026-04-07)
- Superpowers for Claude Code: The #1 Skills Framework(参照日: 2026-04-07)
- CLAUDE.md Productivity Stack(参照日: 2026-04-07)
この記事はAIgent Lab編集部がお届けしました。