Claude Code のスキル(SKILL.md)を 10 本量産してわかった、壊れない書き方
この記事で分かること
Claude Codeのスキルファイル（SKILL.md）を10本量産した経験から、壊れにくい書き方のルールが得られる。具体的には、スキルのスコープを狭く保つ方法と、依存関係を明示してメンテナンス性を高める記述ルールが示される。
詳細要約
Claude Codeのスキル定義ファイル（SKILL.md）を壊れにくくするには、指示を「条件」と「行動」に明確に分離し、曖昧な表現を避けることが重要。具体的には、プロンプト内で「もし〜ならば」という条件節を先に書き、その後に実行すべき処理を箇条書きで列挙する。また、エラー時の代替行動を必ず1つ以上明記することで、予期しない入力や環境変化に対応できる。