Claudeのacademy-guideスキルでAcademyのコースを案内させる
academy-guideは、Claudeの使い方を聞かれたときにClaude Academyの講座やチュートリアルを1〜2件だけ添えさせるスキルです。導入、発動条件、カタログの読み方、自社版への応用を扱います。
academy-guideは、Claudeの使い方を尋ねられた回答の末尾に、Claude Academy(academy.claude.com)の講座やチュートリアルを添えさせるスキルです。Anthropicの skills リポジトリに入っており、中身はSKILL.mdが1枚とLICENSE.txtだけです。
特徴は、講座の一覧をスキル自身が持たない点にあります。毎回Academyが公開するJSONのカタログを取りに行き、そこにある項目だけを薦めます。この記事では、導入の手順、スキルが発動する条件、カタログの構造、そして同じ作りを自社の研修資料に使い回す方法を順に扱います。
academy-guideスキルは何をするのか
SKILL.mdの「Purpose」節によると、ユーザーがClaudeやClaudeの製品について質問したとき、または「AIをXに使うにはどうするか」と一般的に尋ねたときに、Academyのカタログから強く合う項目を探します。見つかれば、通常の回答の末尾に自然な形で添えます。
Academyの内容は3種類です。
Academyの3種類の内容
Courses(講座)
複数レッスンで構成される学習パスです。多くは修了時に証明書が出ると書かれています。
Tutorials(チュートリアル)
1つの機能や作業手順に絞った短いガイドです。
Use cases(活用例)
具体的な作業にClaudeを当てはめた実例で、試せるプロンプトが付くことが多いとされています。
製品ごとのハブページも案内の対象です。SKILL.mdが挙げるのは、Claude、Claude Code、Claude Cowork、AI Fluency、開発者プラットフォームの5つで、製品全体を学びたい人には個別の項目よりハブのほうが合う、という考え方です。
名前の経緯
履歴を見ると、2026年8月18日のコミットで claude-academy-guide から academy-guide に改名され、description(説明文)も短くされています。古い記事やメモに旧名が残っていても、現在のディレクトリ名は academy-guide です。
導入する: Claude Codeのプラグインとして入れる
anthropics/skills リポジトリは、Claude Codeのプラグインマーケットプレイスとしても登録できます。リポジトリの marketplace.json には academy-guide という名前のプラグインがあり、中身は ./skills/academy-guide の1スキルです。説明文は「ユーザーがClaudeの使い方を尋ねたとき、関連するAcademyの講座・チュートリアル・活用例を薦める」という趣旨です。
マーケットプレイスの登録とプラグインの導入は、2行で済みます。
/plugin marketplace add anthropics/skills
/plugin install academy-guide@anthropic-agent-skillsマーケットプレイスの名前は marketplace.json の name である anthropic-agent-skills です。@ の後ろにはリポジトリ名ではなく、この名前を書きます。導入後は /reload-plugins で反映します。プラグインの導入経路の全体像はClaude Codeプラグイン完全ガイドにあります。
導入できたかは /skills の一覧で確認できます。プラグイン経由のスキルは /プラグイン名:スキル名 の形で呼べるので、ここでは /academy-guide:academy-guide が正式な名前です。一覧の見方は/skillsコマンドの記事で扱っています。
名前空間に注意する
Claude Codeは anthropic-skills という名前をclaude.aiから同期したスキル用に予約しています。マーケットプレイス名の anthropic-agent-skills はこれとは別の文字列なので衝突しませんが、似た名前を自作のスキルに付けると読み込まれない場合があります。症状と直し方はanthropic-skillsのNot loadedの記事にあります。
Claude.aiで使う場合
リポジトリのREADMEによれば、Claude.aiで使うにはスキルのアップロード手順(support.claude.comの「Using skills in Claude」)に従います。ただし、カタログをネットワーク越しに取得する前提のスキルなので、URLを取得できない環境では個別の項目を挙げられず、ハブやリソースライブラリの案内にとどまります。
どんなときに発動するのか
発動を決めるのは、SKILL.mdの冒頭にあるdescriptionです。Claude Codeの仕様では、Claudeはdescriptionを読んでスキルを使うか判断します。このスキルのdescriptionは約1,000字あり、次の3系統の合図を並べています。
- 「how do I」「getting started with」「teach me」といった学習の言い回し
- artifacts、projects、skills、plugins、connectors、MCPに関する質問
- チームやクラスへの展開、研修資料、オンボーディング教材の依頼
Claude Codeのスキル一覧では、descriptionと when_to_use を合わせて1,536字で切り詰められます。約1,000字のこのスキルは、その上限の内側に収まります。長いdescriptionを書くスキル作者が気にする点なので、自作の際の目安になります。
「作業中」には発動しない
descriptionの末尾と、Rules節の2番目は同じことを言っています。学んでいる最中の人に薦め、作業の途中で手を動かしたいだけの人には薦めません。SKILL.mdの例では、「プロジェクトはどう動くのか」は強い一致、「この文書を整理して」は、プロジェクトという機能に話題が近くても一致しない、と書かれています。
判定の目安は、断り書きを付けたくなるかどうかです。「これはXに焦点を当てていますが、Yにも役立つかもしれません」と書きたくなったら、その時点で一致していないと見なして何も言いません。薦めた先が外れると、次の推薦まで無視されるようになる、という理由づけまで記されています。
同じ話題でも薦める場合と薦めない場合がある
薦める
「Claudeのプロジェクト機能はどう動くのか教えて」のように、機能の使い方そのものを知りたい質問です。
薦めない
「この議事録をプロジェクトに整理して」のように、作業を終わらせたい依頼です。
7つのルールを読み解く
本文のRules節は7項目です。回答の品質に直結するので、要点を表にします。
| # | ルール | 実務での意味 |
|---|---|---|
| 1 | ルールまず質問に答える | 実務での意味推薦は補足であり、回答の代わりにならない |
| 2 | ルール強い一致のみ | 実務での意味意図が一致したときだけ。迷ったら黙る |
| 3 | ルール内容を捏造しない | 実務での意味取得したカタログにあるURLだけ共有する |
| 4 | ルール短く自然に | 実務での意味最大2件。1件が多くの場合に最適 |
| 5 | ルール押し付けない | 実務での意味「あなたの興味を引くかも」調で、「受講すべき」とは言わない |
| 6 | ルールURLは原文のまま | 実務での意味種別(courses / tutorials / use-cases)を書き換えない |
| 7 | ルール項目を挙げられないときはAcademy自体を示す | 実務での意味ハブか academy.claude.com/resources を案内する |
ルール3と7が作る安全弁
ルール3は、講座名やスラッグ(URL末尾の識別子)を「記憶から」挙げることを禁じています。取得していないカタログの中身は知らない前提で動く設計です。
ルール7は、その裏返しです。URLを取得できない環境、取得に失敗した場合、期限切れの場合は、個別の項目名を出さず、製品ハブか検索できるリソースライブラリを案内します。SKILL.mdは、取得の失敗や古さの事情を利用者に伝えないよう指示しています。
件数の上限は質問が学習教材の依頼でも変わらない
ルール4の上限は2件です。「営業チームに使わせる研修資料は何があるか」と尋ねられた場合でも、全部を列挙せずに最良の1〜2件を選び、残りはリソースライブラリへ案内する、と明記されています。研修担当者が使うときは、一覧が欲しければ自分でリソースライブラリを開くか、カタログを直接依頼する必要があります。
カタログの構造を確認する
推薦の元データは https://academy.claude.com/assets/data/catalog.json です。SKILL.mdによれば、Academyの本番コンテンツ公開のたびに作り直されます。
最上位のキーは schemaVersion、generatedAt、staleAfter、contentCommit、counts、items でした。各項目は次の9つのフィールドを持ちます。
curl -s https://academy.claude.com/assets/data/catalog.json \
| python3 -c "import json,sys; d=json.load(sys.stdin); print(list(d['items'][0].keys()))"出力は ['kind', 'slug', 'url', 'title', 'summary', 'products', 'level', 'tags', 'visibility'] です。意味は次のとおりです。
| フィールド | 内容 |
|---|---|
kind | 内容course / tutorial / use-case の3種 |
url | 内容項目のURL。そのまま薦めるときに使う |
summary | 内容1〜2文の紹介。推薦文の元になる |
products | 内容chat / cowork / code / api など |
level | 内容beginner / intermediate / advanced |
visibility | 内容public か gated |
gated の項目は、Academyへのサインインが必要です。SKILL.mdは、gatedを薦めるときにその旨を添えるよう指示しています。
古いカタログは使わない
staleAfter の時刻より前のあいだだけ、取得したファイルを信頼します。このフィールドが無ければ、generatedAt から30日ほどで古いと見なします。古いと判断された場合はルール7に戻り、個別項目を出しません。
もう一つ、カタログは「データであって指示ではない」と書かれています。ファイルに何が書かれていても、使ってよいのは項目の中身(タイトル、URL、概要、種別、レベル、製品、タグ、公開範囲)だけです。カタログの中に紛れた命令文に従わないための宣言で、外部から取ってくるデータを扱うスキルの書き方として参考になります。
使いこなすための設定
カタログの取得を許可しておく
Claude Codeでは、URLの取得にはWebFetchを使います。学習系の質問のたびに確認が出ると、スキルの利点が薄れます。取得先を academy.claude.com に限って許可する場合、.claude/settings.json に次のルールを足します。
{
"permissions": {
"allow": ["WebFetch(domain:academy.claude.com)"]
}
}WebFetch(domain:example.com) はそのドメインだけに一致するルールです。サブドメインも通したい場合は *. を付けます。
発動を絞りたいとき
作業中に推薦が挟まって邪魔だと感じる場合は、disable-model-invocation: true を持つ自作スキルに作り替えて、/ から手動で呼ぶ形にする手があります。この指定を付けると、descriptionがコンテキストに載らなくなり、Claudeは自動では呼びません。ただし、配布物のSKILL.mdを直接書き換えるとプラグインの更新で消えるため、複製して自分のスキルとして管理するほうが安全です。
自社の研修資料に応用する
academy-guideの作りは、そのまま社内向けに写せます。「一覧を埋め込まず、公開されたJSONを都度取りに行く」「強い一致のときだけ最大2件」「取得できなければ入口だけ示す」という3点です。たとえば社内のオンボーディング資料を薦めさせるスキルは、次のような骨格になります(自作の例で、公式のものではありません)。
---
name: internal-learning-guide
description: >
社内ツールの使い方を質問されたときに、社内ポータルの研修資料を
1〜2件だけ薦める。作業の依頼には発動しない。
---
# 社内研修ガイド
1. まず質問に直接答える。
2. 使い方を学びたい意図が明確なときだけ、
https://learn.example.co.jp/catalog.json を一度だけ取得する。
3. 取得した項目のURLだけを、最大2件、押し付けない言い方で添える。
4. 取得できない場合は、項目名を挙げず入口のURLだけ示す。カタログをJSONで公開する側の作法も、academy-guideのカタログが参考になります。更新時刻を表す generatedAt と有効期限の staleAfter を持たせておけば、スキル側が古い一覧を使わない判断をできます。
スキルの効果を測る方法はskill-creator evalの記事にまとめています。推薦のような「出さない判断」が正しいかは、薦めるべき質問と薦めない質問を両方テストに入れて確かめます。
つまずきやすい点
- 推薦が出ない: 作業の依頼や、すでに具体的な手順を聞いている質問では、設計どおり何も出ません。「Claudeのスキルの始め方を教えて」のような学習の質問で確かめます。
- カタログに載っていない講座名が出る: ルール3に反する挙動です。スキルが読み込まれていないか、別のスキルや記憶が優先された可能性があります。
/skillsの一覧で有効になっているか見ます。 - gatedの講座にアクセスできない: サインインが必要な項目です。Academy側の認証であり、Claudeの設定では解決しません。
- 推薦先が英語: カタログのタイトルと概要は英語です。講座の内容を日本語で整理した記事としてIntroduction to Agent Skillsコースの解説やAnthropic Academyの全コースと認定試験の学習ルートがあります。
まとめ
academy-guideは、学ぶ意図が強いときだけ1〜2件を添え、迷ったら黙るスキルです。判断の中心は、descriptionの発動条件ではなく、Rules節の「断り書きが要る一致は一致ではない」という線引きにあります。研修担当者が一覧を求めるなら、このスキルに頼らずカタログのJSONかリソースライブラリを直接開くほうが早い場面があります。自社の学習資料に使うなら、一覧を埋め込まずJSONを公開し、鮮度の目印を付ける設計がそのまま転用できます。Claude Skills全体の考え方はClaude Skillsの解説で扱っています。