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 highly actionable, code-first reference that would let Claude execute real Drizzle work immediately, with only minor padding (persona intro, 'Why Drizzle' section). Its weaknesses are structural: no validation/verification checkpoints in migration and destructive-operation workflows (capping workflow clarity), and a monolithic single-file layout with no reference files for a skill of this size.
Suggestions
Add validation checkpoints to the migration workflow: after `npx drizzle-kit migrate`, verify applied state (e.g., check the migrations journal or run a smoke query) and loop back on failure, mirroring the Troubleshooting entries as an explicit feedback loop.
Split long peripheral sections into one-level-deep reference files (e.g., references/dialects.md for the Neon/Turso/PlanetScale client setups, references/nextjs.md for the Next.js integration) so SKILL.md stays a lean overview with well-signaled pointers.
Trim the persona opener and the 'Why Drizzle' comparison section — Claude already knows what ORMs and edge runtimes are — and replace them with anything genuinely non-obvious, such as gotchas of the relational query API.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by dense, executable code with minimal prose, matching 'Efficient; minor instances of over-explanation that could be trimmed'. The trimmable parts are the persona opener ('You are a production-grade Drizzle ORM expert...') and the 'Why Drizzle' marketing-style comparison ('Zero dependencies... If you know SQL, you know Drizzle') — concepts Claude already knows — but they are a small fraction of the document. Not a 5 because those padded sections do not earn their tokens; not a 3 because there is no systemic over-explanation of basics. | 4 / 5 |
Actionability | Nearly every section is copy-paste-ready, complete code with imports, file paths, and exact commands: full schema definitions, query patterns, transactions, a drizzle.config.ts, the four drizzle-kit commands, and per-dialect client setups. This matches the level-5 anchor: fully executable examples covering the common cases across the skill's stated scope. | 5 / 5 |
Workflow Clarity | Sequences exist (schema → relations → queries → migrations; generate → migrate commands) and the Troubleshooting section gives problem/solution pairs, but no explicit validation or verification checkpoints appear anywhere — no 'verify the migration applied', no error-recovery loop, no confirmation step before destructive operations. Per the rubric, missing validation in database/batch workflows involving destructive operations (drizzle-kit push, deletes) caps workflow clarity at 3; it is above 2 because steps are clearly listed and ordered, unlike the vague 'rough sequence' anchor. | 3 / 5 |
Progressive Disclosure | The skill is a well-organized single file with clear section headers, but at ~355 lines everything is inline with zero external references — per-dialect client setups, Next.js/tRPC integration, performance tuning, and troubleshooting are all content that could live in one-level-deep reference files to keep SKILL.md a lean overview. This matches the level-3 anchor ('Some structure but could be better organized; content that should be separate is inline'). Not a 2, since section headers and navigation within the file are good; not a 4, since no bundle files exist and the length argues for splitting. | 3 / 5 |
Total | 15 / 20 Passed |