Content
86%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 well-crafted skill body: an actionable four-step diagnostic workflow with executable SQL for three engines, a complete output template including validation, and appropriate offloading of lookup tables to a single real, clearly-signaled reference file. The only improvements are trimming minor explanatory asides and version mentions, and adding an explicit error-recovery step when validation fails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — short sequenced steps, details delegated to references/plan-signatures.md, no basic-concept tutorials — with only minor trimmable asides ("order matters; leading column is the most selective") and version-number mentions ("PostgreSQL 11+", "MySQL 8.0+", "postgresql 17" in the output template) that the guidelines treat as time-sensitive. It is noticeably above the 3 anchor's unnecessary-explanation level but not the 5 anchor's every-token-earns-its-place level. | 4 / 5 |
Actionability | Fully executable throughout: a complete `EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON, SETTINGS)` example query for PostgreSQL, templates for MySQL and SQLite, five copy-paste-ready CREATE INDEX recipes (single, composite, partial, functional, covering), and a complete worked output example with diagnosis, fix, and expected impact. The only ellipses are placeholders for the user's own query, which is inherently variable — this matches the 5 anchor. | 5 / 5 |
Workflow Clarity | A clear four-step sequence (capture ANALYZE plan -> identify dominant cost -> match cost to fix -> emit index/rewrite) with an explicit validation checkpoint in the output template ("After applying: EXPLAIN (ANALYZE, BUFFERS) ... Confirm the new plan uses idx_orders_customer_created and the actual time is below the budget"). It falls short of the 5 anchor because there is no explicit error-recovery branch (what to do if the plan does not change or time stays over budget), and validation lives in the output template rather than the step sequence itself. | 4 / 5 |
Progressive Disclosure | Clean split: the workflow, examples, and output template stay inline while the four lookup tables (cost signatures, diagnosis-to-fix, index-choice principles, anti-patterns) are delegated to references/plan-signatures.md, which exists and contains exactly the claimed sections. Each reference is clearly signaled by section name and is one level deep, matching the 5 anchor's well-signaled one-level-deep structure. | 5 / 5 |
Total | 18 / 20 Passed |