スキルはClaude Codeの能力を専門知識とワークフローで拡張する仕組みです。マークダウンファイルで定義され、特定のタスクに対する構造化されたガイダンスを提供します。
スキルのアーキテクチャ
スキルの基本概念
スキルは、Claude Codeに対して「この種のタスクにはこう対応してほしい」という専門的な指示をパッケージ化したものです。
- マークダウンファイル（
.md）で定義される /コマンドで呼び出すか、条件に基づいて自動的にトリガーされる- プロジェクトやチーム間で共有可能
- バージョン管理に対応
スキルでできること
スキルを活用することで、以下のことが可能になります。
- 専門的なガイダンス - 特定の技術やフレームワークに関するベストプラクティスを適用
- 構造化されたワークフロー - コードレビュー、デプロイ、テスト戦略などの定型プロセスを標準化
- ベストプラクティスの適用 - セキュリティ、パフォーマンス、アクセシビリティなどの品質基準を一貫して適用
スキルの構成要素
スキルは主に3つの部分で構成されています。
フロントマター
ファイル先頭のYAMLメタデータ。スキルの名前、説明、トリガー条件を定義します
本文指示
マークダウン形式の指示内容。ルール、テンプレート、条件分岐や処理手順を記述
トリガー条件
自動適用の条件。ファイルタイプ、キーワード、コンテキストに基づいて自動トリガー
スキルの種類
👉 ユーザー呼び出し型
/スキル名で明示的に呼び出す- ユーザーが手動でトリガー
- 例:
/reviewでコードレビュー - 例:
/commitでコミット生成
⚙️ 自動トリガー型
- 条件マッチで自動的に適用
- フロントマターにトリガー条件を定義
- 例: Pythonファイル編集時にベストプラクティス適用
- 例: セキュリティコードにセキュリティチェック実行
スキルの作成から利用まで
スキルは.claude/skills/ディレクトリにマークダウンファイルを配置することで作成できます。
- ディレクトリの作成 - プロジェクトルートまたはホームディレクトリに
.claude/skills/を作成 - マークダウンファイルの作成 - スキル名に対応する
.mdファイルを作成 - フロントマターの記述 - 名前、説明、トリガー条件を定義
- 本文の記述 - 指示、テンプレート、ロジックを記述
スキルの共有
スキルはGitHubリポジトリ経由で簡単に共有・インストールできます。
- リポジトリにスキルファイルを含めてプッシュ
- 他のユーザーはリポジトリURLを指定してインストール
npx skills add リポジトリ名コマンドでインストール可能
コミュニティスキル
Anthropicが管理するanthropics/skillsリポジトリには、プリビルトのスキルが多数用意されています。
- PDF、DOCX、PPTX、XLSXなどのドキュメント操作
- フロントエンドデザイン
- APIビルダー
- MCPサーバービルダー
- その他多数の汎用スキル
コミュニティスキルを活用することで、ゼロからスキルを作成する手間を省き、実績のあるワークフローをすぐに利用開始できます。
特に人気の高いスキルとして、pdf（PDF読み込み・生成）、commit（コミットメッセージ自動生成）、review（コードレビュー）、docx（Word文書操作）、pptx（プレゼンテーション作成）、mcp-builder（MCPサーバー構築ガイド）などがあります。npx skills add anthropics/skills でまとめてインストール可能です。
効果的なスキルを作るコツ: (1) 説明文にはTRIGGER条件を明記し、Claudeが適切に自動判断できるようにする。(2) 指示は具体的かつ簡潔にし、曖昧な表現を避ける。(3) 出力のフォーマットやテンプレートを含めると一貫性が向上する。(4) まず小さなスキルから始めて、実際の使用を通じて改善していく反復的なアプローチが有効です。