【経営者向け】Claude のカスタムスキルが「古い版に戻る」のはなぜ?仕組みから分かるトラブル解消ガイド

オフィスのデスクでパソコンを見ながら困惑した表情をする50代男性経営者。Claudeのカスタムスキルが古い版に戻る問題に悩まっている様子。

「先週ちゃんと改良したはずなのに、今日 Claude を立ち上げたら昔の動きに戻っている…どうして?」

AI を業務に取り入れている経営者の方から、最近よくいただく相談です。

Claude(クロード)のスキル機能を使いこなそうと熱心に取り組んでいる方ほど、この「巻き戻り現象」に悩まされます。

本記事では、その原因を技術用語を極力使わずに整理し、「どこをチェックすれば直るか」がご自身で判断できるところまでお話しします。

A 社長:「Claude のスキル、職場のパソコンでは効くのに、自宅から開くと古い版が動くんですよ。ちゃんと最新版をオンラインに上げてあるはずなんですが…」

B(HABAねっと):「ああ、それは”オンラインに上げた=Claudeに反映された”と思い込むのが落とし穴なんです。実は Claude が見にいく場所は、社長が思っている場所とは違うんですよ」

A 社長:「え、じゃあどこを見ているんですか?」

01 その前に:「カスタムスキル」とは何か

本題に入る前に、ひとつだけ整理させてください。

本記事で扱う「スキル」は、Claude にあらかじめ組み込まれている公式機能ではなく、利用者が自分で作って Claude に教え込んだ「カスタムスキル」のことです。

たとえば「毎日の日報をこの様式で作ってほしい」「自社サイトに記事を投稿するときはこの手順で進めてほしい」といった、自社独自の業務手順を Claude に覚えさせたものを指します。Claude を業務に深く組み込み始めると、自然と数個〜十数個のカスタムスキルを抱えることになります。

このカスタムスキルを複数の利用環境(職場 PC・自宅 PC・スマホ)で同じように使いたいと考えたときに、本記事のトラブルが顔を出します。

02 起きている事象

カスタムスキルを複数の環境で使い回していると、次のような症状が出ます。

  • 職場の PC では使えるスキルが、自宅では一覧に表示されない
  • オンラインのファイル保管場所には最新版を上げたのに、Claude が動かしているのは古い版
  • 「このスキルを最新版に上げ直して」と Claude に頼むと、エラーで止まったり、「成功しました」と返事をするのに実際は更新されていない

これらは個別の不具合ではなく、Claude のスキルが「どこに保管されているか」を知らないと、原理的にハマってしまう現象です。

逆に言えば、仕組みを一度理解すれば二度と迷いません。

03 Claude のスキル保管場所は「3 つに分かれている」

多くの方が混同しがちですが、Claude のカスタムスキルは利用シーンごとに別々の場所に保管されています。同じ名前のスキルでも、実体は 3 つ存在することがあります。

利用シーン保管されている場所スキルの登録方法複数端末での同期
① ブラウザ版・スマホアプリ・デスクトップアプリの ClaudeClaude を提供している会社のサーバー(ご自身のアカウントに紐付け)設定画面から ZIP ファイルをアップロード自動で同期(同じアカウントで開けばどの端末でも同じ)
② Claude Code(開発者向けの黒い画面で使うツール)その PC の中だけPC の中にファイルを直接置く同期されない(PC ごとに別物)
③ Claude Cowork(デスクトップ版の高機能タイプ)②と同じローカルPC(C:Users[ユーザー名].claudeskills)②と同じ仕組み同期されない(PC ごとに別物)

つまり、「オンラインのファイル保管庫(多くの場合は GitHub というサービス)」を自分なりのマスター倉庫として運用していても、Claude 自身は GitHub を直接見にいくわけではありません

GitHub はあくまでマスター倉庫です。各環境へ反映するには、それぞれ手動操作が必要です。

  • ① ブラウザ版・スマホ・デスクトップアプリ:設定画面から旧版を削除し、新しい ZIP を手動でアップロードし直す(GitHub とは無関係な操作)
  • ②③ Claude Code・Cowork:各 PC で git pull などを使って GitHub から取り込み直す
