Claude Code Skills で自社専用ナレッジを与える — SKILL.md の書き方

Skills は CLAUDE.md と違い「必要なときだけ自動ロード」される拡張機構。社内ライブラリの使い方、自社の API 規約、特定ドメインの専門知識を与えても CLAUDE.md を肥大化させない。本稿は公式の Skills ドキュメントを元に SKILL.md の最小構成と発火条件の設計を整理する。

なぜ Skills が CLAUDE.md より優れる場面があるか

CLAUDE.md は毎セッションで読まれる。短く保たないと Claude がルールを無視し始める（公式警告）。

一方 Skills は **description に書いた発火条件にマッチしたときだけ** ロードされる。10 個 Skill を用意しても、関係ないタスクでは 1 つもロードされない。

公式は次のように使い分けを推奨：

CLAUDE.md is loaded every session, so only include things that apply broadly. For domain knowledge or workflows that are only relevant sometimes, use skills instead.

最小構成

.claude/skills/
  api-conventions/
    SKILL.md

---
name: api-conventions
description: REST API design conventions for our services
---
# API Conventions
- Use kebab-case for URL paths
- Use camelCase for JSON properties
- Always include pagination for list endpoints
- Version APIs in the URL path (/v1/, /v2/)

`description` に書いた内容が発火条件。Claude がタスクの内容を見て「これは API 規約が関係しそうだ」と判断したときに自動でロードされる。

補助ファイルの配置

SKILL.md の隣に置けば、Claude が必要に応じて参照する。