Claude Codeのスキルが日本語で起動しない理由と解決策 — 多言語AIツールの設計思想を読み解く

@yurukusa さんが投稿で指摘している「スキルを作ったのに自動で起動しない」という問題は、Claude Codeユーザー、特に日本語話者の間で頻繁に報告されている課題です。せっかく時間をかけてカスタムスキルを作成したのに、実際の会話では全く発火せず、手動で呼び出す羽目になる——これでは自動化の意味がありません。

この問題は単なるバグではなく、AIツールの多言語対応における構造的な課題を浮き彫りにしています。なぜ英語では動作するのに日本語では動作しないのか、その本質を理解することで、より効果的なスキル設計が可能になります。

Claude Codeのスキルが自動起動しない主な原因は、**スキルの説明文と実際のユーザー入力の言語が一致していない**ことにあります。

Claude Codeは、ユーザーの発言内容とスキルの説明文（description）を照合して、どのスキルを起動すべきかを判断します。このマッチング処理は意味的な類似性に基づいていますが、言語が異なると類似度スコアが大幅に低下します。

具体的には以下のようなケースで問題が発生します：

意味的には完全に一致しているにもかかわらず、言語が異なるため埋め込みベクトル空間上での距離が遠くなり、スキルが起動されません。Claude Codeは明示的な多言語マッチングを行っていないため、このギャップを埋めることができないのです。

他のAIツールとの比較

この問題は、Claude Code特有のものではありません。ChatGPTのカスタムGPTsやFunction Callingでも同様の課題が報告されています。違いは、各ツールがこの問題にどうアプローチしているかです。

**ChatGPTのFunction Calling**は、関数名と引数の型定義に依存するため、言語の影響は比較的小さいものの、descriptionフィールドが英語中心である点は変わりません。一方、**GitHub Copilot**のようなコード補完ツールは、コンテキスト（コメントやコード）から意図を推測するため、コメントを日本語で書いても比較的機能しますが、これはスキル起動とは異なるメカニズムです。

Claude Codeの問題は、**意図検出型のスキル起動メカニズム**と**多言語対応の不完全性**の組み合わせから生じています。

メリットと注意点の両面分析

**この設計のメリット**：

**注意すべき制約**：

この問題を理解すると、Claude Codeは「グローバル標準としての英語」を前提に設計されていることが明らかになります。これは技術的判断であり、英語のトレーニングデータが豊富であること、開発チームの主要言語が英語であることなどが背景にあります。

適用範囲の考察

この問題が特に影響するのは以下のユーザーです：

逆に、英語でのコミュニケーションに抵抗がないユーザーや、すでに英語でプロンプトを書く習慣があるユーザーには影響は限定的です。

1. スキル説明文をバイリンガルで記述する

スキルのdescriptionフィールドに、英語と日本語の両方を含めます：

{
  "name": "performance_analyzer",
  "description": "Analyze code performance and suggest optimizations. コードのパフォーマンスを分析し、最適化を提案します。"
}

これにより、どちらの言語で話しかけても類似度スコアが向上します。冗長に見えますが、現時点では最も確実な対処法です。

2. システムプロンプトで言語設定を明示する

Claude Codeのシステムプロンプトに、使用言語とスキル起動の期待動作を明記します：

ユーザーは主に日本語でコミュニケーションを取ります。
日本語の指示に対しても、関連するスキルを積極的に起動してください。
スキルの説明文に含まれる英語と日本語の両方を考慮してマッチングを行ってください。

3. 起動キーワードを意図的に含める

確実にスキルを起動したい場合、スキル名や特徴的なキーワードを会話に含めます：

スキル名を直接指定するのは理想的ではありませんが、重要な作業では確実性を優先すべきです。

Claude Codeのスキルが日本語で起動しない問題は、AIツールの多言語対応がまだ発展途上であることを示しています。完全な解決には、Anthropic側での埋め込みモデルの改善や、明示的な多言語マッチング機能の実装が必要です。

しかし、ユーザー側でも工夫次第で問題を軽減できます。バイリンガルな説明文、明示的なシステムプロンプト、そして起動キーワードの戦略的使用——これらを組み合わせることで、日本語環境でのClaude Code活用がより実用的になります。

AIツールは万能ではありません。その制約を理解し、適切に対処することが、真のAI活用スキルと言えるでしょう。

この情報は @yurukusa さんの投稿を参考にしています。