Claude CodeのSkills（エージェントスキル）とは？作り方と活用例を解説

Claude Codeを使い込んでくると、「毎回同じ手順を長文プロンプトで指示している」ことに気づきます。記事作成の手順、リリース前チェック、定型レポートの生成——。この「いつもの手順」をClaude Code自体に覚えさせる仕組みがSkills（エージェントスキル）です。

当社もブログ記事の量産やSEOワークフローをスキル化して運用しており、体感として「指示の再現性」が別物になります。この記事では、Skillsの仕組み、SKILL.mdの書き方、類似機能（スラッシュコマンド・サブエージェント・CLAUDE.md）との使い分けを解説します。

Agent Skillsとは？「手順書をAIに渡す」仕組み

Skillsは、特定のタスクの手順・ルール・参考資料をフォルダにまとめておき、Claude Codeが必要なときに読み込んで実行する仕組みです。実体はシンプルで、プロジェクトの .claude/skills/スキル名/ フォルダに SKILL.md というMarkdownファイルを置くだけ。ユーザーが /スキル名 と入力して呼び出せるほか、説明文（description）に合致するタスクではClaudeが自ら参照します。

ポイントは「必要なときだけ読み込まれる」ことです。すべての指示をCLAUDE.mdに書くと常にコンテキストを消費しますが、Skillsは呼び出されるまで名前と説明文しか読み込まれません。手順が長大でも、普段の会話を圧迫しないのが設計上の利点です。

SKILL.mdの書き方：最小構成はこれだけ

SKILL.mdは、YAMLフロントマター（name・description）と本文の手順で構成します。

---
name: weekly-report
description: 週次レポートを生成する。/weekly-report で呼び出し。
---

# 週次レポート作成スキル

## 手順
1. data/sales.csv を読み込み、前週比を計算する
2. 以下のテンプレートでMarkdownレポートを作成する
   （テンプレート省略）
3. reports/ フォルダに YYYY-MM-DD.md として保存する

## ルール
- 数値は千円単位で丸める
- 前週比が±10%を超えた項目には必ずコメントを付ける

コツは3つあります。

• descriptionは「いつ使うか」まで書く：Claudeが自動でスキルを選ぶ判断材料になるため、「◯◯のときに使う」を含めると発動精度が上がります
• 判断基準を数値・条件で書く：「いい感じに」ではなく「±10%を超えたら」。手順書の質がそのまま出力の質になります
• 補助ファイルを同梱できる：スキルフォルダにはテンプレートやスクリプトも置けます。「このシェルスクリプトを実行して画像を生成する」のように、決まった処理はコード化しておくと再現性が完璧になります

実例として、当社のSEO記事作成スキルでは「キーワード調査 → 画像生成APIの呼び出しコマンド → frontmatterの規則 → ビルド検証 → 公開前の確認」までを1つのSKILL.mdに定義しています。誰が（どのセッションが）実行しても同じ品質の記事制作フローが走ります。

類似機能との使い分け：CLAUDE.md・スラッシュコマンド・サブエージェント

• CLAUDE.md：常に読み込まれる「プロジェクトの憲法」。コーディング規約や禁止事項など、全タスク共通の前提を書く
• Skills：呼び出されたときに読み込まれる「タスク別の手順書」。定型ワークフローの再現に使う。カスタムスラッシュコマンドの発展形として、資料同梱と自動発動に対応した位置づけ
• サブエージェント：別のコンテキストで並行作業させる「部下」。大量のファイル調査など、メインの会話を汚したくない作業に使う（詳しくはサブエージェント解説）
• Hooks：ツール実行の前後に必ず走る「自動チェック」。Claudeの判断に任せず強制したい処理はHooksで

迷ったらこう考えてください。「毎回のルール」はCLAUDE.md、「時々使う手順」はSkills、「並行させたい作業」はサブエージェント、「絶対に実行させたい検査」はHooksです。

ビジネス活用例：開発以外でも効く

Skillsはコーディング専用ではありません。中小企業の実務では、むしろ非開発業務での効果が分かりやすいです。

• コンテンツ制作：ブログ記事の執筆規則（文字数・見出し構成・内部リンクのルール・画像生成手順）をスキル化し、記事品質を標準化
• 定型文書:見積書・議事録・週次レポートの生成手順とテンプレートを固定
• チェックリストの実行：リリース前確認・請求前確認など、「毎回同じ確認項目」を自動実行させる

チーム利用では、スキルフォルダをGitリポジトリに含めるだけで全員に配布されます。個人のプロンプト術が、バージョン管理された会社の資産に変わる——これがSkillsの本質的な価値です。

つまずきやすいポイント

• スキルが発動しない：descriptionが抽象的すぎるのが典型原因。「いつ使うか」を具体的に書き直す。確実に使いたいときは /スキル名 で明示呼び出し
• 手順を詰め込みすぎる：1スキル1タスクが原則。長くなったら別スキルに分割するか、詳細を別ファイルに切り出して参照させる
• 秘密情報を書かない：APIキーなどは .env から読む手順を書き、SKILL.md自体には値を書かない（Gitで共有されるため）

まとめ：プロンプトを「書く」から「仕組みにする」へ

Agent Skillsは、Claude Codeへの指示を再現可能な手順書として資産化する仕組みです。まずは「毎回同じ長文指示をしているタスク」を1つ選び、SKILL.mdに書き起こすところから始めてください。導入自体はClaude Codeの始め方を済ませていれば5分です。

「自社の業務フローをAIで仕組み化したい」「コンテンツ制作や定型業務のスキル設計を手伝ってほしい」という方は、当社のIT顧問・AI導入支援でご相談ください。自社で実運用しているノウハウをもとにご支援します。