
Claude CodeのSkills全訳に挑んだ記録|一瞬で利用制限に達した理由と、全スキルの要点
昨日、自己研鑽でClaude Codeを触っていて、コストに関わるかなり大きな失敗をしました。
同じ落とし穴を踏む人がいるかもしれないので、情報共有します。
何をしたのか
Claude Codeには「Skills」という仕組みがあります。
`SKILL.md`というファイルを読み込むだけで、特定のタスクに特化したエージェントのようにふるまってくれる機能です(GeminiでいうAgent Skills)。
このSkillsはGitHub上でたくさんの人が共有していて、数えてみると約140個ありました。
ただし、説明はほぼすべて英語です。
正直、140個を英語で読むのがしんどかったので、Claudeに「Skillsの説明を和訳して」と投げました。
結果:定額プランの利用制限に一瞬で到達。タスクも完了しませんでした。
なぜ起きたのか
原因を考察すると、おそらくこういう流れです。
「Skillsの説明を和訳して」と指示を出す
Claudeが該当の`SKILL.md`ファイルを読みに行く
ファイルを読み込んだことで、Skillsの発動トリガーが引かれる
約140個のエージェントが並列実行される
トークン消費が爆発し、一瞬で制限に到達
タスクは完了せず、制限だけが消費される
つまり「ファイルを読む」という行為自体が、Skillsの起動条件を満たしてしまったわけです。
翻訳を頼んだだけなのに、140個のエージェントが一斉に動き出す──予想外でした。
もし従量課金だったら?
定額プランだったので制限到達で済みましたが、API経由の従量課金だったらどうなるか。
Claude Sonnet 4.6の料金は、入力$3/100万トークン・出力$15/100万トークンです。
140個のSKILL.mdをそれぞれ読み込んで処理すると、入出力合わせて数百万トークンは消費される計算になります。
仮に500万トークン(入力300万+出力200万)消費したとすると、1回の操作で約$39(約5,800円) です。
しかも成果物はゼロ。純粋な無駄コストです。
大規模なプロジェクトで同じことが起きれば、金額はさらに跳ね上がります。
同じ失敗を避けるために
この経験から得た教訓は3つです。
① 大量のファイルを一括で処理させない
「全部まとめてやって」は便利ですが、Skillsのようなトリガー機構がある場合、意図しない連鎖反応が起きます。
まずは1〜2ファイルで試して、挙動を確認してからスケールするのが安全です。
② 「読むだけ」のつもりでも発動する仕組みがある
SKILL.mdはファイルを読み込んだ時点でエージェントとして起動する設計です。
「翻訳してほしいだけ」という意図は、Claude側には伝わりません。
③ 定額プランで試す価値がある
従量課金で未知の操作を試すのはリスクがあります。
定額プランなら制限到達で止まるので、最悪でも追加課金は発生しません。
新しい機能を試すときは、定額プランの範囲内で検証するのがおすすめです。
まとめ
「Skillsを和訳して」という何気ない一言が、140個のエージェント同時起動を引き起こしました。
Claude CodeのSkillsは強力な仕組みですが、ファイル読み込みがトリガーになる設計を知らないと、意図しないコスト消費につながります。
特に従量課金環境では、1回のミスが数千円単位の出費になり得ます。
同じ失敗をする人が一人でも減ればと思い、共有しました。
Claude Codeを1人で使う段階からチームで回す段階までを、読む順に7本まとめた有料マガジンも作りました。
Skillsの仕組みやコンテキストの扱いを体系的に押さえるなら、『実践Claude Code入門』が分かりやすかったです(アフィリエイトリンクを含みます)。【PR】Amazonのアソシエイトとして、佐藤賢治は適格販売により収入を得ています。
関連記事:
自己紹介 ── 元宇宙物理研究者が目指す、生成AIを活用した法人企業立ち上げ