Content
92%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-structured specialist skill: executable examples for both PostgreSQL and MySQL, a validated workflow with baseline-capture and revert safeguards, and clean one-level progressive disclosure to five topical reference files. The only weakness is minor redundancy between the frontmatter description and the body's role/when-to-use sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean — SQL snippets, a symptom/remedy table, and checklists — but the 'Senior database optimizer with expertise...' role preamble and the 'When to Use This Skill' bullet list substantially duplicate the description's content, tokens that could be trimmed. Not 3: there is no re-teaching of concepts Claude already knows and no padded explanation. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready SQL covering the common cases: pg_stat_statements top-query listing, EXPLAIN (ANALYZE, BUFFERS) plan capture, CREATE INDEX CONCURRENTLY ... INCLUDE covering index, pg_stat_user_indexes usage verification, and MySQL performance_schema digests. The <query>/<table> placeholders in the validate-improvement template are appropriate parameterization, not pseudocode. | 5 / 5 |
Workflow Clarity | The 5-step Core Workflow has explicit validation checkpoints ('run EXPLAIN ANALYZE before any changes', 'validate each change before proceeding', step 5 re-run and compare) plus a feedback loop — 'Revert immediately if write performance degrades or replication lag increases'. This satisfies the database-operations feedback-loop requirement that would otherwise cap the score at 3. | 5 / 5 |
Progressive Disclosure | A Reference Guide table maps five topics to five real files in references/ (all verified present), each with a 'Load When' condition; the references are one level deep with no nested pointers, and the SKILL.md overview stays appropriately high-level while keeping the most common operations inline. | 5 / 5 |
Total | 19 / 20 Passed |