Content
72%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.
The body is a tight, executable SQL cheat-sheet with excellent actionability and conciseness, but it has no multi-step workflow and its two "Additional Resources" links point to files that are not bundled, breaking the progressive-disclosure navigation it advertises.
Suggestions
Either create the referenced ./references/window-functions.md and ./references/indexing-strategies.md files, or remove the "Additional Resources" section to avoid dead links.
If the skill is ever extended to cover destructive or batch SQL (UPDATE/DELETE migrations), add an explicit validate-then-execute workflow with checkpoints so workflow_clarity can rise above 3.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: tight tables for window functions, joins, index types, and anti-patterns with minimal prose and copy-paste SQL, assuming Claude already knows SQL; the only trimming target is the redundant opening line "Quick reference for common SQL patterns." which restates the description, keeping it just below the anchor-5 "every token earns its place" bar. | 4 / 5 |
Actionability | Multiple complete, executable SQL blocks (single CTE, chained CTE, a window-function query using LAG/SUM OVER, and both OFFSET and keyset pagination) are copy-paste ready and cover the common cases, matching the anchor-5 "fully executable; specific examples cover the common cases" example. | 5 / 5 |
Workflow Clarity | This is a reference card with no multi-step process, so there is no sequenced workflow or validation checkpoint to evaluate; it is well organized into sections but, being a multi-topic lookup rather than a single-task skill, it does not meet the simple-skill exception for a 5 and lands at the anchor-3 middle where sequence/checkpoints are absent (appropriately, since the patterns are read-only and non-destructive). | 3 / 5 |
Progressive Disclosure | The body is well sectioned and signals one-level-deep references in "Additional Resources" ("./references/window-functions.md", "./references/indexing-strategies.md"), but those referenced files do not exist in the bundle (no references/ directory), so the signaled navigation is dead — a real navigation failure that pulls it below anchor 4 despite good in-file structure. | 3 / 5 |
Total | 15 / 20 Passed |