Content
100%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.
An exemplary skill body: a concise workflow with an explicit verify-and-iterate checkpoint, copy-paste-ready executable examples with concrete EXPLAIN-output interpretation rules, hard MUST DO/MUST NOT DO constraints, and a well-signaled one-level-deep reference table whose files all exist. Nothing scored below the top anchor on any dimension.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero padding: no explanation of what SQL, CTEs, or execution plans are — inline code comments carry the rationale instead ('filter early, before the join', 'no self-join required', 'always use ANALYZE to see actual row counts vs. estimates'). Every section (workflow, reference table, examples, constraints, output templates) earns its place. | 5 / 5 |
Actionability | Four complete, executable SQL blocks (CTE with ROW_NUMBER, running-total/rank window functions, 'EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)', and a before/after correlated-subquery fix with a covering-index CREATE INDEX statement), plus concrete interpretation rules ('Seq Scan on large table → add or fix an index', 'high read count signals missing cache / index') and actionable MUST DO / MUST NOT DO and output-template lists. | 5 / 5 |
Workflow Clarity | The five-step workflow (Schema Analysis → Design → Optimize → Verify → Document) has an explicit validation step with a feedback loop: 'Run EXPLAIN ANALYZE and confirm no sequential scans on large tables; if query does not meet sub-100ms target, iterate on index selection or query rewrite before proceeding' — exactly the verify→fix→retry loop the rubric demands for database operations, so no cap applies. | 5 / 5 |
Progressive Disclosure | Reference Guide table maps Topic → Reference → 'Load When' with all five listed files (query-patterns.md, window-functions.md, optimization.md, database-design.md, dialect-differences.md) present in references/ and containing no further nested references (one level deep). Only brief quick-reference examples are inlined; the bulk of detail lives in the bundle. | 5 / 5 |
Total | 20 / 20 Passed |