スキルを持ったエージェントの構築: 専門作業への対応

スキルを持ったエージェントの構築: 専門作業への対応 AIエージェント・ワークフロー

AI Beat(エーアイビート)編集部です。Anthropic が公式リリースし、その後継続的に拡張されている Claude Code Skills(旧称: Agent Skills)は、Claude エージェントに「専門知識のフォルダ」を装備させ、特定の専門作業をベンダーに依存せず実行させる仕組みです。本記事では Claude Code Skills の仕組み、Plugins / MCP / Custom GPTs との違い、ユースケース、構築手順、運用上の注意点を、2026 年最新の Anthropic 公式情報と実際に Skills を運用してきた編集部の体験を踏まえて解説します。

「ChatGPT の Custom GPTs とどう違うのか」「MCP との関係は?」「導入コストはどのくらいか」といった実務担当者の疑問に、6,500 字超の網羅的なガイドでお応えします。

  1. Claude Code Skills とは|エージェントに専門作業を装備する標準フォーマット
    1. 仕様の概要
    2. 「専門作業」とは何を指すか
  2. Skills が解決する 3 つの課題|なぜ MCP やプロンプトテンプレートだけでは足りないのか
    1. 課題 1: プロンプトの肥大化と再利用性
    2. 課題 2: コンテキスト浪費
    3. 課題 3: ベンダーロックインの回避
  3. Claude Code Skills と MCP の違い|どちらを選ぶべきか
  4. Custom GPTs / ChatGPT Plugins との比較|2026 年時点の最適解
    1. 主要 4 観点の比較
    2. ChatGPT Plugins からの教訓
  5. Claude Code Skills の使い方|CLI と API の両方で使える
    1. Step 1: Skill フォルダを作成
    2. Step 2: SKILL.md を記述
    3. Step 3: 動作確認
    4. API での利用
  6. ユースケース|編集部が実運用している 5 つの Skills
    1. 1. 競合 SEO 監査 Skill
    2. 2. ブランド準拠スライド生成 Skill
    3. 3. 記事リライト Skill
    4. 4. ファクトチェック Skill
    5. 5. 入稿フォーマット Skill
  7. セキュリティと運用上の注意点
    1. 信頼できないソースの Skill を読み込まない
    2. 権限の最小化
    3. ロギングと監査
  8. 自作 Skill のベストプラクティス 5 選
    1. 1. description は「いつ使うか」を必ず書く
    2. 2. SKILL.md は 1 画面に収める
    3. 3. スクリプトは冪等に
    4. 4. テストケースを同梱
    5. 5. バージョニング
  9. よくある質問(FAQ)
    1. Q1. Claude Code Skills はどの料金プランから使えますか?
    2. Q2. Skills は ChatGPT の Custom GPTs に変換できますか?
    3. Q3. 1 セッションで何個の Skills を同時に使えますか?
    4. Q4. Skills は MCP の代わりになりますか?
    5. Q5. Skill が暴走して意図しないファイルを書き換える事故を防ぐには?
  10. まとめ|2026 年は Skills が「組織知の再利用単位」になる
  11. 関連記事

Claude Code Skills とは|エージェントに専門作業を装備する標準フォーマット

Claude Code Skills の全体像

Skills は、「Claude が特定タスクで参照する手順書・スクリプト・参照資料を 1 つのフォルダにまとめたもの」です。Anthropic 公式の説明によれば、Skills は SKILL.md という Markdown ファイルを起点に、関連スクリプト・サンプル・参考データを 1 ディレクトリに格納する「ファイルベースのパッケージ」として定義されます。

仕様の概要

最小構成の Skill は以下のような構造を取ります。

  • SKILL.md(必須): フロントマターに name(kebab-case、64 字以内)と description(いつ使うか、自動発動条件)を記述
  • 任意ファイル: reference.md(詳細リファレンス)、scripts/(実行可能なユーティリティ)、テンプレート

Claude はリクエストの文脈と description を照合し、該当する Skill を自動的に読み込みます。実行時にだけ詳細を展開する「Progressive Disclosure(段階的開示)」方式を採用しているため、コンテキストウィンドウを浪費せず、複数の Skills を共存させられる点が大きな特徴です。

