Claude Skills で仕事を型化する
要約 — このレッスンの要点
- Agent Skills はSKILL.md という Markdown ファイルで定義する Claude の拡張機能だ。
- **Progressive Disclosure(段階的開示)**により、必要なスキルだけがその場でロードされるため、コンテキスト消費を抑えられる。
- スキルには「タスクの知識・ツール定義・スクリプト」をまとめて記述し、再利用可能な型として蓄積する。
- Claude.ai / Claude Code / Claude Agent SDK で共通サポートされており、環境を選ばず使える。
- 繰り返し作業を一度スキルとして型化しておくと、毎回の指示コストが大幅に下がる。
Agent Skills とは
Agent Skills(エージェント・スキル)は、Claude に特定タスクの知識・ツール定義・実行スクリプトをまとめて読み込ませる拡張機能です。 「このプロジェクトでいつも使う作業」を一度スキルとして書いておくと、 Claude は必要なときだけそのスキルを参照して動くようになります (詳細記事: Agent Skills の作り方)。
汎用的な Claude を、特定の業務に強い専門エージェントに変える仕組みと考えると分かりやすいです。
SKILL.md の最小構成
スキルは YAML フロントマター付きの Markdown ファイル(SKILL.md)で定義します。
---
name: api-conventions
description: 当社 REST API の設計規約
---
# API 規約
- URL パスは kebab-case
- JSON フィールドは camelCase
- エラーは { "error": { "code": "", "message": "" } } 形式
name: スキルの識別子。description: Claude がスキルを選ぶ際に参照する説明文。
本文に具体的な指示・ルール・コード例を記述します。
Progressive Disclosure とは
Agent Skills の中核的な設計思想が Progressive Disclosure(段階的開示) です。
スキルを 100 個定義しても、Claude は最初にすべてをコンテキストウィンドウに読み込みません。
まず各スキルの name と description のみを参照し、
タスクに関連すると判断したスキルの本文だけを必要に応じて読み込みます。
これにより、スキルを増やしてもコンテキストが膨らまず、 処理コストと速度への影響を最小化できます。
スキルの作り方
- プロジェクトの
.claude/skills/ディレクトリ(または任意のスキルフォルダ)を用意する。 - 各スキルごとにサブフォルダを作り、その中に
SKILL.mdを置く。 SKILL.mdに YAML フロントマター(name・description)と本文を記述する。- 必要であればスクリプトや設定ファイルを同じフォルダに置く。
- Claude Code や API から、そのスキルフォルダを指定して呼び出す。
どんな仕事に向いているか
- コーディング規約の適用: コードレビューのたびに同じ規約を貼らなくて済む
- ライティングスタイルの統一: 文体・表記ルールをスキルとして定義
- 社内プロセスの自動化: 申請フォームへの入力手順やテンプレートをスキルに
- データ分析のテンプレート化: 「このデータは必ずこの形で前処理する」をスキルとして型化
参考: 詳細記事
実例・自作手順・良いスキルの共通点については 「Agent Skills の作り方 — 5 分で理解する基礎とテンプレート」 で詳しく解説しています。
