Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill body is well-structured: concise, actionable with executable SQL, a clearly sequenced workflow including a validate-after-applying feedback loop, and clean progressive disclosure to a single verified reference file. It does not pad with concepts Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: the Overview crisply enumerates the five failure modes, steps are terse, and it avoids explaining concepts Claude already knows (no primer on what an index or a database is), with every section earning its place. | 3 / 3 |
Actionability | Provides fully executable vendor-specific EXPLAIN commands, copy-paste CREATE INDEX examples (single, composite, partial, functional, covering), and a complete worked output-format template — concrete and copy-paste ready rather than pseudocode. | 3 / 3 |
Workflow Clarity | A clear four-step sequence (get EXPLAIN ANALYZE → identify dominant cost → match to fix → emit candidate) with an explicit validation checkpoint in the output format that re-runs EXPLAIN ANALYZE and confirms the new plan meets budget. | 3 / 3 |
Progressive Disclosure | The body is an overview that points to one real, one-level-deep reference file (references/plan-signatures.md, verified to exist), signaled inline at each relevant step for cost signatures, diagnosis-to-fix, index choice, and anti-patterns. | 3 / 3 |
Total | 12 / 12 Passed |