Skillsとは — 繰り返し作業を定型化する「業務マニュアル」

Skillsは、特定タスクの「手順書・チェックリスト・テンプレート・補助ファイル」を1つのフォルダにまとめ、必要なときだけClaudeに読み込ませる仕組みです。`/skill-name` と入力して明示的に呼び出すことも、会話の文脈からAIに自動選択させることもできます。

Skillsとナレッジの違い

Skillsナレッジ
一言でいうとClaudeにどう作業してほしいかClaudeに何を知っておいてほしいか
役割特定タスクの実行手順事実・背景・素材・基準などの判断材料
例セールスレター添削手順、レポート作成手順商品情報、価格、顧客ペルソナ、ブランドトーン

この2つを組み合わせる——つまりナレッジを参照するSkillsを作ると、知識を「読ませる」だけでなく「使える手順」に変換できます。これが業務定型化の核心です。

Skillの構成とSKILL.mdの書き方

Skillは、プロジェクト用なら `./.claude/skills/`、全プロジェクト共通なら `~/.claude/skills/` の下に、スキルごとのフォルダとして配置します。

Skillフォルダの構成
skill-name/
├── SKILL.md      … Skillの本体（必須）
├── templates/    … 出力フォーマットや文章の型
├── references/   … 判断基準・前提知識・ルール・用語集
├── examples/     … 良い例・悪い例・完成例
└── scripts/      … 実行スクリプト
SKILL.mdの書式
---
name: skill-name
description: スキルが何をするのか、どんな状況・依頼で使うのか
---

（ここに実際の手順を書く）

冒頭のフロントマター（name + description）は特に重要です。AIが「このスキルを使うべきか」を判断する材料はdescriptionなので、どんな状況・どんな依頼のときに使うのかまで具体的に書いてください。自動で呼び出されるかどうかは、descriptionの書き方に大きく依存します。

段階的開示（Progressive Disclosure）の仕組み

項目読み込みタイミング
フロントマター（name + description）セッション開始時に常に読み込み
SKILL.md本文スキル起動時に読み込み
補助ファイル（references/ 等）必要に応じて読み込み

この3段階の読み込みにより、「必要な情報を、必要なときに、必要な分だけ」AIに渡せます。コンテキストウィンドウ（AIが一度に処理できる情報量）の節約こそがSkillsの設計思想であり、コンテキストエンジニアリングの実践形です。

公式ベストプラクティスから押さえるべきポイント

  • 参照は1階層まで — SKILL.md→詳細→さらに詳細…と深くネストさせず、SKILL.mdから各参照ファイルへ直接リンクする
  • 複雑な業務はチェックリスト化する — 明確なステップに分解し、進捗を確認できる形にする
  • 出力形式が重要ならテンプレートを与える — 型を渡せば出力のブレが激減する
  • 「最新情報そのもの」を直書きしない — 価格・キャンペーン・実績数値などの変わる情報は「references/current-campaign.md を確認する」のように参照先を書く（SSOTの原則）
  • SKILL.md本文は500行以下を目安に — 長くなったら補助ファイルに分割する
  • 高リスク作業は「計画→検証→実行」に分ける — いきなり実行させず、計画を作らせて検証してから実行する

作り方の実際 — 「成功体験の文書化」であって「仮説の文書化」ではない

Skillsをゼロから頭で設計するのは失敗のもとです。当社の研修で教えている手順は次のとおりです。

  1. 1まず個別タスクとして、Claude Codeと対話しながら試行錯誤し、成功する手順を見つける
  2. 2同じタスクが2回以上発生したら、「今やった手順をスキル化して」と伝える（スキルの雛形はClaude Code自身が作ってくれます）
  3. 3別のケースにも適用してみて、うまく動くか確かめる
  4. 4うまく動かなければ、AIに原因を特定させて改善させる

Skillsは成功体験の文書化であって、仮説の文書化ではありません。自分で実際に手を動かして検証した量に、Skillsの精度は比例します。裏を返せば、業務の手順とノウハウが言語化できている人ほど、質の高いSkillsを量産できます。

研修現場からの実感

非エンジニアの方でも、「自分が新人に教えるつもりで手順を書く」という感覚をつかむと一気に上達します。Skillsづくりの本質はプログラミングではなく、業務の言語化だからです。

Claude Codeを組織に定着させたい企業様へ。AI Orchestraの法人研修・伴走支援をご覧ください。

Claude Code研修の詳細を見る無料相談を申し込む

次のステップ — ハーネス全体の中でSkillsを位置づける

Skillsは4つのハーネス（CLAUDE.md・Skills・サブエージェント・hooks）の1つです。毎回読むべき方針はCLAUDE.mdへ、専門作業の分業はサブエージェントへ——全体の設計はClaude Codeのハーネスとはをご覧ください。