「エージェントを作るな、スキルを作れ」の真意｜Agent Skills作り方

Claude Skillsの機能全体像と最新のSkills 2.0世代の変更点はClaude Skills完全ガイドを参照してください。本記事はAgent Skillsの作り方と技術仕様に特化しています。

最終更新：2026年9月7日（SKILL.mdのfrontmatter仕様・ライブ変更検知・skill-creatorのevalsを2026年9月時点の公式ドキュメントで再確認）

まず結論から。「エージェントを作るな、スキルを作れ」とは、営業用・経理用・法務用と業務ごとに別々のAIエージェントを作り込むのをやめ、汎用エージェント（Claude Code・Claude・Claude Agent SDKなど）1つに、業務の手順書＝スキルを足していけ、というAnthropicの設計思想です。出典は、Anthropicのエンジニア Barry Zhang氏・Mahesh Murag氏によるAI Engineerカンファレンス講演「Don’t Build Agents, Build Skills Instead」（2025年12月・YouTube公開）で、日本語の言い回しはITmedia TechTarget（2026年5月15日・8月6日）の見出し訳です。以下、真意・作り方・サブエージェントとの使い分け・最初の題材5つを2026年8月時点の公式情報で整理します。

「この資料、また同じフォーマットで作り直してくれる？」——先日、ある顧問先の管理部門で交わされていた会話です。月初の請求書チェック、月次レポートの体裁整え、議事録のテンプレ流し込み。どれも「やり方」は決まっているのに、毎回担当者がゼロから手を動かしている。AIに頼もうにも、毎回「こういうルールで」「この列はこう」と長々と説明し直していて、結局そんなに楽になっていない、と。

「ChatGPTもClaudeも使ってはいるんですけど、毎回同じ指示を打ち込むのが地味に面倒で。結局Excelのマクロと変わらないんじゃないかって気もしてきて……」

この「毎回同じ説明をやり直している」という感覚、ものすごくよく分かります。100社以上のAI研修・導入支援をしてきて、いちばん多い”伸び悩み”がこれなんです。プロンプトを工夫するスキルは身につくのに、その工夫が個人のメモ帳の中に閉じてしまって、組織の資産にならない。

その壁を正面から壊しにきたのが、今回紹介するClaude Agent Skills（エージェント・スキル）です。ざっくり言うと「繰り返す作業の手順書と道具一式を、フォルダ1つにまとめてAIに渡しておく」だけ。一度作れば、次からは「あのスキルでやって」と言うだけで、毎回同じ品質の成果物が返ってきます。しかもAnthropicは、Excel・PowerPoint・Word・PDFを扱う既製スキルを公式に配っています。この記事では、非エンジニアの業務自動化という視点を主役に、仕組みの理解から、コピペで使える設定例、そして中小企業が今日から踏める一歩までを全公開します。

AIエージェントそのものの全体像や導入ステップを先に押さえたい方は、AIエージェント導入完全ガイドで体系的にまとめていますので、あわせてどうぞ。

そもそも「Agent Skills」とは何か——5分で腹落ちする説明

難しい言葉を一回脇に置いて、たとえ話から入ります。

あなたの会社に、優秀だけど記憶を毎朝リセットされてしまう新人がいると想像してください。能力は高い。でも、昨日教えた「うちの請求書のルール」を翌朝には忘れている。毎日イチから説明するのは骨が折れますよね。

そこで、よくやる業務ごとに「この作業はこう進める」という1枚の手順書を作り、机の引き出しに入れておく。新人は「請求書チェックして」と言われたら、その引き出しから手順書を取り出して読み、書いてある通りに進める。これが Agent Skills の発想そのものです。Claude（AI）が「記憶を毎朝リセットされる優秀な新人」、手順書が SKILL.md、引き出しが ~/.claude/skills/ というフォルダ、というわけです。

Anthropic公式の定義はこうなっています。

「スキルとは、指示・スクリプト・リソースを整理したフォルダであり、エージェントがそれを動的に発見して読み込み、特定タスクで高い性能を発揮できるようにするものだ」（Anthropic Engineering, 2025）

ポイントは「動的に発見して読み込む」の部分です。何百個スキルを入れておいても、Claudeは全部を常に読むわけではありません。最初は各スキルの「名前」と「説明文」だけを見ておき、今のタスクに関係しそうなものだけを、必要になった瞬間に開く。これをプログレッシブ・ディスクロージャー（段階的開示）と呼びます。だから何十個入れても重くならないし、AIの”思考のメモリ”（コンテキスト）を無駄に食わないんです。

スキルの中身は「手順書」＋「道具箱」の2つだけ

スキルフォルダの構造はびっくりするほどシンプルです。最低限、必要なのは SKILL.md という1ファイルだけ。これに加えて、確定的な処理をさせたいときは scripts/ フォルダに実行ファイルを置きます。

