Claude Codeカスタムスキル開発ガイド｜実践的な拡張方法

「Claude Codeをもっと自分好みにカスタマイズしたい」「チーム全体で共通のワークフローを効率化したい」——Claude Codeを使い込むほど、こうしたニーズが出てくるのではないでしょうか。

結論から言うと、Claude Code Skillsを使えば、独自の指示書・スクリプト・テンプレートをパッケージ化して再利用可能な拡張機能を作れます。これにより、定型タスクの自動化やチーム内のナレッジ共有が格段に楽になります。

この記事はClaude Code完全攻略シリーズとして、カスタムスキルの開発方法を実践的に解説します。

Claude Code Skillsとは？プラグインシステムの全体像

Skills・Hooks・Custom Toolsの違いと使い分け

Claude Codeの拡張機能は大きく3種類に分かれます。それぞれの特徴を理解して適切に使い分けましょう。

拡張機能	目的	実行タイミング	構成要素
Skills	タスク定義・ナレッジ注入	エージェントが判断して適用	SKILL.md + スクリプト + 参照データ
Hooks	イベント駆動の自動処理	ファイル保存・コマンド実行時	フック設定 + 実行スクリプト
Custom Tools	新しいツールの追加	エージェントが呼び出し	ツール定義 + 実行ロジック

Skillsは「こういうタスクにはこの手順を使って」という指示書であり、エージェントが文脈に応じて自動的に適用します。一方、Hooksはファイル保存時にリントを走らせるような自動処理、Custom ToolsはAPIコールなどの新しい機能追加に適しています。

Hooksの詳細は「Claude Code Hooks完全ガイド」を参照してください。

Skillsで何ができるのか（ユースケース一覧）

Skillsの活用シーンは多岐にわたります。

• コード生成の定型化：特定フレームワークのボイラープレート生成
• デプロイ手順の標準化：環境ごとのデプロイフローをスキル化
• テスト戦略の統一：テストの書き方やカバレッジ基準を定義
• ドキュメント生成：APIドキュメントや技術仕様書の自動生成
• 画像生成：OGP画像やインフォグラフィックの生成パイプライン
• データ分析：定期レポートの生成・分析フロー

カスタムスキルの構成要素

SKILL.md（指示書）の書き方

SKILL.mdは、スキルの中核となる指示書です。エージェントはこのファイルを読んでタスクの実行方法を理解します。

---
name: deploy-staging
description: ステージング環境へのデプロイ手順を管理するスキル
---

# ステージング環境デプロイスキル

## 前提条件
- AWS CLIが設定済みであること
- Docker環境が利用可能であること

## 手順
1. テストを全て通過させる
2. Dockerイメージをビルド
3. ECRにプッシュ
4. ECSサービスを更新

## 注意点
- 本番環境には絶対にデプロイしない
- デプロイ前に必ずチームに通知する

SKILL.mdのベストプラクティス：

• 具体的で明確な指示を書く（曖昧な表現を避ける）
• 前提条件を明示する
• エラー時の対処法も含める
• 関連するスクリプトやデータの相対パスを記載する

実行可能スクリプトの組み込み方

スキルにはシェルスクリプトやPythonスクリプトを組み込むことができます。

my-skill/
├── SKILL.md          # 指示書
├── scripts/
│   ├── deploy.sh     # デプロイスクリプト
│   ├── validate.py   # バリデーション
│   └── notify.sh     # 通知スクリプト
└── templates/
    └── config.yaml   # テンプレート

SKILL.md内でスクリプトを参照する場合、{baseDir}プレースホルダーを使って相対パスを解決します。

