JA EN
shiichan

Agent Skills でエージェントが現場のプロに大変身！

Anthropic Engineering ★★★★★ Markdown で見る
#anthropic#ai#devops

みんな、しぃちゃんだよ！今日はエージェント好きのみんなにたまらないお話を持ってきたよ。AI エージェントに「得意技」をまるっと持たせられる仕組み、その名も Agent Skills ！わくわくが止まらないから、さっそく見ていこう！

Anthropic Engineering anthropic.com

なにが発表されたの？

これは Anthropic の Engineering ブログで公開された「Equipping agents for the real world with Agent Skills」という技術記事だよ。仕組みの中身までしっかり書いてくれる Engineering ブログらしく、読みごたえたっぷりなの。

Agent Skills は、指示書やスクリプト、参考資料をひとつのフォルダにまとめたもの。これを渡すだけで、なんでも屋さんだった Claude が、特定分野の専門家みたいに動けるようになるんだって。しかも Claude.ai ・ Claude Code ・ Claude Agent SDK ・ Claude Developer Platform で使えるって書いてあるよ。

なぜ重要なの？

モデルそのものは物知りな「ジェネラリスト」だけど、現場の仕事って、その会社ならではの手順とか、専門的なお作法が必要なことが多いよね。そういう手続き的な知識を毎回プロンプトに全部書き込むのは大変だし、コンテキストもすぐパンパンになっちゃう。

Agent Skills は、そういうノウハウを再利用できる「部品」としてパッケージ化する考え方なんだ。しかもこのスキルの形式は 2025 年 12 月 18 日にオープン標準として公開されているから、特定のツールに縛られずに広がっていける土台になっているよ。

これで何が変わるの？

いちばん大きいのは、フォルダをひとつ用意するだけで、誰でも Claude を「その道のプロ」に育てられること。スキルは組み合わせたり使い回したりできるから、作れば作るほど積み上がっていくんだ。

記事で挙げられている例が PDF スキル。これを入れると、Claude が PDF を直接あつかえるようになって、フォームへの入力みたいな、素のモデルだけだと苦手な作業もこなせるようになるんだって。しかもフォーム入力の手順は別ファイルに分けてあって、必要なときだけ読み込む工夫がされているよ。

深く潜ってみよう

スキルの正体は、SKILL.md というファイルが入ったフォルダだよ。SKILL.md の先頭には YAML の frontmatter があって、name と description を書くことになっているの。

---
name: スキルの名前
description: どんなときに使うかの説明
---
（ここに具体的な手順や指示を書く）

キモになっているのが progressive disclosure（段階的な開示）という設計。情報を一気に全部読ませるんじゃなくて、必要になったぶんだけ順番に開いていくんだ。

  • 第 1 段階: name と description だけを起動時にシステムプロンプトへ読み込む。Claude が「このスキル、今使うべき？」を判断する材料になるよ
  • 第 2 段階: 関係ありそうと判断したら、SKILL.md の本文をまるっと読み込む
  • 第 3 段階以降: reference.md や forms.md みたいに束ねておいた追加ファイルを、タスクに応じて動的にたどっていく

この仕組みのおかげで、コンテキストウィンドウをあふれさせずに、実質ほぼ無制限の情報をスキルに詰め込めるんだって。Claude は Bash ツールを使って SKILL.md や追加ファイルを読みにいくよ。

スキルには、あらかじめ書いておいた Python スクリプトなどのコードも入れられるの。決まりきった処理はコードにまかせれば、そのコード全体をコンテキストに読み込まなくても実行できる。記事にはこんな一言があったよ。

code can serve as both executable tools and as documentation

コードが「実行できる道具」であると同時に「ドキュメント」にもなる、という考え方だね。

作るときのコツも紹介されていて、まずは評価（eval）から始めること、ファイルが大きくなりすぎたら分割してスケールできる形にすること、Claude の実際の使い方を見ながら改善していくこと、そして想定外の動きや特定の情報への偏った依存がないか見張ること、が挙げられているよ。

セキュリティ面の注意もあるの。スキルは信頼できる出どころのものだけを入れること。束ねられたファイルや依存しているコード、外部ネットワークへアクセスさせるような指示がないかは、使う前にちゃんと確認してね。

まとめ

  • Agent Skills は、指示書・スクリプト・資料をまとめたフォルダで Claude を専門家にする仕組み
  • 中心は SKILL.md（name と description の frontmatter 付き）と、progressive disclosure による段階的な読み込み
  • コードやスクリプトも同梱でき、決まった処理を確実にこなせる
  • Claude.ai ・ Claude Code ・ Claude Agent SDK ・ Claude Developer Platform で使えて、形式は 2025 年 12 月 18 日にオープン標準として公開済み
  • 信頼できるソースからだけ入れる、というセキュリティ意識は忘れずに

自分のワークフローや専門知識を Claude に持たせたいエンジニアさんに、これはぜひ試してほしい仕組みだよ！

関連記事