はじめに
Claudeを使っていて、こんな場面に心当たりはありませんか？
- 「毎回同じ長い指示をコピペしている」
- 「いつものやり方をClaudeに覚えさせたい」
- 「チームで同じワークフローを共有したい」
そのすべてを解決するのが、Claude Skills（クロードスキル） という機能です。
■ 検索ボリューム（2026年時点の推定）
- 1000～10000: "claude skills"
- 100～1000: "claude skills とは", "claude skills 使い方"
- 10～100: "claude skills 作り方", "claude skills 例"まだ認知度は高くありませんが、使いこなしているユーザーとそうでないユーザーで作業効率に大きな差が生まれる機能です。本記事では概要・仕組み・セットアップ手順・SKILL.mdの書き方まで、初心者にも分かるよう徹底解説します。
この記事で分かること
- Claude Skillsとは何か（概要・定義）
- Claude Code版とClaude.ai Web版の違い
- 組み込みスキル（Bundled Skills）の種類と使い方
- カスタムスキルの作り方（SKILL.mdの書き方）
- 環境構築・セットアップの具体的な手順
- メリット・デメリット・注意点
- 今後の展望と懸念事項
Claude Skillsとは
Claude Skills は、Claudeに「専用の手順書と知識」を渡して、特定の作業をプロ級にこなせるようにする拡張機能です。
技術的には SKILL.md という名前のMarkdownファイルで定義されており、Agent Skills というオープンスタンダードに準拠しています。
2つの役割
Skills には大きく2つの役割があります。
| 役割 | 説明 | 例 |
|---|---|---|
| リファレンス型 | 会話全体を通じて参照される知識 | API規約、コーディング規約、スタイルガイド |
| タスク型 | 特定のコマンドで実行される手順 | /deploy、/review、/create-report |
CLAUDE.mdとの違い
よく混同されるのが CLAUDE.md との違いです。シンプルに整理するとこうなります。
| CLAUDE.md | SKILL.md | |
|---|---|---|
| 役割 | 常に適用されるルール・文脈 | 必要な時だけ呼び出す手順 |
| 読み込みタイミング | セッション開始時に毎回全文 | 呼び出された時だけ |
| イメージ | 就業規則・行動指針 | 業務マニュアル（手順書） |
| 向いている内容 | 短いルール、言語設定、基本方針 | 詳細な手順、ワークフロー |
ポイント: CLAUDE.mdはコンテキストを常に消費するため、長くなりすぎると問題になります。詳細な手順はSKILL.mdに切り出すのが正解です。
Claude Code版 と Claude.ai Web版の違い
Skills機能は2つの環境で利用できます。
| Claude Code（CLIツール） | Claude.ai Web | |
|---|---|---|
| 利用環境 | ターミナル（コマンドライン） | ブラウザ（Web画面） |
| ファイルの置き場所 | ローカルPC上のフォルダ | Web UI からアップロード |
| 設定画面 | ~/.claude/skills/ | claude.ai/customize/skills |
| チーム共有 | gitリポジトリで共有 | Web UI 経由 |
どちらも SKILL.mdというファイル形式を使う点は共通です。仕組みは同じで、管理方法が異なるだけです。
組み込みスキル（Bundled Skills）一覧
Claude Codeには最初から使えるスキルが5つ用意されています。
/batch <指示>
大規模なコードベース変更を並列実行するスキルです。
- コードベースを調査して作業を5〜30の独立ユニットに分解
- 各ユニットを並列で実行
- 大量のファイル変更も一括で処理できる
使用例: npm 依存関係の一括更新、フレームワーク移行、大規模リファクタリング
/claude-api
Claude API・Anthropic SDKのリファレンス資料を読み込むスキルです。
- Python、TypeScript、Java、Go、Ruby、C#、PHP、cURLに対応
- Tool Use、ストリーミング、バッチ処理、構造化出力をカバー
- コードが
anthropicや@anthropic-ai/sdkをインポートすると自動トリガー
/debug [説明]
セッションのデバッグログを分析して問題を診断するスキルです。
使用例: /debug ログインできないエラーが出ている
/loop [間隔] <プロンプト>
プロンプトを定期的に繰り返し実行するスキルです。
使用例: /loop 5m check if deploy finished（5分ごとにデプロイ状況を確認）
/simplify [フォーカス]
最近変更したコードを3エージェント並列でレビューし、品質・効率・再利用性の問題を検出・修正するスキルです。
使用例: /simplify focus on memory efficiency
カスタムスキルの作り方
SKILL.mdの基本構造
---
name: スキル名（ローバーケース、ハイフン区切り）
description: いつ使うかの説明（Claudeの自動判断に使われる重要な項目）
disable-model-invocation: false
argument-hint: [引数のヒント]
---
ここに指示を書く
1. 手順1
2. 手順2
3. 手順3主なフロントマタフィールド
| フィールド | 説明 |
|---|---|
name | スキルの識別子（必須ではないが推奨） |
description | Claudeが自動判断するための説明（最重要） |
disable-model-invocation | true にするとユーザーが明示的に呼ばないと起動しない |
argument-hint | /skill-name の後に続く引数のヒント表示 |
allowed-tools | 使用を許可するツールを制限 |
model | sonnet / opus / haiku から選択 |
context | fork を指定すると隔離されたコンテキストで実行 |
descriptionが最重要な理由
description はセッション開始時に常に読み込まれ、Claudeが「このスキルをいつ使うか」を判断する材料になります。
# 悪い例（曖昧すぎる）
description: コードを処理する
# 良い例（いつ使うかが明確）
description: Explains how code works with diagrams and analogies.
Use when the user asks "how does this work?" or wants to understand
a specific piece of code.動的な値の埋め込み
スキル内では変数を使って動的な内容を注入できます。
---
name: fix-issue
description: Fix a GitHub issue by number
argument-hint: [issue-number]
---
Fix GitHub issue number $ARGUMENTS following our coding standards.
Log activity to logs/${CLAUDE_SESSION_ID}.logシェルコマンドの出力を注入する
!`コマンド` という記法で、シェルコマンドの実行結果をスキルに注入できます。
---
name: pr-summary
description: Summarize the current pull request
---
## PR情報
- 差分: !`gh pr diff`
- 変更ファイル: !`gh pr diff --name-only`
- コメント: !`gh pr view --comments`
## タスク
上記のPRを日本語で詳しくサマリーしてください。環境構築・セットアップ手順
Claude Code版のセットアップ
ステップ1: ディレクトリを作成する
# 個人用スキル（全プロジェクトで使える）
mkdir -p ~/.claude/skills/my-skill
# プロジェクト用スキル（このプロジェクトのみ・チーム共有可）
mkdir -p .claude/skills/my-skillステップ2: SKILL.mdを作成する
cat > ~/.claude/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: Greet the user warmly. Use when the user wants a greeting or introduction.
---
Greet the user warmly and ask how you can help today.
EOFステップ3: 動作確認
Claude Codeを起動して、スラッシュコマンドで呼び出します。
/my-skillまたは、descriptionに合った自然言語で話しかけます（自動トリガー）。
こんにちは、今日はどんな作業をすればいいですか？Claude.ai Web版のセットアップ
- claude.ai/customize/skills を開く
- 右上の
+ボタンをクリック - SKILL.mdファイルをアップロード（または直接編集）
- スイッチをオンにして有効化
ヒント:
skill-creatorという組み込みスキルを有効にすると、Claudeが対話形式でSKILL.mdを作成してくれます。
ファイル構造の例（複数ファイルを持つスキル）
my-skill/
├── SKILL.md ← メイン指示（必須）
├── reference.md ← 詳細なAPIドキュメントなど
├── examples.md ← 使用例
└── scripts/
└── helper.sh ← 補助スクリプトスキルの配置場所と優先順位
| 配置場所 | スコープ | 優先順位 |
|---|---|---|
| Managed Policy（企業管理） | 組織全体 | 1位（最優先） |
~/.claude/skills/ | 全プロジェクト（個人用） | 2位 |
.claude/skills/ | このプロジェクトのみ | 3位 |
Plugin内 skills/ | Plugin有効時 | 4位 |
同名のスキルが複数の場所に存在する場合、優先順位が高い方が使われます。
メリット・デメリット
メリット
| メリット | 説明 |
|---|---|
| 再利用性が高い | 一度作れば何度でも使い回せる。個人用なら全プロジェクトで利用可能 |
| コンテキスト効率が良い | descriptionだけ常駐、本文は呼び出し時のみ読み込みでトークンを節約 |
| 自動化できる | Claudeがdescriptionを見て自動判断・自動実行 |
| チームで統一できる | プロジェクトスキルはgit管理して全員で共有可能 |
| ミスを防げる | disable-model-invocation: true で意図しない実行を防止 |
| 詳細な手順を書ける | 本文は長く書いてもOK（呼ばれた時しか読み込まれないため） |
デメリット・注意点
| デメリット | 対策 |
|---|---|
| descriptionが曖昧だと誤作動する | 「いつ使うか」を具体的に書く |
| スキル数が増えるとdescription上限に達する | description合計は16,000文字が上限 |
| メンテナンスが必要 | 定期的に見直して陳腐化したスキルは削除 |
| スキル同士の直接呼び出しは不可 | Subagent経由なら可能 |
| セキュリティリスク | 出所不明のスキルはインストールしない |
今後の展望と懸念
今後期待される進化
- descriptionのAIベース分類: 自動トリガーの精度がさらに向上
- スキル間チェーン: スキルから別スキルを直接呼び出せるように
- Community Marketplace: コミュニティ製スキルの共有・配布プラットフォーム
- バージョン管理: Semantic Versioning によるスキルの版管理
注意すべき懸念点
| 懸念 | 内容 |
|---|---|
| スキルの肥大化 | 500行を超えたら補助ファイルに分割する |
| 名前の衝突 | Plugin利用時は plugin-name:skill-name の名前空間で管理 |
| 企業ポリシーによる制限 | Managed Policyが設定されている場合、個人スキルが上書きされる |
まとめ
Claude Skills は、「毎回同じ説明をする手間をゼロにする」 ための機能です。
使い始めのポイントをまとめます。
- まずは
/simplifyや/debugなど組み込みスキルを試す - 「また同じことを説明してる」と感じたらSkill化のタイミング
- descriptionを明確に書くことが成功の鍵
- 頻繁に使わないものは
disable-model-invocation: trueに設定 - チーム共有はプロジェクトスキル（
.claude/skills/）を使う
Claude.mdに長い手順が溜まってきたら、それをSKILL.mdに切り出すだけでも大きな効果があります。
関連記事
具体的にどんな場面でSkillsを使うべきか、ユーザー別の活用シーンを7パターン解説しています。
-->
コメント