「専門作業」とは何を指すか

Anthropic は Skills のユースケースとして以下のような専門作業を例示しています。

  • Excel / PowerPoint / Word / PDF の生成・編集(Anthropic 公式提供)
  • ブランドガイドラインに準拠した資料作成
  • 社内固有のコーディング規約に沿ったコード生成
  • 複雑なドメイン知識(医療コーディング、法律レビュー、財務分析)に基づく出力

つまり、汎用 LLM では精度が落ちる「組織固有 / ドメイン固有」の作業を、再利用可能なパッケージとして配布できる点に Skills の価値があります。

Skills が解決する 3 つの課題|なぜ MCP やプロンプトテンプレートだけでは足りないのか

Skills が解決する 3 つの課題

実務で Claude を使ってきた編集部が Skills を導入して感じた、Skills が解く 3 つの課題を整理します。

課題 1: プロンプトの肥大化と再利用性

ChatGPT 時代から続く課題ですが、専門作業ごとに長大なシステムプロンプトを書き、コピペで配布する運用は破綻しがちです。Skills はプロンプト+スクリプト+参考資料をひとまとめにし、Git で版管理できるためチーム運用に耐えます。

課題 2: コンテキスト浪費

「全部のルールを最初に読み込ませる」運用ではコンテキストが枯渇します。Skills は description だけを常駐させ、本体の手順は呼び出し時にロードするため、トークン効率が劇的に改善します。

課題 3: ベンダーロックインの回避

Skills はファイルシステム上のフォルダに過ぎず、Claude API・Claude Code(CLI)・Claude.ai(Web)の各環境で同じパッケージを再利用できます。後述する Custom GPTs と比較したときの最大のアドバンテージはここです。

Claude Code Skills と MCP の違い|どちらを選ぶべきか

Skills と MCP の違い

「Skills と MCP(Model Context Protocol)はどう使い分けるのか」は最も多い質問の一つです。両者は補完関係にあります。

観点 Skills MCP
主目的 専門作業の手順・知識を Claude に教える 外部システム(DB、API、ファイル)への接続を提供する
形式 Markdown + スクリプトのフォルダ サーバー(プロセス)として常駐
配布 Git リポジトリ・ZIP・社内共有 サーバーホスティング、設定ファイル登録
呼び出し Claude が文脈で自動選択 ツール呼び出しとして明示的に発動

実装パターンとしては「MCP で取得したデータを Skill 内のスクリプトで処理する」のような併用が定番です。MCP の詳細はClaude Code の MCP サーバー設定完全ガイドで扱っているので、併せてご覧ください。

Custom GPTs / ChatGPT Plugins との比較|2026 年時点の最適解

Custom GPTs と Skills の比較

OpenAI の Custom GPTs(公開後に GPT Store として展開)と旧 ChatGPT Plugins(後に GPTs に統合)は、Skills と類似のニーズに応える機能ですが、設計思想が大きく異なります。

主要 4 観点の比較

観点 Claude Code Skills Custom GPTs
配布形態 ファイルシステム(フォルダ) OpenAI 管理の SaaS
移植性 任意の Claude 環境で動作 ChatGPT 内に閉じる
ロジック実装 Bash / Python など任意のスクリプトを同梱可 Actions 経由で外部 API のみ
版管理 Git で完全に管理可能 OpenAI 側 UI で編集

Custom GPTs は「公開して GPT Store で広く配布する」用途には強いですが、企業内ナレッジを再利用する用途では Skills のほうが圧倒的に取り回しが良い、というのが編集部の結論です。

ChatGPT Plugins からの教訓

ChatGPT Plugins は「すべてを Function Calling 化する」アプローチで設計されましたが、結果として「LLM がどのプラグインを呼ぶべきか判断しきれない」という問題が顕在化し、最終的に Custom GPTs に統合されました。Skills は description を厳密に記述させることで、この発火失敗問題を構造的に回避しています。

Claude Code Skills の使い方|CLI と API の両方で使える