ご自身の PC で編集GitHub(マスター倉庫)① ZIP を手動アップロード/②③ git pull で取り込みClaude がようやく見る

04 Claude がスキルを呼び出す仕組み

Claude はスキルの中身を全部覚えているわけではありません。会話を始めた時点では、各スキルの「見出しと説明文」だけを頭に入れています。

ユーザーの発言が「あ、このスキルの説明と合致するな」と判断されたとき、初めてそのスキルの本体を読み込みます。

会話開始:見出しと説明文だけ把握

ユーザーの発言と説明文がマッチ

該当スキルの本体を読みにいく

必要なら関連資料も追加で読む

これは賢い設計なのですが、ここで大事なのは 「Claude が読みにいくのは、今このときに動いている環境にあるスキルだけ」 という点です。

GitHub に最新版があっても、それが ①〜③ のいずれかに反映されていなければ、Claude は古い版を読み続けます。

05 「自動アップデート」が失敗する 5 つのパターン

「いちいち手作業で配り直すのは面倒だから、Claude に頼んで自動でやらせよう」——こう考えた方は、自分で「スキルを GitHub に上げ直すためのカスタムスキル」を作っているはずです。これも公式機能ではなく、利用者が工夫して組んだ自前の仕組みです。

しかし、この自動化スキルが裏側でやっていることは、実はかなり遠回りで、構造的に失敗しやすい箇所が複数あります。

パターン A:書き込み禁止エリアに書き込もうとして失敗

Claude が動いている作業場所は、いわば「読むのは自由だけど、書き込みは禁止」のフォルダです。専門用語ではこの作業場所を「サンドボックス」と呼びます。(※サンドボックスとは「砂場」の意味で、外部に影響を与えないように区切られた安全な作業エリアのこと。Claude が暴走して大事なファイルを壊さないよう、こうした安全装置がついている)

Claude がスキルを直接書き換えようとしても、書き込み権限がないため失敗します。エラーで止まればまだいいのですが、「ローカルでは更新できなかったが、新しい中身は記憶している」という中途半端な状態のまま次の作業に進みます。

パターン B:文章の中の特殊な記号で構文が壊れる

サンドボックスの中から GitHub に直接アクセスできない環境では、ブラウザを経由してファイルを送るという回り道が必要になります。このとき、スキルの内容を長い文字列としてプログラムの中に組み込んで送るのですが、スキルの説明文に含まれる特殊な記号(バックスラッシュ、引用符、コードを示す囲み記号など)がプログラムの構文を壊してしまうことがあります。

結果として、エラーで止まる、あるいは中身が途中で切れたまま送信されてしまうといった事故が起きます。

パターン C:日本語の文字化け(成功扱いになるのが厄介)

ファイルを送るときに、内容を一旦「機械語のような暗号」に変換します。この変換手順に古い書き方が紛れ込んでいると、日本語(特に絵文字や記号)が稀に文字化けします。

厄介なのは、送信は「成功」したように見えてしまうことです。GitHub 上で実物を確認すると、ファイルの一部が文字化けしていたり、末尾が欠けていたりします。エラーが出ないため、気づかずに何日も古い情報のまま運用してしまうリスクがあります。

パターン D:別の経路で先に更新されていた

GitHub にファイルを上書きするときには、「最新版の目印(識別番号)」を一緒に送る必要があります。別の経路(たとえば自宅 PC から手作業で上げた、など)で先にファイルが更新されていると、Claude が握っている目印が古くなり、上書きが拒否されます

これも「失敗しました」と表示されるだけで、原因が見えにくいパターンです。

パターン E:ブラウザ連携の不調

そもそもブラウザの拡張機能が無効になっている、ブラウザが起動していない、GitHub にログイン中のアカウントが別人のものになっている、といった環境要因で、自動化スキル自体が動かないこともあります。

06 失敗パターンの一覧と「気づきやすさ」

