スキルとは何か？

スキルはClaude Codeの能力を専門知識とワークフローで拡張する仕組みです。マークダウンファイルで定義され、特定のタスクに対する構造化されたガイダンスを提供します。

スキルのアーキテクチャ

スキルの動作フロー

.claude/skills/

↓

frontmatter（メタデータ）

本文（指示内容）

↓

Claude Codeが読み込み

↓

/コマンドで呼出

条件マッチで自動適用

スキルの基本概念

スキルは、Claude Codeに対して「この種のタスクにはこう対応してほしい」という専門的な指示をパッケージ化したものです。

マークダウンファイル（.md）で定義される
/コマンドで呼び出すか、条件に基づいて自動的にトリガーされる
プロジェクトやチーム間で共有可能
バージョン管理に対応

スキルでできること

スキルを活用することで、以下のことが可能になります。

専門的なガイダンス - 特定の技術やフレームワークに関するベストプラクティスを適用
構造化されたワークフロー - コードレビュー、デプロイ、テスト戦略などの定型プロセスを標準化
ベストプラクティスの適用 - セキュリティ、パフォーマンス、アクセシビリティなどの品質基準を一貫して適用

スキルの構成要素

スキルは主に3つの部分で構成されています。

フロントマター

ファイル先頭のYAMLメタデータ。スキルの名前、説明、トリガー条件を定義します

本文指示

マークダウン形式の指示内容。ルール、テンプレート、条件分岐や処理手順を記述

トリガー条件

自動適用の条件。ファイルタイプ、キーワード、コンテキストに基づいて自動トリガー

スキルの種類

ユーザー呼び出し型

/スキル名で明示的に呼び出す
ユーザーが手動でトリガー
例: /review でコードレビュー
例: /commit でコミット生成

自動トリガー型

条件マッチで自動的に適用
フロントマターにトリガー条件を定義
例: Pythonファイル編集時にベストプラクティス適用
例: セキュリティコードにセキュリティチェック実行

スキルの作成から利用まで

作成

.mdファイルを書く

→

配置

.claude/skills/に置く

→

テスト

動作を確認

→

GitHubにプッシュ

→

インストール

他ユーザーが利用

スキルは.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) まず小さなスキルから始めて、実際の使用を通じて改善していく反復的なアプローチが有効です。

実例

ここでは、個人用スキルを実際に作成する手順を示します。Claude Codeのスキルは、SKILL.mdファイルを含むディレクトリです。SKILL.mdにはYAMLフロントマター（nameとdescription）と本文の指示を記述します。スキルはプロジェクト単位なら.claude/skills/に、個人用なら~/.claude/skills/に配置します。

例として、ステージ済みの変更からコミットメッセージを提案するcommit-helperスキルを作ってみましょう。

mkdir -p .claude/skills/commit-helper

cat > .claude/skills/commit-helper/SKILL.md <<'EOF'
---
name: commit-helper
description: Git のステージ済み変更から、Conventional Commits 形式のコミットメッセージを作成する。コミットを作る前に使う。
---

あなたはコミットメッセージ作成の専門家です。`git diff --staged` の内容を読み、
変更の種類（feat / fix / docs / refactor など）を判断し、簡潔で規約に沿った
コミットメッセージを1つ提案してください。件名は72文字以内にします。
EOF

ファイルを保存すると、Claude Codeが自動でスキルを読み込みます。会話の中でスキルの内容に合致するタスク（コミット作成など）が来ると、Claudeがdescriptionを手がかりに自動的にスキルを参照します。対話中に/helpを実行すると、利用可能な機能を確認できます。

Skillsはマークダウンが主体なので、リポジトリのバージョン管理に含めてチームで共有できます。.claude/skills/に置いたスキルをコミットしておけば、同じリポジトリで作業する全員が同じスキルを利用できるようになります。