Agent Skillsの使い方

Agent Skillsは、LLMを活用する上で最も効果的な方法の一つです。繰り返し使える形で、やりたいタスクに最適なコンテキストを提供します。

そして一番のポイントは？

企業がこれらのスキルを作成してくれているので、ユーザーは自分のワークフローで使うだけです。このガイドでは、これらのスキルを活用して実際に動く機能を作る方法を紹介します。本当に使えるものを作る方法です。

Skillsとは？

「Skill」とは、特定のタスクのやり方についてまとめたMarkdownファイルが入ったフォルダーです。メインのスキルファイルは必ずSKILL.mdという名前にし、内容は自由ですが、フロントマターにnameとdescriptionフィールドが必要です。（他にもオプションのフロントマターフィールドがあります。詳しくはこちらをご覧ください。）)

このメインのSKILL.mdファイルは500行未満にするのがおすすめです。

このフォルダー内には他の情報も入れることができ、SKILL.mdファイルから参照できますが、必要なときだけコンテキストに読み込まれます。これらの情報は次のフォルダーに保存してください：

1. scripts/ - エージェントが実行できるコード。
2. references/ - 必要に応じて追加のドキュメントとして使えるMarkdownファイル。
3. assets/ - エージェントが利用できる静的リソース。

Skillsが特別な理由

AIを使うときの大きな課題の一つが、コンテキストの膨張（Context Bloat）です。コンテキストの膨張とは、AIにあまりにも多くの情報（コンテキスト）を与えすぎて、タスクの実行が難しくなる状態です。

例えば、ジュニアデベロッパーに特定の機能だけのドキュメントを渡した場合、内容を読めば高い確率で実装できるでしょう。

一方で、ジュニアデベロッパーに全てのドキュメントを読ませてから、その中の一部だけを使って特定の機能を実装させると、成功率はかなり下がります。

LLMも同じように動作します。

以前のMCPのようなアプローチでは、大量の構造化されたコンテキストをモデルに読み込ませていました。これでも何もないよりは良かったですが、タスクを安定して実行するのは難しいままでした。

Skillsはここが違います。

デフォルトでは、フロントマターのnameとdescriptionだけがコンテキストウィンドウに読み込まれます。これでコンテキストの消費は最小限に抑えつつ、LLMにどんなスキルがあるかを伝えられます。Skillが有用だと判断されたときに初めて、SKILL.mdがコンテキストウィンドウに読み込まれます。そして必要な場合のみ、scripts/、references/、assets/フォルダー内の他のファイルがコンテキストに追加されます。

では、これらのSkillsはどうやって使うのでしょうか？

skills.sh

使っているLLMインターフェースによって、Skillsをダウンロードしてアプリケーションに合った場所に保存できます。例えば：

Skillsは単なるフォルダーとファイルなので、これらのディレクトリにコピー＆ペーストするだけで動作します。

もう一つの方法は、skills.shを使うことです。

これはVercelが開発したAgent Skillsディレクトリで、どのスキルがどれだけ使われているかをもとに探すことができます。また、CLIツールを使ってプロジェクトやグローバルユーザーにスキルを追加することもできます。

そのためには、次のコマンドを実行します：npx skills add <owner/repo>。これで手順に沿って進められます。このコマンドは実質的にコピー＆ペーストですが、より速く行えます。

Skillsの使い方

（skills.shまたはコピー＆ペーストで）インストールが終わったら、使い方はとても簡単です。どのエディターでも、自動的に必要だと判断したときにスキルを使ってくれます。理論上は、正しい場所にスキルを配置すれば、あとは気にしなくて大丈夫です。

ですが、この記事を書いている時点では、必ずしも適切なタイミングでSkillsが使われるとは限りません。もし「今このスキルを使うべき」と分かっている場合は、LLMに伝えてください。

例えば、ElevenLabsのスピーチtoテキストスキルをインストールした場合、Claudeに使わせたいときは次のようなプロンプトを送ります：

このプロジェクトでスピーチtoテキストスキルを使って、簡単な例を実装してください。音声はこちらを使ってください：https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3。

下記のアプリを一発で作成できました。

もちろん、このUIはまだ改善の余地がありますが、ElevenLabsのコアロジックはしっかり動いています。たった一文で実現できました。

プロジェクトでAgent Skillsを活用するのは本当におすすめです。ツールを作った人たちが厳選した、特定タスクに最適なコンテキストをLLMに与えられます。

そして、プロジェクトでElevenLabsを使っている場合は、次のコマンドでスキルをインストールしてください：

npx skills add elevenlabs/skills