/reload-skillsでディスク上のスキル変更を即時反映する
/reload-skillsはスキルとコマンドのディレクトリを再スキャンし、追加・削除された件数を報告するコマンドです。v2.1.152で追加されました。
/reload-skillsでディスク上のスキル変更を即時反映する
/reload-skillsはスキルとコマンドのディレクトリを再スキャンし、セッション中にディスク上で追加・変更されたスキルを再起動なしで使えるようにするコマンドです。実行すると、現在利用可能なスキルの件数と、追加・削除された件数をレポートします。v2.1.152で追加されました。
/reload-skillsは何をするコマンドか
/reload-skills実行すると、スキルディレクトリと.claude/commands/ディレクトリを改めて走査し、セッション開始後に加わった・消えたスキルを反映します。結果は件数で返るので、「今このセッションでいくつのスキルが使えるか」「前回からいくつ増減したか」をその場で確認できます。
対象になるのは~/.claude/skills、プロジェクトの.claude/skillsに加えて、--add-dirで追加したディレクトリの中の.claude/skillsも含みます。複数のディレクトリを横断してスキルを管理している場合でも、まとめて一度に再スキャンできます。モノレポでパッケージごとにスキルを分けているような構成でも、それぞれのディレクトリを1回のコマンドでまとめて確認できます。
SKILL.mdはすでに自動反映されるのに、なぜこのコマンドが要るのか
ここで疑問が浮かびます。Claude Codeは~/.claude/skillsやプロジェクトの.claude/skillsにあるスキルの追加・編集・削除を、セッション中に自動で検知して反映する仕組みをv2.1.0からすでに持っています。ファイルを保存すれば、次の呼び出しから新しい内容がそのまま使われます。つまりSKILL.mdの文面を直すだけなら、/reload-skillsを打たなくても反映済みのことが多いのです。
それでも/reload-skillsが独立したコマンドとして存在するのは、自動検知だけではカバーしきれない場面があるからです。
- コマンドディレクトリも対象に含む:
/reload-skillsは.claude/commands/ディレクトリも再スキャンします。スキル用の自動検知と違う経路で管理されているぶん、コマンドファイルだけを追加・変更したときに明示的な再スキャンの手段として機能します。 - 増減を数字で確認できる: 自動検知は静かに反映するだけで、何が変わったかを教えてくれません。
/reload-skillsは「何件のスキルが使えるか」「何件増え、何件減ったか」をレポートするので、複数のスキルを一括で追加・削除した直後に状態を確認したいときに使えます。 - 新しいトップレベルディレクトリには別の制約がある: セッション開始時に存在しなかった
.claude/skillsディレクトリそのものを新規作成した場合、公式ドキュメントは「Claude Codeを再起動してその新しいディレクトリを監視対象にする」よう案内しています。この特定のケースを/reload-skillsが代替できるかは明記されていないため、新しいトップレベルの.claude/skillsディレクトリを作った直後は再起動するのが確実です。
ネストした.claude/skills/ディレクトリ(サブディレクトリごとに配置するスキル)は、そのサブディレクトリ内のファイルにClaudeが初めて触れた時点で読み込まれる、別の経路を持っています。この経路と/reload-skillsの関係は公式ドキュメントに明記がないため、ネストしたスキルを確実に反映させたいときは、対象のサブディレクトリ内のファイルを一度編集・保存してから動作を確かめるのが無難です。
プラグイン由来のスキルとの違い(/reload-pluginsとの使い分け)
もう一つ整理しておきたいのが/reload-pluginsとの役割分担です。ライブ変更検知が自動でカバーするのはSKILL.mdのテキストだけです。プラグインとして配布されているスキルフォルダの場合、SKILL.md本文の編集は自動で反映されますが、hooks/・.mcp.json・agents/・output-styles/の変更は自動検知の対象外で、反映には/reload-pluginsの実行が必要です。
まとめると次のようになります。
| 変更対象 | 反映に必要な操作 |
|---|---|
個人・プロジェクトスキルのSKILL.md本文 | 反映に必要な操作自動反映(コマンド不要)。件数確認したいときは/reload-skills |
.claude/commands/配下のコマンドファイル | 反映に必要な操作/reload-skills |
プラグインスキルのSKILL.md本文 | 反映に必要な操作自動反映 |
プラグインスキルのhooks/・.mcp.json・agents/・output-styles/ | 反映に必要な操作/reload-plugins |
セッション開始時に存在しなかった新規のトップレベル.claude/skillsディレクトリ | 反映に必要な操作再起動 |
/skillsコマンドとの役割の違い
再スキャンして反映するのが/reload-skillsの役割なら、反映された結果を見て回るのは/skillsの役割です。/skillsは利用可能なスキルの一覧を表示し、名前で絞り込んだり、トークン数でソートしたり、SpaceキーでClaudeへの見え方(モデルが自動で呼び出すか、/メニューだけに出すか)を切り替えたりできます。
「増減が何件あったか」を知りたいときは/reload-skillsの実行結果を、「今どのスキルが使えて、それぞれどれくらいの容量か」を知りたいときは/skillsの一覧を見る、という使い分けになります。Claudeが自動で呼び出す対象から外し、/名前での手動呼び出し専用にする、といった調整もこの画面から行えます。
SessionStartフックからも再スキャンできる
/reload-skillsはユーザーがターミナルで手動で打つコマンドですが、同じ再スキャンの仕組みはフックからも呼び出せます。SessionStartフックがreloadSkills: trueを返すと、そのフックがインストールしたスキルを同じセッション内で使えるようにスキルディレクトリを再スキャンします。プロジェクトのセットアップスクリプトが動的にスキルを生成するような構成では、この仕組みを使えばユーザー側で明示的に/reload-skillsを打たなくても済みます。
つまり、再スキャンという処理そのものは/reload-skillsという手動コマンド専用の機能ではなく、フックのレスポンスからも起動できる共通の仕組みだということです。手元で試すだけなら/reload-skillsを打てば十分ですが、チーム全員のセッションで同じスキルセットを揃えたいときは、SessionStartフック側にreloadSkills: trueを仕込んでおく方が、各人が手動で打つ手間を省けます。
Cowork・クラウドセッションでは効果が及ばない範囲
/reload-skillsはローカルのディレクトリを再スキャンするコマンドなので、対象はあくまで手元のマシンで動いているセッションです。CoworkのセッションやRoutineを含むクラウドセッションは、手元のマシンにある~/.claude/skillsをそもそも読みません。読み込むのはclaude.aiアカウント側で有効化したスキルと、クローンしたリポジトリにコミットされたプロジェクトスキルです。
個人スキルが~/.claude/skillsにしか存在しない場合、Routineがそのスキルを呼び出そうとすると「見つからない」という結果になります。Routineの実行は、手元のマシンの状態を引き継がず、毎回まっさらなリモートセッションとして始まるためです。クラウド側でも同じスキルを使いたい場合は、リポジトリの.claude/skills/にコミットするか、リポジトリの設定で宣言したプラグインとして配布する必要があります。/reload-skillsはこの制約自体を解消するコマンドではなく、あくまでローカルセッション内の反映を助けるコマンドだと理解しておくと混乱しません。ローカルで動作確認が済んだスキルを、実際にクラウド側でも使うところまで含めて考えるなら、コミットして配布する手順まで一連の作業として見ておく必要があります。
なお、claude.aiアカウント側で有効化したスキルは、CLAUDE_CODE_SYNC_SKILLSを設定した非対話モード(-p)の実行時に~/.claude/skills/synced/へダウンロードされ、以降のローカルセッションではそこから読み込まれます。このディレクトリを/reload-skillsが再スキャンするかは公式ドキュメントに明記がありません。
スキルを削除したときの挙動
スキルのディレクトリそのものを削除した場合も、自動検知の対象です。個人・プロジェクトスキルなら、削除した時点で現在のセッションの/skills一覧からは消えます。ただし、削除する前にそのスキルを一度でも呼び出していた場合、そのときに読み込まれた内容はセッションが終わるまで会話の文脈に残り続けます。/reload-skillsを実行しても、この過去の呼び出し分が文脈から消えるわけではありません。プラグインとして配布されているスキルの場合は、プラグイン自体を無効化・アンインストールしてから/reload-pluginsを実行するか、セッションを再起動するまで一覧から消えません。
利用シーンごとの重要度
| 利用シーン | 重要度 | 理由 |
|---|---|---|
| ローカルでスキルを自作・改修している | 重要度高い | 理由増減の件数を確認しながら反復するのに向く |
.claude/commands/配下のコマンドファイルを変更した | 重要度高い | 理由この経路は/reload-skillsが対象に含む再スキャンの入り口 |
| Cowork・クラウドセッション(Routine含む)を主に使う | 重要度ほぼ影響なし | 理由~/.claude/skills自体を読まないため、反映の対象にならない |
よくある質問
プラグインスキルのフォルダに.claude-plugin/plugin.jsonを置くとどう扱われますか
プラグインスキルのフォルダに.claude-plugin/plugin.jsonを追加すると、そのスキルは<name>@skills-dirという名前のプラグインとして扱われます。これは命名規則の話であり、/reload-skills自体の再スキャン挙動を変えるものではありません。反映のさせ方は、そのフォルダの中身がテキスト(SKILL.md)か構成ファイル(hooks/等)かで前述のとおり分かれます。
実行するタイミングに決まりはありますか
決まったタイミングはなく、必要になった時点で打つコマンドです。複数のスキルやコマンドファイルをまとめて追加・変更した直後、反映漏れがないかを数字で確認したいときに実行するのが典型的な使い方です。
v2.1.152より前のバージョンでは使えませんか
使えません。/reload-skillsはv2.1.152で追加されたコマンドです。それより前のバージョンでは、スキルの自動検知(v2.1.0から)だけに頼ることになります。
増減の件数だけでなく、具体的に何が変わったか知りたいときは
/reload-skillsのレポートは件数までしか教えてくれません。どのスキルが増減したかを具体的に確認したいときは、実行後に/skillsでスキル名の一覧を見るか、変更したディレクトリを自分で見比べるのが確実です。
まとめ
/reload-skillsはスキルとコマンドのディレクトリを再スキャンし、増減を件数で報告するコマンドです。個人・プロジェクトスキルのSKILL.md本文はすでに自動で反映されるため、このコマンドの主な出番はコマンドディレクトリの変更確認と、変化を数字で把握したいときにあります。何を編集したかによって、待つだけでいいのか、コマンドを打つべきかが変わる点を押さえておくと迷いません。プラグイン由来のhooksやMCP設定の変更は対象外で、/reload-pluginsとの使い分けが必要です。スキルの書き方そのものはClaude Code Skills完全ガイド、コマンド全体の一覧はClaude Codeスラッシュコマンド一覧を参照してください。