Agent Skillsとは？作成して使う方法

TL;DR

Agent Skillsは、AIエージェントに手順、専門知識、スクリプトを必要時だけ提供し、作業の再現性を高める仕組みである。まずSkill Creatorをskillsディレクトリに配置し、用途を伝えてSKILL.mdを生成させる。常用するスキルはユーザー領域、案件固有のスキルはプロジェクト領域に置く。

Transcript

おすです。本日はですね、クロードコード で話題になってるスキル、こちらについて 基礎的な動画、え、始め方ね、え、その 辺り含めて再度動画にやっていこうかなと いう風に思います。え、登場したての頃に ね、ま、以前動画とかも撮ったりとかもし たんですけども、改めて今抑えるべき基本 的なところとかね、ま、どういう感じで 使っていくかみたいな、え、話をできたら なという風に思います。え、ま、スキルっ て言うとね、ま、MCPとかツールと何が 違うのみたいな感じでもね、動画を撮った こともあったんですけども、例えば スクリプトファイルとかね、え、いろんな なんかその手順書みたいなのをあらかじめ 準備しといて、え、AIエージェントがね 、ま、こういう時にこれ使って欲しいな みたいな感じで定義しておけば、え... Read More

Key Insights

• Agent Skillsは、AIエージェントに専門知識、作業手順、スクリプトをまとめて提供し、同種の依頼で再現性の高い出力を得やすくするフォーマットである。
• 段階的開示は、起動時にはスキルの名前と説明だけを保持し、該当する作業が発生した時点でSKILL.mdや関連ファイルを読み込む仕組みである。
• Skill Creatorは、作りたいスキルの用途を自然言語で依頼すると、SKILL.mdや必要な関連ファイルを所定のskillsディレクトリ内に生成するスキルである。
• スキルの配置先は、複数の作業で常用する場合のユーザー領域と、特定の案件だけで利用する場合のプロジェクト領域に分けられる。
• SKILL.mdは、YAMLフロントマターに名前と発動条件を含む説明を書き、その下へAIエージェントが従う手順をマークダウンで記述する構成である。
• SKILL.mdの説明は、いつ呼び出すべきか判断できる具体性を持たせつつ、常時参照される情報量を増やしすぎないよう簡潔にする必要がある。
• 詳細資料とスクリプトはSKILL.mdから分離し、必要な時だけ参照させることで、コンテキスト内の不要な情報とトークン消費を抑えられる。
• スキルは問題解決の手順である「どう進めるか」を主に担い、MCPは外部システムへの接続やツール提供を担うという整理が紹介されている。
• 🎬 このチャンネルの他の動画:
  • Claude Opus 4.5は開発に強いのか？
  • GPT-5 Proは実務で使えるのか？
  • 低価格なAIモデルサービスを選ぶ方法
• 📺 このチャンネル: まさおAIじっくり解説ch

Questions & Answers

Q: Agent Skillsとは何ですか？

Agent Skillsは、AIエージェントに新しい機能や専門知識を提供するためのフォーマットである。作業手順、スクリプト、参考資料などを用途ごとにまとめ、該当する依頼が来た時に読み込ませることで、同じ種類の作業を再現性のある流れで実行しやすくする。

Q: Agent Skillsを作り始める方法は？

最初にSkill Creatorをskillsディレクトリへ配置し、AIエージェントへ作りたいスキルの用途を伝える。動画では、公式のファイルをダウンロードして手動で配置する方法が勧められており、導入後はブログ生成などの目的を依頼すると必要な構成を作成できると説明されている。

Q: Skill Creatorはどこに配置すればよいですか？

常に利用したい場合はユーザーの.claude配下にあるskillsディレクトリへ置き、特定の案件だけで利用したい場合は、そのプロジェクト内の.claude配下にskillsディレクトリを作って配置する。用途の範囲に応じて、ユーザー領域とプロジェクト領域を使い分ける。

Q: SKILL.mdには何を書けばよいですか？

SKILL.mdには、YAMLフロントマターでスキルの名前と説明を記述し、その下に実行手順をマークダウンで書く。説明には、どのような依頼や状況で呼び出すべきかを判断できる情報を含める一方、詳細資料や長い説明は別ファイルへ分離して簡潔さを保つ。

Q: Agent Skillsの段階的開示とは何ですか？

段階的開示とは、最初から全ファイルをコンテキストへ入れず、起動時にはスキルの名前と説明だけを参照し、必要になった時にSKILL.mdや関連資料を読み込む考え方である。不要な情報を常時抱えずに済むため、コンテキストとトークンを効率的に使える。

Q: SKILL.mdを簡潔にする理由は何ですか？

SKILL.mdを簡潔にする理由は、必要な情報だけを読み込ませ、AIエージェントが処理するコンテキストを圧迫しないためである。起動時に参照される名前と説明は特に短く明確にし、詳細なパターン、資料、処理内容はreferencesやscriptsへ分けて必要時に参照させる。

Q: Agent SkillsとMCPはどう使い分けますか？

Agent Skillsは作業をどう進めるかという実践的な手順や知識を担い、MCPは外部システムへのアクセスやツール提供を担うものとして整理できる。動画の話者は、開発ツールなど常時使う機能はMCPに向き、限定的な処理はスキルとスクリプトでも実現できる場合があると述べている。

Q: 簡単なスキルと複雑なスキルはどう構成しますか？

簡単なスキルはSKILL.mdだけで構成できる。例として、Gitのコミット時に特定形式の文章を作るスキルが挙げられている。Slackへの通知やPDF処理など、処理手順やパラメーターが増える用途では、scriptsやreferencesを追加し、必要な情報を段階的に参照する構成にする。

Q: スキルの説明文はどの程度具体的に書くべきですか？

スキルの説明文は、AIエージェントが発動場面を判断できる程度に具体的に書く必要がある。ただし、条件を細かく固定しすぎると適用範囲や柔軟性を狭める可能性があるため、呼び出す状況を明示しながらも、不要な制約や冗長な情報は避ける。

Summary & Key Takeaways

• Agent Skillsは、AIエージェントへ新しい機能や専門知識を提供するためのフォーマットである。用途を示す名前と説明を常時参照できる状態にし、必要になった段階でSKILL.mdや関連資料を読み込ませる。手順書、スクリプト、参考資料を一つのまとまりとして管理できるため、同じ種類の作業で再現性の高い出力を得やすく、チーム内での共有にも利用できる。

• 導入の起点として紹介されているのがSkill Creatorである。公式のファイルを取得し、作業対象のプロジェクトに.claudeとskillsのディレクトリを作成して、その配下へ配置する。その後、作りたい用途を自然言語で依頼すると、SKILL.mdや必要な関連ファイルを含む新しいスキルを生成できる。常に使うものはユーザー領域、特定案件だけで使うものはプロジェクト領域に置き分ける。

• SKILL.mdにはYAMLフロントマターで名前と説明を書き、その下に実行手順を簡潔に記述する。詳細な説明はreferences、確定的な処理はscriptsなどへ分離し、必要時だけ参照させる。スキルは実践的な手順である「どう進めるか」を担い、MCPは外部システムへ接続するツールとして整理できる。ただし両者の機能は一部重なり、用途や常時利用の必要性に応じた選択が求められる。