なぜわざわざスクリプトを分けるのか。ここが地味に大事なところです。AIは文章を作るのは得意ですが、「100行のデータを正確に並べ替える」みたいな機械的な処理は、トークンを使って一文字ずつ考えると遅くて高くつきます。Anthropicの説明でも、リストの並べ替えを「トークン生成でやるのは、並べ替えアルゴリズムをただ実行するよりはるかに高コストだ」と明言しています。だったら並べ替えはスクリプトに丸投げして確実にやらせ、AIは判断が必要なところに集中させる。この役割分担が、スキルの賢いところなんです。

非エンジニアの方へ：「スクリプトなんて書けない」と思うかもしれませんが、安心してください。後述するように、スクリプトはClaude自身に書かせることができます。あなたが用意するのは「どういう手順でやってほしいか」という日本語の説明だけで十分なケースが多いです。

2026年9月時点の仕様早見表——SKILL.mdのfrontmatterと「使える場所」

Agent Skillsはオープン仕様（agentskills.io）として公開されています。2026年9月時点の公式ドキュメントで確認できる要点は次のとおりです。

任意項目はlicense・compatibility・metadata・allowed-toolsの4つで、本文は500行以内が目安。他の場所でも使い回したいスキルは、この仕様で決まった6項目だけで書くのが安全です。

「エージェントを作るな、スキルを作れ」――なぜAnthropicはこう言うのか

「エージェントを作るな、スキルを作れ」という言葉が、Claude Code界隈で広まっています。この言葉の元になっているのは、Agent Skillsの開発を担当したAnthropicのエンジニア2名――Barry Zhang氏とMahesh Murag氏――が、AI Engineerカンファレンスで行った講演「Don’t Build Agents, Build Skills Instead」（2025年12月公開）です。日本では技術メディアのITmedia（2026年8月6日）が「Claude Codeでは『エージェントを作るな、スキルを作れ』 Anthropicが示すAI構築術」という見出しでこの考え方を紹介し、広く知られるようになりました。この講演はAI EngineerのYouTubeチャンネルで公開されており（約16分・報道では2025年12月9日公開）、ITmedia TechTargetは2026年5月15日の記事「なぜAnthropicはClaude Codeで『エージェントを作るな、スキルを作れ』と言うのか」でこの動画を出典として明示しています。

つまり英語の講演タイトル「Don’t Build Agents, Build Skills Instead」はAnthropic社員の一次発言として確認でき、日本語の「エージェントを作るな、スキルを作れ」はその見出し訳です。Anthropicの公式ブログ・公式Xでこのスローガンをそのまま掲げた投稿は、2026年8月時点で公式の一次発言として確認できていません（公式ブログ（2025年10月16日）はスキルを「Claudeが必要なときに読み込める、指示・スクリプト・リソースをまとめたフォルダ」と定義しており、スローガンではなく機能説明が中心です）。

この主張の土台になっているのが、Anthropic公式エンジニアリングブログが2025年10月16日に公開した記事「Equipping agents for the real world with Agent Skills」（著者：Barry Zhang・Keith Lazuka・Mahesh Murag）です。ここでAnthropicは要旨として次のように説明しています。

• LLMには「推論力」と「接続性」（MCP・ツール・API）はすでにある。足りないのは、ドメインごとの実務知識をエージェントが安定して再利用できる形にすることだ、という指摘
• タスクごとに専用エージェントを個別に作り込むと、開発・保守のコストが積み上がる。一方でスキルは「フォルダ1つ」の単位で共有・バージョン管理・使い回しができ、複数のエージェント基盤をまたいで再利用できる
• だからこそ、案件ごとに新しいエージェントを組み立てるより、手順・専門知識を「スキル」として資産化し、既存のエージェントに読み込ませる方が、開発効率でも保守性でも優れているという考え方

実務目線で言い換えると、「エージェントを作る」＝毎回ゼロから業務フローをコードで組み立てる作業で属人化・保守負担が大きくなりがちなのに対し、「スキルを作る」＝繰り返す業務をSKILL.mdという手順書に落とし込み、汎用エージェントに読み込ませる作業です。前者はエンジニアリソースが必要になりますが、後者は本記事でここまで解説してきた通り非エンジニアでも着手できます。中小企業にとっては、後者（スキルを作る）の方が現実的な出発点になります。

「エージェントを作るな」は「エージェントは不要」という意味ではない

誤解しやすいポイントですが、この言葉は「AIエージェントを使うな」という意味ではありません。Claude Code・Claude Agent SDKのような汎用のエージェント基盤自体は前提として使ううえで、「タスクごとに専用のエージェントをスクラッチで作り込む」のではなく、「既存の汎用エージェントにスキルを読み込ませて専門化する」方が投資対効果が高い、という開発方針についての主張です。エージェント基盤（土台）とスキル（専門知識のパッケージ）は役割が違う、と切り分けて理解するのが実務上は正確です。

「エージェントを作るな、スキルを作れ」を実務に落とすと何が変わるか——サブエージェント vs スキルの使い分け

