Claude Codeを使い続けていると、同じような指示を何度も入力することがあります。
例えば、コード変更後のチェック、データの週次分析、記事の表記確認などです。
1回だけなら通常のプロンプトで問題ありません。しかし、毎週・毎日繰り返す作業なら、そのたびに手順を説明するのは非効率です。
そこで役立つのが、Claude CodeのAgent Skills(エージェントスキル)です。
Agent Skillsでは、作業手順や判断基準をSKILL.mdというファイルに保存し、必要なときに再利用できます。
今回は、Agent Skillsの仕組み、CLAUDE.mdとの違い、基本的な作成方法を整理します。
この記事で分かること
- Agent Skillsとは何か
- SKILL.mdの基本構造と作り方
- CLAUDE.mdとの違い
- 個人用・プロジェクト用Skillの保存場所
- Skill化に向いている業務
Agent Skillsとは?
Agent Skillsとは、Claudeに繰り返し実行してほしい仕事の手順を保存する仕組みです。
例えば、コードレビューのたびに次のような指示をしているとします。
- Gitの変更内容を確認する
- 重要な変更点を整理する
- 不具合につながるリスクを調べる
- 必要なテストを確認する
- 指定形式で結果を報告する
この一連の手順をSkillとして登録すれば、毎回同じ指示を書く必要がなくなります。
Claude Codeでは、Skillを/skill-nameのような形式で呼び出せます。
また、Skillの説明と依頼内容が一致すれば、Claudeが必要なSkillを判断して利用することもできます。
つまり、Agent SkillsはAI向けの業務マニュアルに近い仕組みです。
Skillの中心になるSKILL.md
Skillを作成するとき、中心になるのがSKILL.mdというMarkdownファイルです。
例えば、週次レポート用のSkillなら、次のような構成にできます。
.claude/
└── skills/
└── weekly-report/
└── SKILL.md
SKILL.mdには、Skillの名前、説明、実行手順などを記載します。
---
name: weekly-report
description: 週次データを比較してレポートを作成する
---
# Weekly Report
1. 最新データを確認する
2. 前週データと比較する
3. 大きな変化を抽出する
4. 原因候補を整理する
5. 指定形式でレポートを作成する
冒頭のnameはSkillの名前、descriptionは用途を説明する項目です。
特にdescriptionは、Claudeがどのような依頼でSkillを使うべきか判断する材料になります。
最初から複雑なプログラムを書く必要はありません。
まずはMarkdownで作業手順を整理するところから始められます。
CLAUDE.mdとは何が違う?
Claude Codeには、プロジェクトの基本ルールを記載するCLAUDE.mdもあります。
両者の違いは、常に守るルールか、特定の仕事で使う手順かという点です。
| 項目 | CLAUDE.md | Agent Skills |
|---|---|---|
| 主な役割 | 基本方針・共通ルール | 特定業務の実行手順 |
| 内容の例 | 既存データを削除しない | 週次データを分析する |
| 利用方法 | プロジェクトの指示として参照 | 必要な場面で呼び出す |
| 管理するもの | 働き方の基本 | 仕事の進め方 |
例えば「既存データを勝手に削除しない」はCLAUDE.mdに適しています。
一方、「毎週データを取得し、前週と比較して報告する」はSkillに向いています。
CLAUDE.mdに長い業務手順を大量に書くより、Skillへ分離した方が管理しやすくなります。
Skillは必要なときに読み込まれる
Agent Skillsには、コンテキスト管理の面でも利点があります。
コンテキストとは、Claudeが作業時に参照する指示や会話、資料などの情報です。
例えば10種類の業務手順をすべてCLAUDE.mdに記載すると、今回使わない手順まで参照対象になります。
Skillでは、まず名前や説明などから利用可能なSkillを把握し、必要になったときに本文を読み込む仕組みが使われます。
これにより、長い手順や参考資料を用途別に分離できます。
ただし、Skillを登録しただけで、すべての作業が自動化されるわけではありません。実際の作業には、必要なファイルやツールへのアクセスも必要です。
個人用Skillとプロジェクト用Skill
Skillは保存場所によって利用範囲を分けられます。
個人用Skill
~/.claude/skills/
複数のプロジェクトで共通して使いたい手順を保存します。
例えば、文章チェックやGit差分レビューなどです。
プロジェクト用Skill
<project>/.claude/skills/
特定のプロジェクトだけで使う手順を保存します。
例えば、専用データベースの更新手順や、そのシステム固有のリリース確認などです。
プロジェクト用Skillは、Gitで管理してチーム内で共有することもできます。
Skillには関連ファイルも保存できる
Agent Skillsは、SKILL.mdだけでなく、補助資料やスクリプトを組み合わせることもできます。
例えば、次のような構成です。
weekly-analysis/
├── SKILL.md
├── reference.md
├── template.md
└── scripts/
└── collect_data.py
SKILL.mdには全体手順、reference.mdには判断基準、template.mdには出力形式を記載します。
scriptsフォルダには、データ取得などの処理用プログラムを保存できます。
このように構成すれば、単なるプロンプトの保存ではなく、業務に必要な資料や処理をまとめたパッケージとして管理できます。
Skill化に向いている仕事とは?
すべての作業をSkillにする必要はありません。
1回しか使わない指示なら、通常のプロンプトで十分です。
一方、次のような仕事はSkill化を検討する価値があります。
- 毎週のデータ分析・レポート作成
- コードレビューやリリース前チェック
- 記事の表記・品質確認
- 定型的なAPIデータ取得
- ファイル整理や定期的な検証
判断基準は、同じ手順を繰り返し説明しているかどうかです。
ただし、Skill化しても結果が必ず同じになるとは限りません。重要な判断基準や出力形式は明確に記載し、実行結果を確認する必要があります。
最初から完璧なSkillを作る必要はない
Skillは、実際に使いながら改善できます。
例えば最初は「データ取得→前週比較→結果報告」という簡単な手順だけでも構いません。
実行してみて、異常値の定義が曖昧だったり、必要な指標が不足していたりすれば、SKILL.mdを修正します。
また、Skillの作成自体をClaude Codeへ依頼することもできます。
例えば「Gitの変更内容を確認し、リスクと未実施テストを整理するSkillを作ってください」と指示する方法です。
Claudeが作成した内容を人間が確認し、必要に応じて修正します。
作成→実行→確認→改善という流れで、業務手順を少しずつ整備できます。
まとめ|繰り返す仕事を業務手順として残す
Claude CodeのAgent Skillsは、繰り返し利用する指示や作業手順をSKILL.mdとして保存し、再利用するための仕組みです。
CLAUDE.mdには基本ルールを記載し、Skillsには特定業務の手順を保存します。
さらに、関連資料やスクリプトも組み合わせれば、実務で使う作業パッケージとして管理できます。
最初から多くのSkillを作る必要はありません。
同じ指示を繰り返すようになったら、その仕事をSkill化できないか考えてみるとよいでしょう。
一度整理した業務手順を保存し、実践しながら改善していく。
これがAgent Skillsを活用する基本的な考え方です。

