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-rich reference with strong section structure, but it is a monolithic 354-line file with no progressive disclosure to external references, and its destructive migration workflow lacks validation feedback loops. Tightening the marketing prose and adding validation steps would lift the weakest dimensions.
Suggestions
Add an explicit validation feedback loop to the migration workflow, e.g. after `drizzle-kit generate` review the generated SQL, and after `migrate` confirm applied migrations via Studio or a status check before proceeding.
Split the per-database client setups (Neon/Turso/PlanetScale) and the full performance/indexing guide into separate reference files under references/, keeping SKILL.md a concise overview with clearly signaled one-level-deep links.
Trim the "Why Drizzle" marketing bullets — Drizzle's zero-runtime/edge characteristics are broadly known — to recover token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable code with little prose, but the "Why Drizzle" section and its marketing-style bullets ("If you know SQL, you know Drizzle") are mild over-explanation that could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready, executable TypeScript for table definitions, queries, migrations, client setup, and performance optimization, covering the common cases comprehensively. | 5 / 5 |
Workflow Clarity | The migration workflow is sequenced (config → generate → migrate) but lacks validation checkpoints, and because database migrations/push are destructive/batch operations the rubric cap of 3 applies despite the clear sequence. | 3 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers, but at 354 lines the skill is a monolithic single file with no external references; content such as the per-database client setups and full performance guide is inlined rather than split into reference files. | 3 / 5 |
Total | 15 / 20 Passed |