◉CLAUDE LABEN
●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です
記事一覧/Claude Code
⟐ Claude Code/2026-08-24上級

同じスキルを二か所に置いていたら、片方だけ中身が痩せていました

同名のスキルが二つのスコープに存在していました。SKILL.md は sha256 まで一致しているのに、片方には本文が名指ししているファイルが入っていません。66本を走査して欠落2件に絞るまでに検出器を三度書き直した記録です。

Claude Code292スキル設計名前空間3整合性検査運用28

✦ プレミアム記事

8月23日のリリースノートに、一行だけ気になる修正がありました。同梱スキルのエイリアスが、同名のユーザースキルやプロジェクトスキルに影を作られて「Unknown command」を返す問題が直った、という記述です。

自分には関係のない話だと思いました。私が使っているスキルはどれも名前を分けて付けたつもりでいたからです。

念のため数えてみました。プロジェクト側に 42 本、ユーザー側に 24 本、合わせて 66 本。そのうち 5 本が同じ名前で二か所に存在していました。

そこまでは、まだ想定の範囲でした。問題はその先です。5 組すべてで SKILL.md が sha256 まで一致していたのに、そのうち 2 組は同梱ファイルの数が違っていました。

名前の衝突は、それ自体では事故になりません

どちらが選ばれるかという解決順序の話は、以前 呼んだはずのスキルが何も返さない — 起動前に名前の解決順序を確定させる で扱いました。あのときの結論は「実効名の表を起動前に作る」でした。

今回ぶつかったのは、その先にある層です。実効名が確定していても、選ばれた実体が完全とは限りません。

同名のスキルが二か所にあるとき、多くの人はまず本文を見比べます。私もそうしました。

diff .agents/skills/seo-audit/SKILL.md ~/.claude/skills/seo-audit/SKILL.md
# 出力なし(差分ゼロ)

差分ゼロ。バイト数も 10,688 で一致。ここで安心して閉じました。

閉じてから、ディレクトリ全体を見ていないことに気づきました。

欠けていたのは本文ではなく、本文が名指ししているファイルでした

同じ 2 つのディレクトリを、ファイル単位で並べます。

(cd .agents/skills/seo-audit && find . -type f | sort)
# ./SKILL.md
# ./evals/evals.json
# ./references/ai-writing-detection.md
 
(cd ~/.claude/skills/seo-audit && find . -type f | sort)
# ./SKILL.md

本文は同一。付随するファイルは 3 対 1。

そして SKILL.md の本文には、次の一行が入っています。

references/ai-writing-detection.md

つまり、ユーザースコープ側が選ばれた場合、スキルは実在しないファイルを読みに行くことになります。SKILL.md が完全に一致しているせいで、diff でも sha256sum でも、この状態は検出できません。

欠けていた references/ai-writing-detection.md は 6,528 バイト。SKILL.md 本体の約 61% に相当する分量が、参照されているのに存在しない状態でした。

比較の観点プロジェクト側ユーザー側気づけるか
SKILL.md の内容10,688 バイト10,688 バイト(同一)気づけない
SKILL.md の sha256一致一致気づけない
ディレクトリ内のファイル数31気づける
本文が名指しする参照の実在すべて実在1 件が不在気づける

上の 2 行だけを見て運用していたのが、私の見落としでした。

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦同じ名前のスキルが複数のスコープに置かれているとき、選ばれた側が完全かどうかを自分の環境で確かめられるようになります
✦SKILL.md が一致していても壊れる型の不具合を、参照先の実在確認という一手で公開前に潰せるようになります
✦検出器が返す件数をそのまま信じず、偽陽性と偽陰性を切り分けてから判断できるようになります
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

⟐ Claude Code2026-08-06
呼んだはずのスキルが何も返さない — 起動前に名前の解決順序を確定させる
端末の組み込みコマンドと同名のスキルは、非対話セッションで呼び出しが解決されないことがあります。実効名の表を起動前に作る preflight を書いて走らせ、検査器自身が取りこぼしていた2件までを実測で洗い出した記録です。
⟐ Claude Code2026-11-06
Claude Code は四週間で二十一回更新されていました。追う頻度を決める前に公開履歴を数えた記録
Claude Code の更新を毎日確かめるか、週に一度にするか。npm の公開履歴を標準ライブラリだけの Python で数え、直近 28 日の公開本数と間隔から、更新を追う頻度の目安を決めました。
⟐ Claude Code2026-10-24
「今後は確認しない」を押し続けた設定ファイルに、python3 が丸ごと通る一行がありました — 2.1.309 の更新履歴を読んで始めた許可ルールの棚卸し
2.1.309 は権限チェックとサンドボックスの修正が並ぶ版です。自分の settings.local.json の許可ルールを棚卸しするスクリプトと、インタプリタへの接頭辞ワイルドカードを見つけたときの直し方をまとめます。