Claude Codeには「スキル」のほかに「サブエージェント」（.claude/agents/に置く分業用の設定ファイル）があり、Claude Agent SDKで「専用エージェント」を作り込む道もあります。2026年9月時点の公式ドキュメントに沿って整理します。

「エージェントを作るな」が指しているのは主に右端の列、つまり業務ごとに専用エージェントをスクラッチで作り込むことです。サブエージェントは「汎用エージェントの中の分業」なので否定されていません。順番は、まずスキルで手順を資産化し、本筋と切り離したい調査やレビューが出てきたらサブエージェントに委任する。SDKでの作り込みは社外提供や無人運用が必要になってからです。

実は両者はつながっています。Claude Codeのスキルはfrontmatterにcontext: forkと書くと、SKILL.mdの内容を指示文としてサブエージェント側で実行できます（会話履歴は渡さず、結果だけ戻る）。逆に、サブエージェントの設定ファイルにskills項目でスキル名を列挙すると、起動時にそのスキルを読み込ませられます。「手順はスキルに書き、誰が実行するかはサブエージェントで決める」と分けておくと、同じ手順書を本筋でも分業でも使い回せます。サブエージェントの仕組みと業務例はサブエージェントとは｜AIエージェント並列活用の仕組みと業務例、Claude Codeでの設定はClaude Codeサブエージェントおすすめ完全ガイドを参照してください。

Anthropicが配る「既製スキル」——Excel・PPT・Word・PDFが標準装備

ここが今回いちばん中小企業に効く話です。Anthropicは、誰でも参考にできる既製（pre-built）スキルを公式リポジトリ（github.com/anthropics/skills）で公開しています。中でも実務直撃なのが、オフィス文書を扱う4つのスキルです。

これらは「Claudeの文書機能を裏で支えているスキル」そのものです。つまり、ClaudeがそれなりにキレイなExcelやPowerPointを作れるのは、こうしたスキルが内部で働いているから。Anthropicはその中身を、より複雑なスキルを作るときの参考実装として開発者向けに共有した、という位置づけです。

ひとつ正直にお伝えしておくべき点があります。リポジトリ内のスキルの多くはオープンソース（Apache 2.0ライセンス）ですが、このdocx・pdf・pptx・xlsxの4つは「ソース閲覧可（source-available）」で、厳密にはオープンソースとは区別されています。「デモ・教育目的で提供」という但し書きも付いています。商用でそのまま組み込む場合はライセンス表記を必ず確認してください。ここを曖昧にしたまま「無料で何でも使える」と説明すると後でトラブルのもとになるので、研修でも必ず釘を刺すポイントです。

PDFスキルに見る「段階的開示」の実例

PDFスキルは、段階的開示の良い見本になっています。中核の SKILL.md はあえて薄く保ち、「フォーム入力の細かい手順」は forms.md という別ファイルに切り出してある。普段はその別ファイルを読まず、実際にフォームを埋めるときだけClaudeが forms.md を開く。こうすることで、いつもの動作を軽く保ちつつ、いざというときの詳しさも担保しているわけです。

この「薄い本体＋必要時に開く詳細」の構造は、自社でスキルを作るときにもそのまま真似できます。1つのSKILL.mdに全部詰め込まず、頻度の低い例外対応は別ファイルへ。これだけで、AIの動作が軽く・安定します。

「Skills 2.0」とオープン標準化——2025年末からの動きを整理

Agent Skills は2025年末から立て続けに大きな節目を迎えました。時系列で整理します。

「オープン標準化」が地味にいちばん重要だと私は見ています。スキルの形式（SKILL.md ＋ scripts/）が特定の会社の独自仕様ではなく、業界共通の仕様になったということ。報道によれば、Anthropicが公開してから数日のうちに、Microsoft（VS Code）やOpenAI（ChatGPT・Codex CLI）が取り込み、最終的にCursorやGemini CLIなど多数のツールが同じ仕様を採用したとされています。

実務的に何がうれしいか。「いまClaude用に作ったスキルが、将来別のAIツールでも流用できる（可能性が高い）」ということです。中小企業がツール選定で一番こわいのは「特定ツールに縛られて乗り換えられなくなること」。共通仕様であれば、その不安がかなり和らぎます。

更新版 skill-creator（Skills 2.0）のポイント

「Skills 2.0」と呼ばれるのは、スキルを作るための公式ツール skill-creator が大幅にアップデートされたことを指します。Anthropic公式ブログ（2026年3月3日）で紹介されている主な機能はこうです。

• 評価テスト（evals）：作ったスキルがちゃんと意図通り動くかを、構造化したテストで採点できる
• A/B（ブラインド）比較：スキルの新旧2バージョンの出力を、どちらがどちらか伏せた状態で比較し、修正が本当に改善かを確かめられる
• ベンチマーク：スキルあり／なしの合格率・所要時間・トークン消費を集計し、効果と追加コストを比較できる
• 読み込み判定の自動チューニング：スキルの「説明文」を磨いて、関係あるタスクのときだけ正しく発動する精度を上げる