Skills は Claude Code(CLI)、Claude.ai(Web)、Claude Developer Platform(API)のすべてで利用できます。ここでは最も汎用的な Claude Code(CLI)での使い方を解説します。

Step 1: Skill フォルダを作成

mkdir -p ~/.claude/skills/pdf-summarizer
cd ~/.claude/skills/pdf-summarizer

Step 2: SKILL.md を記述

---
name: pdf-summarizer
description: PDF を構造化サマリーに変換する。「PDF 要約」「論文サマリー」で発動
---

# 実行手順
1. 入力 PDF を pypdf で読み込む
2. セクションごとに 200 字要約
3. 結果を Markdown で出力

Step 3: 動作確認

claude
> 添付した PDF を pdf-summarizer で要約して

Claude は description を見て自動で Skill を発動します。Claude Code の基本的な使い方や日本語での運用はClaude Code を日本語で使いこなす完全ガイドにまとめています。

API での利用

Anthropic の Messages API では、Skills は「Beta Header」を有効化することで利用できます。プログラムから Skills 装備済みのエージェントを起動するイメージです。サンプル実装はAnthropic Claude API 入門ガイドを参照してください。

ユースケース|編集部が実運用している 5 つの Skills

編集部が運用する 5 つの Skills

ここからは、AI Beat 編集部が実際に運用している Skills の例を 5 つ紹介します。すべて記事制作・社内オペレーションでの実使用例です(編集部体験談)。

1. 競合 SEO 監査 Skill

GSC・Ahrefs API・社内のリライトガイドラインをまとめた Skill。「リライト対象を 5 件選定」と話しかけるだけで、4 象限分析→優先度スコア→対象選定までを完了します。

2. ブランド準拠スライド生成 Skill

Marp 構文・カラートークン・タイポグラフィを束ねた Skill。提案資料を「常に同じ見た目で」生成するのに使っています。スライド作成自体の運用はClaude Code vs Cursor の比較記事でも触れています。

3. 記事リライト Skill

E-E-A-T ルール、内部リンク戦略、文字数閾値、画像配置ルールをすべて 1 つの Skill に集約。リライトの再現性が劇的に上がりました。

4. ファクトチェック Skill

WebSearch + 引用検証の手順書。「主張 → 根拠 URL → 取得日」をテーブル化させる定型作業を 1 コマンドで実行します。

5. 入稿フォーマット Skill

WordPress の HTML 整形ルール(H2 直下に画像 1 枚、目次は wp-block 形式 等)を Skill 化。整形のばらつきがほぼ消えました。

セキュリティと運用上の注意点

Skills は強力ですが、運用には注意点があります。

信頼できないソースの Skill を読み込まない

Skill には任意のスクリプトを同梱できるため、未知の Skill を ~/.claude/skills/ に置くことは「未検証のコードを実行可能な状態で配置する」のと同義です。Anthropic の公式ドキュメントでも「Skills は信頼できる発行者のものだけを使う」と明記されています。

権限の最小化

Claude Code には permissions 設定があり、Bash・Edit・Write などのツール単位で許可リストを管理できます。Skill が想定外のコマンドを叩いたときに止められる設計にしておくのが鉄則です。

ロギングと監査

業務利用では「いつ、どの Skill が、どのファイルを書き換えたか」のログを残しましょう。Claude Code のセッションログ機能や、独自フックで監査ログを出すことを推奨します。エンタープライズ運用の詳細はClaude Code エンタープライズ導入ガイドにまとめています。

自作 Skill のベストプラクティス 5 選

1. description は「いつ使うか」を必ず書く

「PDF を扱う Skill」では発動しません。「PDF 要約・論文サマリー・PDF 構造化を依頼されたとき」と具体化すべきです。

2. SKILL.md は 1 画面に収める

詳細手順は reference.md に分離し、SKILL.md には実行フローの骨子だけ残すのがコツです。

3. スクリプトは冪等に

何度叩いても同じ結果になるよう、入力検証と途中状態の出力を厚めに。

4. テストケースを同梱

tests/ フォルダに「期待入力 → 期待出力」のサンプルを置くと、Skill 改修時のリグレッションを防げます。

5. バージョニング

