Skills — 再利用可能な知識とワークフロー

スレッド4で概観した6つの拡張レイヤーのうち、最も手軽に始められるのがSkillsだ。 CLAUDE.mdが「プロジェクト全体の指示書」だったのに対し、Skillsは特定の知識やワークフローを再利用可能なモジュールとして切り出す仕組みである。

たとえば「デプロイ手順」「PRレビューの観点」「コード説明のフォーマット」といったものを一度スキルとして定義すれば、プロジェクトやチームをまたいで何度でも呼び出せる。 本スレッドでは、スキルの設計思想から実践的な作成方法、チームへの展開まで一通り扱う。

Section 5.2

5.2バンドルスキル — 最初から使える組み込みスキル

Claude Codeにはあらかじめ組み込まれたバンドルスキル（bundled skills）が付属しており、インストール直後から利用できる。 これらはビルトインコマンド（/helpや/compactなど固定ロジックを実行するもの）とは異なり、プロンプトベースで動作する。つまり、Claudeに詳細な手順書（playbook）を渡し、Claudeがツールを駆使して柔軟に作業するという設計だ。

Section 5.4

5.4スキルの配置と優先順位

スキルをどこに置くかで、誰がそのスキルを使えるかが決まる。

同名のスキルが複数のスコープに存在する場合、Enterprise > Personal > Projectの優先順位で上位が勝つ。 Pluginスキルはplugin-name:skill-nameという名前空間を使うため、他のレベルと衝突しない。

モノレポでの自動検出

サブディレクトリにある.claude/skills/も自動的に検出される。 たとえばpackages/frontend/のファイルを編集中であれば、packages/frontend/.claude/skills/にあるスキルも利用可能になる。モノレポ（monorepo：複数パッケージを1リポジトリで管理する構成）に適した設計だ。

ディレクトリ構成

my-skill/
├── SKILL.md           # メイン指示（必須）
├── template.md        # Claudeが埋めるテンプレート
├── examples/
│   └── sample.md      # 期待されるフォーマットの例
└── scripts/
    └── validate.sh    # Claudeが実行するスクリプト

SKILL.mdのみが必須で、その他の補助ファイルは任意だ。 補助ファイルがある場合は、SKILL.md内からリンクしておくとClaudeが必要に応じて読み込める。 SKILL.mdは500行以内に収め、詳細なリファレンスは別ファイルに分離するのが推奨される。

Section 5.6

5.6引数と動的コンテキスト

5.6.1 $ARGUMENTS による引数渡し

スキル実行時に渡されたテキストは$ARGUMENTSプレースホルダーで受け取れる。

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---

Fix GitHub issue $ARGUMENTS following our coding standards.

1. Read the issue description
2. Understand the requirements
3. Implement the fix
4. Write tests
5. Create a commit

/fix-issue 123と実行すると、Claudeには「Fix GitHub issue 123 following our coding standards...」というテキストが渡される。 個別の引数にアクセスするには$ARGUMENTS[N]（0ベースインデックス）または省略形の$Nを使う。

5.6.2 文字列置換変数

5.6.3 動的コンテキスト注入（!コマンド構文）

!`command`構文を使うと、スキルの内容がClaudeに送られる前にシェルコマンドを実行し、その出力をスキル本文に埋め込める。これは「前処理」であり、Claude自身が実行するのではない。

---
name: pr-summary
description: Summarize changes in a pull request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Your task
Summarize this pull request...

このスキルを実行すると、まずgh pr diff等のコマンドが先に走り、その出力結果がスキル本文に差し込まれた状態でClaudeに渡される。

Section 5.8

5.8ツール制限とパーミッション

allowed-toolsフィールドで、スキル実行中にClaudeが使えるツールを限定できる。これにより、スキルの安全性を設計段階でコントロールする。

---
name: safe-reader
description: Read files without making changes
allowed-tools: Read, Grep, Glob
---

このスキルが有効な間、Claudeはファイル読み取り系のツールだけを許可なしで使え、書き込み系のツールは使えない。

パーミッションルールによるスキルアクセス制御

/permissionsコマンドで、Claudeがどのスキルを呼び出せるかをさらに細かく制御できる。

Section 5.10

5.10実践例 — ビジュアル出力を生成するスキル

スキルはマークダウンの指示だけでなく、スクリプトをバンドルして実行させることもできる。 公式ドキュメントで紹介されている「コードベースビジュアライザー」を例に、スキルの設計パターンを見てみよう。

構成

~/.claude/skills/codebase-visualizer/
├── SKILL.md              # 指示：スクリプトの実行方法と出力説明
└── scripts/
    └── visualize.py      # Pythonスクリプト：HTMLツリービュー生成

SKILL.md の内容

---
name: codebase-visualizer
description: Generate an interactive collapsible tree
  visualization of your codebase. Use when exploring a
  new repo, understanding project structure, or
  identifying large files.
allowed-tools: Bash(python *)
---

# Codebase Visualizer

Run the visualization script from your project root:

```bash
python ~/.claude/skills/codebase-visualizer/scripts/visualize.py .
```

This creates `codebase-map.html` and opens it in your browser.

ポイントは3つだ。

このパターンは、依存グラフの可視化、テストカバレッジレポート、APIドキュメント生成、データベーススキーマの図示など、あらゆる「コードを分析して視覚的な出力を生成する」用途に応用できる。

Section 5.12

5.12まとめ — スキル設計のチェックリスト

本スレッドの内容を振り返る。

Series Navigation

他シリーズの関連ガイド