Claude CodeのAgent Skillsとは?よく使う業務手順をAIに覚えさせる方法

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.mdAgent 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を活用する基本的な考え方です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次