社内で配布する Skills は SKILL.md のフロントマターに version を入れ、変更履歴を CHANGELOG.md で管理します。

よくある質問(FAQ)

Q1. Claude Code Skills はどの料金プランから使えますか?

A. 2026 年 4 月時点では Claude Pro / Max / Team / Enterprise すべてのプランで利用できます。プランごとの違いは公式の料金ページか、AI Beat の料金解説記事を参照してください。

Q2. Skills は ChatGPT の Custom GPTs に変換できますか?

A. 完全な互換変換はできません。手順書部分(SKILL.md の本文)は Custom GPTs の Instructions に転記できますが、スクリプト部分は Custom GPTs の Actions(外部 API 呼び出し)として再実装する必要があります。

Q3. 1 セッションで何個の Skills を同時に使えますか?

A. 仕様上の上限は実装に依存しますが、「同時にロードされる」のは Claude が文脈に応じて選んだ数個だけです。リポジトリに 100 個入れておいても問題ありません。

Q4. Skills は MCP の代わりになりますか?

A. なりません。Skills は手順・知識のパッケージ、MCP は外部システム接続の規格です。両者は併用してこそ真価を発揮します。

Q5. Skill が暴走して意図しないファイルを書き換える事故を防ぐには?

A. 必ず Claude Code の permissions で Write / Bash の許可ディレクトリを限定してください。本番環境ではドライランモード(読み取りのみ)から段階的に解放するのが安全です。

まとめ|2026 年は Skills が「組織知の再利用単位」になる

まとめ - Skills が組織知の再利用単位になる

Claude Code Skills は、AI エージェントに専門作業を任せるための「最も実用的なパッケージ単位」として 2026 年に急速に普及しています。Custom GPTs に比べて移植性が高く、MCP と組み合わせれば外部システム連携も実現でき、Git で版管理できるため組織運用にも耐えます。

導入の第一歩は「自分が毎週繰り返している作業を 1 つだけ Skill にする」ことです。本記事の手順を参考に、ぜひ自社の専門作業を Skill 化してみてください。

参考: Anthropic 公式ブログ “Equipping agents for the real world with Agent Skills” / Agent Skills Overview / Agent Skills Documentation / Engineering blog / Claude Code Skills Reference

関連記事

https://ainow.jp/claude-code-mcp-server-guide/


Claude Code エンタープライズ導入ガイド|SSO・管理・セキュリティを実務で解説【2026年】
Claude Code エンタープライズ導入ガイド|SSO・管理・セキュリティを実務で解説【2026年】 AI Beat(エーアイビート)編集部です。 「開発チーム全員に Claude Code を入れたいが、SSO や監査ログがないと情シ...

Anthropic Claude API 入門ガイド|Python で始める LLM アプリ開発
AI Beat(エーアイビート)編集部です。 「Claude を API 経由で使いたいが、どこから手をつければいいのかわからない」——この記事を開いたあなたは、おそらくそんな状況にいると思います。Anthropic の Claude AP...

Gemini Robotics 1.5: AIエージェントが物理世界に進出
Gemini Robotics 1.6: AIエージェントが物理世界に進出 AI Beat(エーアイビート)編集部です。この記事では、Googleが発表した革新的なAIプラットフォーム「D4RT」とその最新アップデートである「Gemini ...

Higgsfieldがシンプルな入力から映画のようなソーシャルビデオを生成する新サービスを発表
OpenAIが新たに発表したサービス「Higgsfield」は、単純なアイデアをもとに、映画のような高品質なソーシャルビデオを生成することを可能にします。このサービスは、OpenAIが誇る最先端のAI技術、GPT-4.1やGPT-5、さらに...

CiscoとOpenAI、AIエージェントでエンタープライズエンジニアリングを再定義
AI Beat(エーアイビート)編集部です。本記事では、OpenAIとCiscoが共同開発したAIソフトウェアエージェント「Codex」について詳しく解説します。Codexは、エンタープライズ環境でのソフトウェア開発を効率化し、企業の競争力...

https://ainow.jp/building-agents-with-skills/

サービスが見つかりません。

Copied title and URL