Content
81%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A strong, mature instruction-only skill: it sequences a complex database-performance workflow with pervasive validation checkpoints, feedback loops, and checklist tables, and defers discovery and benchmark mechanics to well-signaled reference files. Minor weaknesses are the duplicated migration guidance, commands deferred to references, and a body heavier than a strict overview structure would call for.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~190-line body is dense, imperative, and assumes Claude's competence with no concept explanations, but migration timing/budget rules are duplicated between section 5 ("First optimize a migration exceeding the roughly one-to-two-minute budget; flag it for human review") and the Constraints section, so minor trimming is possible. | 4 / 5 |
Actionability | Concrete guidance throughout — "rg on distinctive SQL fragments", "EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)", exact evidence to capture, and a full PR-content checklist — though most copy-paste commands (e.g. the pnpm benchmark invocation) live in the reference files rather than the body, leaving minor gaps. | 4 / 5 |
Workflow Clarity | Eight numbered sections form a coherent sequence with explicit validation at every step ("Prove the baseline exhibits the suspected cost before editing", "Reject or revise the change if either proof fails", "Do not call an interrupted suite a pass", "Do not finish with 'CI pending.'"), feedback loops for error recovery, and checklists via the claims and regression-evidence tables. | 5 / 5 |
Progressive Disclosure | Both references exist, are one level deep, and are clearly signaled at point of need ("Read [Cloud discovery](references/cloud-discovery.md) when starting from a hosted workspace"), but the main file is a full procedure manual with inlined detail (PR-checks loop micro-rules, the partially duplicative Constraints section) rather than a lean overview. | 4 / 5 |
Total | 17 / 20 Passed |