本記事の初版（2026年5月）では、この更新の日付を報道ベースでしか確認できませんでしたが、Anthropic公式ブログ「Improving skill-creator: Test, measure, and refine Agent Skills」（2026年3月3日）で一次確認できたため、本更新で日付を確定しています。なお「Skills 2.0」という呼び名は公式ブログには登場せず、メディアやコミュニティの通称です。Claude Codeでは/plugin install skill-creator@claude-plugins-officialで導入でき、テストケースはスキルフォルダ内のevals/evals.jsonに保存されます（2026年9月時点のClaude Code公式ドキュメント）。

非エンジニアでも作れる——最初のスキルの作り方

ここから手を動かすパートです。前提として、ここでは Claude Code（ターミナルで動くClaude）を使った例を示しますが、考え方はClaude.aiのスキル機能でも共通です。難しいプログラミング知識は要りません。

設定例1：いちばん簡単な「議事録整形スキル」のSKILL.md

まずはスクリプトなしの、純粋に手順書だけのスキルから。録音文字起こしを、自社フォーマットの議事録に整える作業をスキル化します。~/.claude/skills/meeting-minutes/SKILL.md として保存します。

---
name: meeting-minutes
description: 文字起こしテキストを自社フォーマットの議事録に整形する。「議事録にして」「議事録整形」と言われたとき、または会議の文字起こしが渡されたときに使う。
---

# 議事録整形スキル

## 手順
1. 入力された文字起こしから、以下を抽出する。
   - 会議名・日時（記載がなければ「不明」と書き、推測しない）
   - 出席者（発言者名から推定。確証がなければ「要確認」と付す）
   - 決定事項（箇条書き）
   - ToDo（担当者・期限つき。期限が不明なら「期限未定」と明記）

2. 以下のフォーマットで出力する。

## 出力フォーマット
【会議名】
【日時】
【出席者】
【決定事項】
-
【ToDo】
- [担当] 内容（期限）

## ルール
- 文字起こしに無い情報は創作しない。不明な点は「不明」「要確認」と書く。
- 仮定した点は必ず「（仮定）」と明記する。
- 不足している情報があれば、整形を始める前にまず質問する。

これだけです。保存したら、Claudeに「この文字起こしを議事録にして」と渡すだけで、毎回この手順とフォーマットが適用されます。Claude Code 2.1.0以降ならホットリロードに対応しているので、ファイルを保存した瞬間から有効になります。再起動は不要です。

設定例2：スクリプトを組み込む「請求書チェックスキル」

次は scripts/ を使う例です。請求書Excelの「合計金額が明細の合計と一致しているか」を機械的にチェックさせます。判断（おかしい行はどれか、どう直すべきか）はAIに、計算（足し算が合っているか）はスクリプトに任せる役割分担です。

~/.claude/skills/invoice-check/SKILL.md：

---
name: invoice-check
description: 請求書ExcelやCSVの金額整合性をチェックする。「請求書チェック」「金額が合っているか確認」と言われたときに使う。
---

# 請求書チェックスキル

## 手順
1. ユーザーから請求書ファイル（.xlsx か .csv）を受け取る。
2. scripts/validate.py をbashで実行し、明細合計と記載合計の差分を取得する。
   実行例: python3 scripts/validate.py <ファイルパス>
3. スクリプトの出力（OK / 差分あり）をもとに、人間に分かる言葉で報告する。
4. 差分があった場合は、どの行が怪しいかの仮説を添える（断定はしない）。

## ルール
- 金額の最終判断は人間が行う前提で報告する。AIの判定を断定口調にしない。
- スクリプトがエラーで動かない場合は、勝手に手計算で代替せず、エラー内容をそのまま報告する。

そして ~/.claude/skills/invoice-check/scripts/validate.py（このスクリプト自体、Claudeに「こういう検算をするPythonを書いて」と頼めば作ってくれます）：

import sys
import pandas as pd

def main(path):
    df = pd.read_excel(path) if path.endswith(".xlsx") else pd.read_csv(path)
    # 「金額」列の合計と、「合計」行/セルの整合を確認する想定
    detail_sum = df["金額"].sum()
    print(f"明細合計: {detail_sum:,} 円")
    # 記載合計セルの取得ロジックは様式に合わせて調整
    # ここでは例として最終行の金額を記載合計とみなす
    stated_total = df["金額"].iloc[-1]
    diff = detail_sum - stated_total
    if diff == 0:
        print("判定: OK（差分なし）")
    else:
        print(f"判定: 差分あり（{diff:,} 円）")

if __name__ == "__main__":
    main(sys.argv[1])

