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.
A thorough, highly actionable Drizzle reference rich in executable code, held back by a migration workflow that omits validation checkpoints for destructive operations and a monolithic structure that uses no progressive disclosure to separate reference material.
Suggestions
Add explicit validation to the migration workflow: after `generate`, inspect/review the SQL; after `migrate`, verify applied state; and a feedback loop ('if migration fails, fix schema and re-generate') — this is required to lift workflow_clarity above 3.
Move detailed reference material (full query-pattern catalog, per-platform client setup, Next.js integration) into separate files under references/ and link to them from SKILL.md to improve progressive disclosure.
Trim the 'Why Drizzle' advantages section and consolidate Do/Don't bullets to reduce explanatory padding that Claude can infer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and code-driven with clear section headers; the 'Why Drizzle' advantages prose and some Do/Don't commentary edge toward over-explanation that could be trimmed, keeping it just below level 5. | 4 / 5 |
Actionability | Abundant copy-paste-ready TypeScript covering schema, relations, queries, inserts/updates/deletes, transactions, migrations, client setup, performance, and Next.js integration — executable and covering the common cases. | 5 / 5 |
Workflow Clarity | The migration workflow lists commands in order with comments, but lacks explicit validation checkpoints or a validate-fix-retry loop for destructive database operations; the rubric caps such skills at 3. | 3 / 5 |
Progressive Disclosure | Well-organized into clear sections, but the ~350-line body is monolithic with no bundle references, and content that could live in separate files (full query patterns, integration guides) is fully inlined. | 3 / 5 |
Total | 15 / 20 Passed |