スキルを直したのに反映されない、が起きなくなった話。Claude Codeのホットリロードを試してみた

Claude Codeのスキルを直したら、保存した瞬間にそのまま使えるようになった。以前は直すたびに再起動して、セッションを開き直して、また試して……を繰り返していた。

スキルを1行直すたびに、再起動していた
スキルのホットリロードで、待ち時間がゼロになった
実際に直してみた体感
注意点：クラウド共有のスキルはまだ対象外
今日からできること
あわせて読みたい

スキルを1行直すたびに、再起動していた

スキルの中身を直しても、動いているセッションには反映されない。だから毎回、再起動して確認していた。

スキル（Claudeに「こういう時はこう動いて」と教えるマニュアルファイル）は、書いたその場では反映されない仕様だった。文言を1行直しても、今動いているセッションはずっと直す前のバージョンのまま読み続ける。

確認するには、いったんセッションを閉じて、開き直して、また同じ指示を投げて……という手順が必要だった。1回の確認サイクルはだいたい3分（終了10秒＋起動20秒＋前提の説明1分＋動作確認1分）。文言の微調整で10回試すと、それだけで30分が消える。中身を直している時間より、確認の待ち時間のほうが長いことも珍しくなかった。

スキルのホットリロードで、待ち時間がゼロになった

ホットリロードとは

プログラムやアプリを再起動しなくても、ファイルを保存した時点で変更がその場に反映される仕組み。Webサイト制作などでは以前からある考え方で、それがClaude Codeのスキルにも入った。

Claude Codeにスキルの自動ホットリロードが入り、`~/.claude/skills` や `.claude/skills` に置いたスキルファイルを直して保存すると、そのセッションのまま次の指示から新しい内容で動くようになった。さらに後のアップデートで、任意のタイミングでスキル一覧を強制的に読み直す `/reload-skills` コマンドも追加された。

スキルを直したのに反映されているか不安なとき、会話を止めずにこう打つ：
/reload-skills

これを打つと、会話の文脈は保ったまま、スキルの一覧だけを読み直してくれる。セッションを閉じる必要がない。

実際に直してみた体感

旧仕様は「1行直す → セッション終了 → 再起動 → 前提を話し直す → やっと確認」の繰り返し。今は「保存 → 次の指示ですぐ確認 → 気に入らなければまた1行直す」を数十秒サイクルで回せる。

この記事のもとになっている自動投稿の仕組みも、スキルとして動いている。文面のトーンや構成ルールを1行直したいとき、以前なら「直したはいいけど、次の投稿まで反映されているか分からない」という状態だった。今は直した直後に同じ会話の中で試せるので、微調整の回数そのものが増えた。30分かかっていた確認作業が、体感ほぼゼロになった分、そのぶん中身の調整に時間を回せている。

注意点：クラウド共有のスキルはまだ対象外

自分のPC上のスキルはその場で反映される。ただしチームで共有しているクラウド経由のスキルは、2026年7月時点でまだ即時反映の対象外。

ホットリロードが効くのは、自分の手元のフォルダに置いたスキルファイルを直したときの話。組織やチームでクラウド経由で配布・共有しているタイプのスキルは、プラグインとして扱われるため今のところ即座には更新されず、従来どおりセッションを開き直す必要がある。「直したのに変わらない」と思ったら、まずそのスキルがローカルかクラウド共有かを確認するとよい。