こうしておけば「この請求書チェックして」と言うだけで、Claudeがスクリプトを実行し、計算は確実に、報告は分かりやすく、というハイブリッドな処理が毎回再現されます。検算ロジックがスクリプトに固定されているので、AIの気分で計算結果がブレることもありません。

設定例3：skill-creatorに作らせる（ノーコードの王道）

「自分でSKILL.mdの書式を覚えるのも面倒」という方には、公式の skill-creator に作らせるのがいちばん早いです。Claudeに自然言語で依頼するだけ。

あなたはスキル作成の専門家です。
以下の業務をスキル化したいので、SKILL.md と必要なスクリプトを設計してください。

【業務内容】
毎月の月次売上レポートを作る。元データは売上明細のCSV。
部門別・商品別に集計して、PowerPointのテンプレートに沿った
報告スライドにまとめる。グラフは棒グラフを使う。

【守ってほしいこと】
- 数字はCSVから機械的に集計し、創作しない
- 不明な点は作業前に質問する
- 出来上がったスキルは ~/.claude/skills/monthly-report/ に保存する形で提案

まず設計案を見せてから、私の確認を取って作成に進んでください。

これで、SKILL.mdの雛形も、集計用スクリプトの設計も、Claudeが提案してくれます。前述の更新版 skill-creator なら、出来上がったスキルを評価テスト（evals）にかけて「ちゃんと動くか」を採点する流れまでカバーします。

設定例4：既製のオフィス文書スキルを呼び出す

Anthropicの既製スキル（docx/xlsx/pptx/pdf）は、Claude.aiやAPI経由で利用できます。たとえば既製のPDFスキルでフォーム入力を任せるなら、こんな指示になります。

添付した申込書PDFのフォーム欄を、以下の情報で埋めてください。

- 会社名: 株式会社サンプル
- 担当者: 山田太郎
- 申込日: 本日の日付

【注意】
- フォーム欄に該当する情報がないものは空欄のまま残し、勝手に埋めない
- 読み取れない欄があれば、埋める前に指摘してください
- 仮に補った箇所があれば「（仮）」と明記してください

PDFスキルは内部で forms.md に書かれたフォーム入力の手順を読み込み、フィールドを正確に埋めてくれます。Excelの自動生成なら「この集計CSVから、部門別売上の表とグラフを入れたxlsxを作って」、PowerPointなら「この企画メモから提案スライド10枚を作って」といった指示で、それぞれ xlsx・pptx スキルが働きます。

設定例5：チームで共有する（プロジェクト単位スキル）

個人の ~/.claude/skills/ ではなく、プロジェクトフォルダ直下の .claude/skills/ に置くと、そのフォルダを共有するチーム全員が同じスキルを使えます。属人化解消の本丸はここです。

# プロジェクト直下にスキルフォルダを作る
mkdir -p .claude/skills/brand-docs

# SKILL.md を配置（自社のブランドガイドライン・書式ルールを記述）
# 例: フォント、色（自社カラーコード）、ロゴ位置、禁止表現 など

# Git管理しているプロジェクトなら、コミットして共有
git add .claude/skills/brand-docs/
git commit -m "add: 自社ブランド書式スキル"

こうすれば「うちの資料の体裁ルール」がフォルダに固定され、誰がClaudeに資料を作らせても、同じトンマナ・同じ書式で出てきます。ベテランの頭の中にあった「うちらしさ」が、初めて組織の共有資産になる瞬間です。

最初の1本におすすめのスキル題材5つ——「agent skills 作り方」で迷ったらここから

「何から作ればいいか」で止まる方が多いので、100社以上の導入支援で「最初の1本」として定着率が高かった題材を5つ挙げます。共通点は、入力が毎回ほぼ同じ形で来る、正解の判定を人が数分でできる、失敗しても社外に出ないの3つです。

どれを選んでも、Anthropicの公式ベストプラクティスが勧める「3つのテスト」は必ずやってください。スキルを書く前に代表的な依頼を3件用意し、期待する出力を先に書き、スキルなし／ありで結果を比べる。これだけで「動いているように見えて指示を読んでいない」スキルをかなり防げます。descriptionは「議事録を手伝います」ではなく「会議の文字起こしを決定事項・宿題・期限に整形する。ユーザーが議事録に言及したら使う」のように、発動語を入れて三人称で書きます。

中小企業がスキル化すべき「繰り返す業務」の選び方

「で、うちは何からスキル化すればいいの？」という質問が必ず来ます。研修でいつもお伝えしている選定基準は3つです。

この3つが重なる業務ほど、スキル化の費用対効果が高いです。逆に、毎回まったく違う判断が必要なクリエイティブ業務や、年に1回しか発生しない作業は、スキル化のコストに見合いません。

事例区分：想定シナリオ
以下は、100社以上の研修・導入支援の経験から構成した典型的なシナリオです。特定企業の実数値ではありません。

