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 sessi