Skillsは『再利用可能な手順を少ないトークンで呼び出す仕組み』
Claude CodeのSkillsは、再現性のある手順や規約を「必要なときだけ読み込む」形で組み込む仕組みです。公開情報をもとにすると、各Skillの最小要約は30〜50トークン程度で、必要に応じてフルの内容が読み込まれる設計とされています。本記事では、Skillsの基本、作り方、現場で役立つパターン、最小構成のおすすめを編集部の視点で整理します。ツールの仕様は変化するため、最新は公式情報をご確認ください。
Skillsで解決すること
(1) 繰り返し手順の標準化：「PR作成手順」「リリース手順」等を共通化。(2) チームの作法を残す：コードレビュー基準・テスト方針等。(3) 少トークン：常時読み込みではなく必要時のみ展開。(4) 属人化の解消：Skillsで誰でも同じ手順を実行できる。(5) OSSのナレッジを取り込み：公開Skillを利用・改変。Claude CodeのMCPサーバ活用 もご参考に。
Skillsの作り方の基本
(1) 1つの目的に絞る：「PR作成」「マイグレーション作成」等。(2) 短い要約と詳細を分ける：30〜50トークンの要約と、本体の手順。(3) 具体的なコマンド・例を入れる：抽象論ではなく実行可能な形に。(4) 条件分岐を明示：「TypeScriptプロジェクトの場合」等。(5) 更新可能に：リポジトリで管理し、改善を続ける。Skillsは「人間向けのドキュメント＋AI向けの指示」の両面を持つよう設計します。生成AIを活用した学習法 も併せてご参考に。
現場で役立つSkillsパターン
(1) PR作成・レビュー対応：title・description・チェックリストの標準化。(2) コミットメッセージ規約：Conventional Commitsの自動適用。(3) テスト戦略：「新機能を追加したら必ずテストを書く」等のルール。(4) Lint・型・フォーマット：プロジェクト固有の設定。(5) リリース・デプロイ手順：段階的なリリースの手順化。GitHub Actions学習 と組み合わせると強力です。
最小構成のおすすめ
多くの開発者は3〜5個のSkillsから始めます：(1) PR作成Skill：全プロジェクトで有用。(2) テスト方針Skill：プロジェクト固有のテストルール。(3) コードスタイルSkill：naming・ファイル配置等の規約。(4) リリースSkill：段階デプロイ・ロールバック手順。(5) ドメイン知識Skill：業務固有のルール。全部入れるよりも、よく使うものを少数精鋭で運用するほうが効果的です。
SkillsとCLAUDE.mdの使い分け
(1) CLAUDE.md：常時読み込まれるプロジェクト全体の指示。(2) Skills：必要なときだけ読み込まれる手順・規約。(3) 使い分けの目安：「全タスクで必要→CLAUDE.md」「特定タスクで必要→Skill」。(4) CLAUDE.mdは短く保つ：詳細はSkillsに分離してトークンを節約。(5) Skillsで属人化を解消：チーム共通の作法を残す。Claude CodeのHooks活用 もご参考に。AI時代のエンジニアキャリア も合わせてご活用ください。