たとえば従業員50名規模の卸売業を想定すると、最初にスキル化する候補は「月次の取引先別売上レポート」あたりが王道です。元データ（販売管理システムからのCSV）は毎月同じ形式、集計の切り口も固定、作るのはいつも経理のベテラン1名。①②③が全部当てはまります。ここをスキル化できれば、その1名が休んでも回るし、本人はより付加価値の高い分析業務に時間を回せる。これがスキル化の狙いです。

部門別に見る「スキル化しやすい業務」の早見表

もう少し具体的に、部門ごとに「最初の1本」を選ぶ目安を整理しておきます。研修先で「うちの部署だと何から？」と聞かれたときに、いつも見せている表です。

共通しているのは「成果物の形が決まっていて、毎回ゼロから作っている」業務だということ。逆に、新規事業の構想や、相手によって毎回ロジックが変わる価格交渉のような業務は、スキル化よりも対話的にAIと壁打ちするほうが向いています。「固める業務」と「対話する業務」を分けて考えるのがコツです。

研修先でよく出る誤解が「スキル化＝完全自動化」というイメージです。実際は違って、スキルは”段取りの再現”であって、最終確認や例外判断は人間が握り続けるのが基本設計。だからこそ、いきなり全自動を狙わず、「下準備をスキルに任せて、人は仕上げと判断に集中する」くらいの距離感から始めると、現場の納得感が高く、定着します。

【要注意】スキル導入でよくある失敗パターンと回避策

失敗1：SKILL.mdに何でも詰め込みすぎる

❌ 1つのSKILL.mdに、例外対応からレアケースまで全部書き込んで、3,000行の巨大ファイルにしてしまう。
⭕ 本体は薄く保ち、頻度の低い詳細は reference.md や forms.md など別ファイルに切り出す（段階的開示）。

なぜ重要か：本体が肥大化すると、Claudeが毎回大量のテキストを読み込むことになり、動作が重く・不安定になります。Anthropicの既製PDFスキルがあえて本体を薄くしているのは、この問題を避けるためです。

失敗2：判断が必要な処理までスクリプトに固定する

❌ 「文章のトーンを判定して書き換える」ような、文脈で揺れる判断までPythonスクリプトでガチガチに固める。
⭕ 機械的・確定的な処理（計算・並べ替え・形式変換）はスクリプトに、文脈判断が要る部分はSKILL.mdの指示（自然言語）でAIに任せる。

なぜ重要か：スクリプトは「決まった処理を正確に速く」やるのが得意な反面、例外に弱い。役割分担を間違えると、かえって柔軟性を失います。計算はスクリプト、判断はAI——この線引きがスキル設計のキモです。

失敗3：捏造を許す書き方になっている

❌ 「いい感じにレポートを完成させて」とだけ書く。
⭕ 「データに無い数字は創作しない」「不明な点は作業前に質問する」「仮定した点は明記する」という事故防止ルールをSKILL.md内に明文化する。

なぜ重要か：これは私が研修で最も強く言うところです。スキルは「毎回同じ動作を再現する」仕組みなので、悪い癖も完璧に再現してしまう。「空欄を埋めるために数字をでっち上げる」という挙動を一度許すと、それが毎回繰り返されます。最初のSKILL.mdに事故防止の一文を入れておくのが、安価で確実な保険です。

失敗4：ライセンスを確認せず既製スキルを商用組み込み

❌ 「Anthropic公式だから全部自由に使える」と思い込み、docx/pdf/pptx/xlsxスキルをそのまま自社サービスに組み込む。
⭕ これら4スキルは「ソース閲覧可（source-available）」で「デモ・教育目的」の但し書き付き。商用利用時はライセンス条項を必ず確認する。

なぜ重要か：オープンソース（Apache 2.0）のスキルと、ソース閲覧可のスキルは扱いが違います。社内の業務効率化に使う分には問題になりにくいですが、自社プロダクトに組み込んで再配布する場合は要注意です。

日本・中小企業への影響——「属人化」の特効薬になりうる

日本の中小企業が長年抱えてきた最大の課題のひとつが「属人化」です。ベテランの退職とともにノウハウが消える、担当者が休むと業務が止まる、引き継ぎ資料を作る時間がない。マニュアル化が大事だと分かっていても、「文章で書いても誰も読まない」「読んでも人によって解釈がブレる」という壁がありました。

Agent Skillsが面白いのは、マニュアルが「読まれる前提」ではなく「実行される前提」になる点です。SKILL.mdは人間用のマニュアルでもあり、同時にAIへの実行指示でもある。書いたそばからAIが手順通りに動いてくれるので、「書いたのに使われない」問題が起きにくい。これは日本の現場にかなり刺さる特性だと感じています。

さらに、2025年12月のオープン標準化によって「特定ツールに縛られない」安心感が加わりました。中小企業のIT投資で最大のためらいは「乗り換えコスト」と「ベンダーロックイン」ですが、業界共通フォーマットであれば、その心配が相対的に小さくなります。AI導入をどう経営戦略に組み込むかという全体像は、AI導入戦略の完全ガイドで詳しく整理しています。