デプロイ実行:
\`\`\`bash
bash {baseDir}/scripts/deploy.sh --env staging
\`\`\`

参照データとテンプレートの管理

スキルに含める参照データやテンプレートは、以下のように整理します。

• 参照データ：APIの仕様書、設定ファイルのサンプル、命名規則など
• テンプレート：コードのひな形、設定ファイルのテンプレート
• サンプル：期待される出力のサンプル（エージェントの理解を助ける）

Anthropicの公式ドキュメント「Claude Code Extensions」でもスキルの構成方法が詳しく解説されています。

実践：カスタムスキルを一から作る

ステップ1：タスク定義とディレクトリ構成

まず、スキル化したいタスクを明確にし、ディレクトリを作成します。

# スキルディレクトリの作成
mkdir -p ~/.claude/skills/article-generator
cd ~/.claude/skills/article-generator

# 基本構成の作成
touch SKILL.md
mkdir scripts templates references

今回は例として「技術記事の生成スキル」を作ってみましょう。

ステップ2：SKILL.mdの記述

---
name: article-generator
description: 技術記事の構成案作成から執筆・バリデーションまでを担当する
---

# 技術記事生成スキル

## 概要
SEOに最適化された技術記事を生成するスキル。

## 執筆ルール
- 3000〜5000字/記事
- 導入文は読者の悩みに寄り添い、結論ファースト
- H2セクションごとにキーワードを自然に配置
- 内部リンク3本以上

## 実行手順
1. テンプレートを読み込み
2. 構成案に基づいて本文を執筆
3. バリデーションスクリプトで品質チェック

ステップ3：スクリプトとワークフローの実装

バリデーションスクリプトの例：

#!/bin/bash
# scripts/validate.sh - 記事の品質チェック
FILE=$1

# 文字数チェック
CHARS=$(wc -m < "$FILE")
if [ "$CHARS" -lt 3000 ]; then
  echo "❌ 文字数不足: ${CHARS}字（最低3000字）"
  exit 1
fi

# 内部リンクチェック
LINKS=$(grep -c 'ses-base.com/articles/' "$FILE")
if [ "$LINKS" -lt 3 ]; then
  echo "❌ 内部リンク不足: ${LINKS}本（最低3本）"
  exit 1
fi

echo "✅ バリデーション通過"

ステップ4：テストとデバッグ

作成したスキルは以下の手順でテストします。

1. 手動テスト：Claude Codeにタスクを依頼して、スキルが正しく適用されるか確認
2. エッジケース：異常な入力や境界値でのテスト
3. 出力品質：生成物が期待通りの品質かレビュー
4. パフォーマンス：スクリプトの実行時間が許容範囲内か

Anthropicマーケットプレイスの活用

公式スキルのインストールと設定

Anthropicは公式のスキルマーケットプレイスを提供しており、以下のように簡単にインストールできます。

# マーケットプレイスからスキルをインストール
claude skill install @anthropic/web-scraper
claude skill install @community/docker-deploy

# インストール済みスキルの一覧
claude skill list

人気の公式スキル：

• @anthropic/code-review：コードレビューの自動化
• @anthropic/test-generator：テストコードの自動生成
• @anthropic/doc-writer：ドキュメントの自動生成

LSP・MCPプラグインとの連携

SkillsはMCP（Model Context Protocol）と組み合わせることで、外部ツールやサービスとの連携が可能になります。

• MCP経由のデータベースアクセス：DBスキーマを参照しながらクエリを生成
• MCP経由のAPI連携：外部APIの呼び出しをスキルに組み込み
• LSP連携：言語サーバーからの型情報やエラー情報を活用

MCPの詳細は「Claude Code MCP連携ガイド」で解説しています。

チーム開発でのスキル共有と管理

Git管理とバージョニング

チームでスキルを共有するベストプラクティス：

team-skills/
├── README.md
├── deploy/
│   └── SKILL.md
├── testing/
│   └── SKILL.md
├── code-review/
│   └── SKILL.md
└── docs/
    └── SKILL.md

• Gitリポジトリで管理：バージョン管理と変更履歴の追跡
• PRベースの更新：スキルの変更はPRレビューを通す
• セマンティックバージョニング：破壊的変更時はメジャーバージョンを上げる

カスタムエージェントとの組み合わせ

スキルは、Claude Codeのカスタムエージェント機能と組み合わせることで、特定の役割に特化したAIアシスタントを構築できます。

• デプロイエージェント：デプロイスキル＋監視スキルを組み合わせ
• テストエージェント：テスト生成スキル＋カバレッジ分析スキル
• ドキュメントエージェント：ドキュメント生成スキル＋翻訳スキル

エージェントの構築方法は「Claude Codeエージェントチームガイド」を参照してください。

まとめ：スキル開発でClaude Codeを自分仕様に

Claude Code Skillsのポイントをまとめます。

• SkillsはSKILL.md＋スクリプト＋参照データで構成されるプラグインシステム
• SKILL.mdが中核。具体的で明確な指示を書くことが成功の鍵
• 再利用性を意識した設計で、チーム全体の開発効率が向上
• マーケットプレイスの公式スキルを活用して開発コストを削減
• MCP連携で外部サービスとの統合も可能

スキル開発をマスターすれば、Claude Codeは単なるAIアシスタントからチームの生産性を支えるプラットフォームへと進化します。