Claude Skillsが命令を静かに上書き：文書化されていない落とし穴が露呈

RedditユーザーがClaude Skillsを調査したところ、明示的な指示を無視する複数の隠れた動作が、skill-creatorにドキュメントがないまま存在することが判明しました。以下がその発見内容です。

Claude Skillsの主要な落とし穴

• ask_user_input_v0のハードリミット：このツールは最大3つの質問と、質問あたり4つの選択肢を強制します。スキルがそれを超えて要求すると、Claudeは黙って圧縮します。エラーは発生しません。
• ファイル書き込みの不整合：Code/Desktopでは、Writeは既存のファイルを黙って上書きします。Claude.aiでは、create_fileは上書きを拒否します。同じ指示で逆の動作です。
• references/の相対パスが機能しない：公式に推奨されているreferences/パターンは、どのプラットフォームでもスキルのディレクトリからの相対パスを解決しません。
• ツール不在時のサイレントフォールバック：スキルが実行中のプラットフォームに存在しないツールを参照すると、Claudeはエラーや警告なしに散文にフォールバックします。

実用的な修正方法

著者の修正案：より多くの入力が必要な場合は複数ラウンドの質問を行うようにスキルを更新し、ask_user_input_v0の制限を回避します。ファイル操作については、Code/Desktopでは常にWriteを使用し、Claude.aiではプラットフォームチェックとともにcreate_fileを使用します。references/の相対パスは避け、絶対パスかインラインコンテンツを使用してください。

コミュニティ共有リポジトリ

発見内容はGitHubリポジトリに収集されています：github.com/livlign/claude-skills-pitfalls。貢献歓迎。

注意すべき人

Claude Skillsを構築または保守しているすべての人、特にユーザー入力フローやクロスプラットフォームの動作に依存している人。