一方で冷静な見方も必要です。スキルは「繰り返す・手順が固まった業務」に効く道具であって、万能ではありません。毎回判断が変わる業務や、そもそも手順が固まっていない業務には向きません。「何でもスキル化すれば生産性が上がる」と考えると、作る手間ばかりかかって使われないスキルの山ができます。

企業がとるべきアクション

「で、経営として何をすればいいのか」をアクションに落とします。明日から着手できる順に5つ。

1. 「繰り返す業務」の棚卸しをする：各部門に「毎週・毎月やっている定型作業」をリストアップしてもらう。前述の①頻度②手順固定③属人化の3基準でスコアリングし、上位3つを候補に。
2. パイロットを1業務だけに絞る：最初から全社展開を狙わない。最も効果が見えやすい1業務（月次レポートや請求書チェックが鉄板）でスキルを1つ作り、効果を測る。
3. 事故防止ルールを社内標準にする：「データに無い数字は創作しない」「不明点は質問する」をSKILL.mdの共通テンプレに組み込み、どのスキルにも必ず入れる運用ルールを決める。
4. スキルをチーム共有資産として管理する：個人フォルダで作らせず、プロジェクトの .claude/skills/ に集約してバージョン管理（Git等）する。属人化解消の効果はここで初めて出る。
5. ライセンスとセキュリティの確認窓口を決める：既製スキルの商用利用可否、機密データをAIに渡してよい範囲を、情報システム担当または外部支援者と一度整理しておく。

FAQ：Agent Skillsのよくある質問

Q1. プログラミングができなくてもスキルは作れますか？

作れます。最もシンプルなスキルは SKILL.md（日本語の手順書）1ファイルだけで完成します。スクリプトが必要な場合も、Claude自身に「こういう処理をするスクリプトを書いて」と頼めば生成してくれます。公式の skill-creator を使えば、雛形作りもAIに任せられます。

Q2. ChatGPT用に作ったスキルとClaude用のスキルは別物ですか？

2025年12月にAgent Skillsがオープン標準（agentskills.io）として公開され、OpenAIのCodex／ChatGPTも同じSKILL.md形式を採用したと報じられています。そのため、基本フォーマットは共通化が進んでいます。ただしツールごとの細かい仕様差はあり得るので、流用時は動作確認をおすすめします。

Q3. たくさんスキルを入れると動作が重くなりませんか？

重くなりにくい設計になっています。Claudeは最初に各スキルの「名前」と「説明文」だけを把握し、今のタスクに関係しそうなスキルだけを必要時に読み込みます（段階的開示）。何十個入れても、常に全部を読むわけではありません。

Q4. Excel・PowerPoint・Word・PDFのスキルは無料で使えますか？

Anthropic公式リポジトリで公開されています。ただしこの4つ（docx/pdf/pptx/xlsx）は「ソース閲覧可（source-available）」で、厳密にはオープンソースとは区別され、「デモ・教育目的」の但し書きが付いています。社内の業務効率化に使う分には実用的ですが、自社プロダクトへの組み込み・再配布を検討する場合はライセンス条項の確認が必要です。なお、この4スキルが標準装備なのはclaude.ai・Claude API・AWS・Microsoft Foundry上のClaudeで、Claude Codeには同梱されていません（リポジトリから.claude/skills/に自分で配置します）。

Q5. スキルを編集したら、すぐ反映されますか？

Claude Code 2.1.0（2026年1月7日リリース）以降は、~/.claude/skills や .claude/skills でスキルを作成・編集すると、セッションを再起動しなくても即座に有効になります（ホットリロード）。試行錯誤しながら作る作業がかなり快適になりました。2026年9月時点の公式ドキュメントではこれを「ライブ変更検知」と呼び、--add-dirで追加したフォルダ内のスキルも対象です（追加フォルダ側の.claude/agents/は監視対象外）。

Q6. 機密データを扱う業務でも使えますか？

スキルの仕組み自体は機密かどうかを問いませんが、AIに渡すデータの取り扱いは別問題です。顧客情報や財務データを扱う場合は、利用しているプランのデータ取り扱い規約を確認し、社内のセキュリティ方針に沿って運用してください。「どのデータをAIに渡してよいか」の線引きを先に決めておくのが安全です。

Q7. 「エージェントを作るな、スキルを作れ」という言葉を聞きますが、すでに作ったエージェントは無駄になりますか？

無駄にはなりません。この言葉は、Agent Skillsの開発者であるAnthropicのBarry Zhang氏・Mahesh Murag氏がAI Engineerカンファレンスの講演で示した開発方針で、「エージェント基盤そのものをやめろ」という意味ではなく、「案件ごとに専用エージェントをスクラッチで作り込むより、既存の汎用エージェントにスキルを読み込ませて専門化する方が効率的だ」という主張です。すでにClaude CodeやClaude Agent SDKでエージェントを構築している場合も、そこにSKILL.mdというスキルを足していくことで、同じ基盤のまま専門知識を積み増していけます。

