🧠 Claude Code スキル（Skills）
📌 スキルとは何か？
Claude Codeを使っていると、次のような悩みに直面します。
デザインルールを毎回説明している
同じ開発パターンを繰り返している
よく使う知識を何度もプロンプトへ入力している
CLAUDE.md がどんどん肥大化している
こうした問題を解決する仕組みがSkills（スキル）です。
Claude Codeは、
必要な知識だけ
必要なタイミングで
自動的に読み込む
ことができます。
📊 CLAUDE.mdとの違い
| 項目 | CLAUDE.md | Skill |
|---|---|---|
| 読み込み | 常時 | 必要時のみ |
| コンテキスト消費 | 多い | 少ない |
| 専門知識管理 | 苦手 | 得意 |
| 大規模運用 | 難しい | 得意 |
🚀 スキルの最大のメリット
例えば
フロントエンド設計
バックエンド設計
セキュリティ
テスト設計
AWS
Kubernetes
などの知識を大量に持っていたとします。
CLAUDE.mdへ全て書くと非常に重くなります。
しかしスキルなら
Frontend Skill
Backend Skill
Security Skill
AWS Skill
Kubernetes Skill
として分離できます。
必要な時だけ読み込むため、数十～数百個のスキルがあっても比較的コンテキストを節約できます。
🔄 スキルの段階的読み込み
スキルには特徴があります。
それは段階的開示（Progressive Loading）です。
第1段階：メタデータ
まず読み込まれるのは 名前・説明 だけです。
イメージとしては、本棚の背表紙です。
例えば
name: frontend-design
description: モダンなUI設計を支援する
程度の情報です。
第2段階：skill.md
Claude Codeが「このスキルが必要だ」と判断するとskill.mdが読み込まれます。
例
色の使い方
余白の考え方
タイポグラフィ
レイアウト原則
などの基本知識です。
第3段階：サポートファイル
さらに必要になった場合だけ追加資料を読み込みます。
例えば
reference/
colors.md
layout.md
typography.md
examples/
dashboard.md
landing-page.md
などです。
📁 スキルの配置場所
スキルには
個人用
プロジェクト用
があります。
個人用
~/.claude/skills/
どのプロジェクトからも利用可能です。
プロジェクト用
project/
└─ .claude/
└─ skills/
チーム共有向きです。Git管理できます。
📂 基本構造
例
.claude/
└─ skills/
└─ frontend-design/
└─ skill.md
skill.md は必須です。スキルごとにフォルダを作成します。
🏗️ skill.md の基本構造
---
name: frontend-design
description:
Modern UI design guidance.
Use when creating web pages,
dashboards or applications.
---
本文
デザインルール
配色ルール
余白ルール
タイポグラフィ
⚠️ description が最重要
Claude Codeは descriptionを見て「このスキルを使うべきか」を判断します。
悪い例
description: デザイン用良い例
description:
Use when designing
web applications,
landing pages,
dashboards and admin systems.
発動条件が明確です。
🔥 スキルが発動しない原因
多くの場合は description不足です。
例えば
description:
Excelファイルを分析し、
グラフ生成や
ピボットテーブル分析を行う
のように用途を具体的に書きます。
📚 サポートファイルとは？
skill.md が大きくなりすぎる問題を解決します。
悪い例
skill.md
5000行
10000行
巨大化します。
良い例
frontend-design/
skill.md
reference/
colors.md
layout.md
examples/
dashboard.md
ecommerce.md
必要な時だけ参照できます。
🎯 サポートファイルの役割
Reference
調べ物用
例
API仕様
デザインルール
設定一覧
Examples
実装例
例
サンプルコード
テンプレート
ベストプラクティス
⚠️ フォルダを深くしすぎない
推奨
reference/
api.md
options.md
非推奨
reference/
backend/
api/
v1/
user/
その場合は スキル自体を分割した方が管理しやすくなります。
🤖 Skill Creatorとは？
Anthropic公式プラグインに含まれるSkill Creatorというスキルがあります。
スキルを作るためのスキルです。
例えば
Material Design用スキルを作りたい
と依頼すると、
skill.md
description
reference
examples
などを自動生成してくれます。
⚙️ スクリプト連携
スキルではPythonやShell Scriptも利用できます。
なぜ使うのか？
AIが苦手な処理があるからです。
AIが得意
文章作成
要約
設計
コード生成
スクリプトが得意
チェック
検証
集計
定型処理
AIとスクリプトの協調
例
リリース作業
AI
CHANGELOG作成
スクリプト
バージョン更新
Git Tag作成
Git Push
役割分担できます。
ドキュメント品質チェック例
AI
文章作成
Python
表記揺れ検出
必須セクション確認
フィードバックループ
AI作成
↓
スクリプト検証
↓
エラー発見
↓
AI修正
↓
再検証
↓
完了
📋 まとめ
Claude Codeを本格的に活用する場合、CLAUDE.md・カスタムコマンド・サブエージェントに加えて、スキルは最も重要な知識管理手法の一つです。特に大規模開発では、コンテキスト消費を抑えながら専門知識を活用できるため、積極的な導入を推奨します。