T
高品質スキル生成・編集の品質基準
by titabash
スキル品質の統一化:SKILL.md生成時のdescription最適化、Progressive Disclosure(段階的情報開示)、マルチフェーズ設計、allowed-tools最小権限設定など、一貫した品質基準を自動適用します。 500行以内のコンパクト設計:SKILL.mdファイルサイズを制限し、手順書と知識(Context)を適切に分離して管理性を向上させます。 WHAT+WHENフォーミュラの遵守:スキルの説明を「何をするか」「いつ使うか」の構造に統一し、ユーザーがスキルの活用シーンを明確に理解できます。 日英バイリンガルトリガーキーワード対応:日本語ユーザー、英語ユーザーの両者が一貫した形でスキルを起動できるようにします。 段階的情報開示による効率化:Level 1(name+description)→Level 2(SKILL.md)→Level 3(references/)と、必要な情報を段階的に提供し、トークン効率を向上させます。 スキル開発者:再利用可能で保守性の高いスキルを一貫した基準で作成・編集したい Claude Code運用チーム:複数エンジニアが生成するスキルの品質をばらつきなく維持したい ドキュメント管理者:SKILL.mdの構成ルール・ガイドラインを統一管理したい Claudeスキル生成・編集時の品質基準スキル。必須チェックリスト:SKILL.md 500行以内、descriptionが WHAT+WHEN フォーミュラに従っている、description 1024文字以内、日英バイリンガルトリガーキーワード有、name kebab-case 最大64文字、知識を references/ に分離、references/ 読み込み指示が明示的、副作用スキルに disable-model-invocation: true、allowed-tools が最小権限。Description設計は「[WHAT:何をするか]。[WHEN:いつ使うか]。Use when [English triggers].」フォーマット。Progressive Disclosure 3段階:Level 1(name+description、セッション開始時)、Level 2(SKILL.md本文500行以内、スキル起動時)、Level 3(references/、実行中に明示的 Read)。実行フローは Phase 1(要件分析)→Phase 2(リファレンス読み込み)→Phase 3(設計)→Phase 4(ユーザー確認)→Phase 5(生成/実行)の標準パターンに従う。
テストドキュメント設計