Claude Code Skills|カスタムスキル作成

この記事の結論

Claude Code Skillsでカスタム機能を追加。SKILL.mdの書き方からサブエージェント連携まで解説。

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ゲートパターン: 実行後にチェックリストで品質検証
  • テンプレート生成パターン: 定型作業をスキルで自動化

参考文献


この記事はAIgent Lab編集部がお届けしました。

Need help moving from reading to rollout?

この記事を読んで導入イメージが固まってきた方へ

Uravationでは、AIエージェントの要件整理、PoC設計、社内導入、研修まで一気通貫で支援しています。

この記事をシェア

X Facebook LINE

※ 本記事の情報は2026年4月時点のものです。サービスの料金・仕様は変更される可能性があります。最新情報は各サービスの公式サイトをご確認ください。

関連記事