パターン原因症状気づきやすさ
A書き込み禁止エリアに書こうとしたエラー表示、ローカルが古いまますぐ気づく
B文章中の特殊記号で構文が壊れるエラー、または中身が途中で切れる気づきにくい
C日本語の文字化け「成功」と出るが、中身は壊れている非常に気づきにくい
D別経路で先に更新済み上書き拒否のエラーエラーで分かる
Eブラウザ連携の不調自動化スキルが動かないすぐ気づく

特に注意すべきは パターン C です。「成功しました」と表示されるため、ユーザーは安心してしまいますが、実際は GitHub 上のファイルが壊れています。

「自動化したのに、なぜか古い情報のままだ」と感じたら、GitHub 上で実ファイルを目視確認する習慣をつけることが、唯一の防御策です。

07 もう一つの落とし穴:GitHub に上げても各環境は更新されない

仮にパターン A〜E をすべて切り抜けて GitHub への送信が成功しても、それだけでは ①②③ のいずれの環境も自動では更新されません。GitHub はあくまで「マスター倉庫」であって、Claude が直接読みに来る場所ではないからです。

利用シーンGitHub 更新直後最新版を反映するには
① ブラウザ版・スマホアプリ等古いまま設定画面から旧版を削除し、新しい ZIP を手動でアップロード
② Claude Code(黒い画面)古いまま各 PC で最新版を取り込み直す
③ Cowork古いまま各 PC でファイルを直接更新(②と同じ手順)

さらに知っておきたいのが、「いま会話中の Claude」は途中で最新版を読み直さないという点です。

Claude は会話を始めた瞬間にスキルの一覧を頭に入れるため、会話の途中でファイルを更新しても、その会話中は古い認識のままです。

新しい会話を始めて初めて、最新版が反映されます

08 まとめ:3 つの保管場所 × 5 つの失敗 × 3 ステップの確認

「Claude のスキルが古い版に戻る」現象は、次の組み合わせで説明できます。

3 系統 ブラウザ版 / Code / Cowork
それぞれ別の場所に保管
5 パターン 自動アップデート時の
典型的な失敗要因
3 ステップ どこが遅れているか
切り分ける確認手順

「いま自分はどこを見ているのか」を切り分けるには、次の 3 ステップを順に確認するのが効率的です。

  1. ブラウザ版 Claude の設定画面で対象のカスタムスキルを開き、中身を確認 → ① と ③ の状態が分かる
  2. 各 PC でスキルファイルの更新日時を確認 → ② の状態が分かる
  3. GitHub の更新履歴と突き合わせ → どこが遅れているかが特定できる

09 同じ症状で困っている経営者の方へ

「ちゃんと上げたのに反映されない」という症状は、AI ツールの不具合ではなく、Claude のスキル機構の設計と運用フローの間にあるギャップから生じる構造的な現象です。

原因を切り分けるには、まず「3 つの保管場所のうち、いま自分はどこを見ているのか」を意識することが第一歩です。

自動アップデート用のカスタムスキルをご自身で作って運用している場合は、特に パターン C(文字化けでも成功扱い) に注意してください。自動化を信頼しきってしまうと、サイレントに古い情報が温存されます。

送信完了後に、GitHub 上で実ファイルの中身を目視で確認する——この一手間が、月単位の混乱を防ぎます。

本記事のポイント

① 本記事で扱う「スキル」は公式機能ではなく、利用者が自分で作って Claude に教え込んだカスタムスキルである
② Claude のスキルは「ブラウザ版 / Claude Code / Cowork」の 3 系統に別々に保管されており、GitHub はあくまでマスター倉庫である
③ 自動化を信頼しすぎず、特に「成功扱いでも実は壊れている」文字化けパターンに注意し、GitHub 上で目視確認する習慣をつける

HABAねっとは、北陸を拠点に中小企業・個人事業主の DX 伴走支援を行っています。AI ツールの「使い方」だけでなく、「使い回す仕組み」まで含めて設計することで、現場で詰まらない運用を一緒に組み立てます。学びながら自社流に育てたい経営者の方を歓迎します。

サービス一覧 → / お問い合わせ →

シェアする Facebook X (Twitter)