Q8. Claudeの「エージェント」と「スキル」の違いは何ですか？

エージェントは「仕事を進める主体」、スキルは「その主体に渡す手順書」です。Claude CodeやClaude自体がエージェントで、スキルはそこに読み込ませるSKILL.mdのフォルダです。Claude Codeの「サブエージェント」は分業用の担当者設定でスキルとは別物ですが、context: forkでスキルをサブエージェント側で実行させることもできます（本文の比較表を参照）。

Q9. Claude Codeのスキル機能はいつから使えますか？

Agent Skillsは2025年10月16日にAnthropicが発表し、発表時点でClaudeアプリ・Claude Code・Claude Developer Platform（API）で利用できるとされました。Claude Codeでは以前からあった「カスタムコマンド」（.claude/commands/）がスキルに統合されており、.claude/commands/deploy.mdと.claude/skills/deploy/SKILL.mdはどちらも/deployとして動きます。

Q10. スキルのマーケットプレイスはありますか？どこで入手・配布できますか？

2026年9月時点で、Anthropicが「スキル単体を売買するマーケット」を公式に運営している事実は確認できていません。公式の入手先は、GitHubのanthropics/skillsリポジトリと、Claude Codeの公式プラグインマーケットプレイスclaude-plugins-official（skill-creatorもここから）です。社内配布は、①プロジェクトの.claude/skills/をgitで共有、②プラグインのskills/に同梱、③Enterpriseの管理設定で配布、の3通りが公式に案内されています。設計はClaude Code Pluginsの作り方・社内配布手順を参照してください。

まとめ：今日から始める3つのアクション

1. 今日やること：自社で「毎週・毎月やっている定型業務」を1つだけ紙に書き出す。そして、設定例1の議事録スキルをまねて、その業務の SKILL.md を10行でいいので書き始める。
2. 今週中：書いたSKILL.mdをClaudeに渡して実際に動かしてみる。うまくいかない部分は、手順を1つずつ追記して調整する（ホットリロードで即反映されます）。
3. 今月中：効果が見えたスキルを、個人フォルダからチーム共有の .claude/skills/ へ移し、事故防止ルールを共通テンプレ化する。ここまでで「属人化していた1業務が組織の資産になった」状態になります。

あわせて読みたい：

• Claude Cowork 完全ガイド — チームでAIを”同僚”として動かす実践法
• Claude Opus 4.8 活用ガイド — 最新モデルの実務での使いどころ
• Claude Skills法人導入ガイド — チーム展開7パターンと運用設計

参考・出典

• Equipping agents for the real world with Agent Skills — Anthropic Engineering（参照日：2026-08-30）
• Agent Skills — Overview — Anthropic（Claude Docs）（参照日：2026-08-30）
• anthropics/skills（公式リポジトリ） — Anthropic（GitHub）（参照日：2026-05-29）
• Anthropic’s Claude Code 2.1.0 arrives with smoother workflows and smarter agents — VentureBeat（参照日：2026-05-29）
• Agent Skills — Codex — OpenAI Developers（参照日：2026-05-29）
• Anthropic Drops Claude Code Skills 2.0: Adds Evals, A/B Testing Tools & More — Geeky Gadgets（参照日：2026-05-29）
• Don’t Build Agents, Build Skills Instead — Barry Zhang & Mahesh Murag, Anthropic — AI Engineer（YouTube・2025年12月公開）（参照日：2026-08-30）
• Improving skill-creator: Test, measure, and refine Agent Skills — Anthropic（2026年3月3日）（参照日：2026-08-30）
• Agent Skills — Specification — agentskills.io（参照日：2026-08-30）
• Extend Claude with skills — Claude Code Docs（参照日：2026-08-30）
• Agent Skills — Best practices — Anthropic（Claude Docs）（参照日：2026-08-30）
• なぜAnthropicはClaude Codeで「エージェントを作るな、スキルを作れ」と言うのか — ITmedia TechTarget（2026年5月15日）（参照日：2026-08-30）
• Claude Codeでは「エージェントを作るな、スキルを作れ」 Anthropicが示すAI構築術 — ITmedia TechTarget（2026年8月6日）（参照日：2026-08-30）

著者：佐藤傑（さとう・すぐる）
株式会社Uravation代表取締役。X（@SuguruKun_ai）フォロワー約10万人。100社以上の企業向けAI研修・導入支援。著書『AIエージェント仕事術』（SBクリエイティブ）。SoftBank IT連載7回執筆（NewsPicks最大1,125ピックス）。

ご質問・ご相談は お問い合わせフォーム からお気軽にどうぞ。

あわせて読みたい（新着）

• Claude Code Skillsとは？使い方・一覧・おすすめ7選 — SKILL.mdの詳しい作り方・仕様はこちら