Content
71%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, well-structured skill whose quick-start, critical rules, and error tables are copy-paste ready. Its weaknesses are padding from marketing claims and version banners, and a bundle/manifest mismatch where seven referenced template files are missing and one script is orphaned.
Suggestions
Create the missing templates/ files referenced in 'Common Patterns Summary', 'Configuration Summary', and 'Bundled Resources' (basic-schema.ts, basic-queries.ts, transactions.ts, relations-queries.ts, prepared-statements.ts, drizzle.config.ts, package.json) — or remove/fix those links so no referenced path 404s.
Trim the marketing footer ('Token Savings: ~65%', 'Error Prevention: 100%', 'Ready for production! ✅') and move the 'Secure Installation' section into a reference file or the linked skill to cut non-actionable tokens from the main body.
Consolidate time-sensitive details (pinned versions drizzle-orm@0.45.2 / drizzle-kit@0.31.10, 'Last Updated: 2025-12-14', the drizzle-kit 0.30/0.31 validation note) into a dedicated versioning/deprecated section or reference file so the main body stays stable, and reference scripts/check-versions.sh from the body so it is discoverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Core tables and code are dense and useful, but the marketing footer ('Token Savings: ~65%', 'Error Prevention: 100%', 'Ready for production! ✅'), the off-topic 'Secure Installation' section, and prominent time-sensitive version/date banners ('drizzle-orm@0.45.2', 'Last Updated: 2025-12-14') outside any deprecated/old-patterns section add unnecessary tokens. | 3 / 5 |
Actionability | Fully executable throughout: complete drizzle.config.ts, runnable schema definitions, copy-paste wrangler/npm commands, a working Worker fetch handler, and a concrete error→solution table covering the most common failure cases. | 5 / 5 |
Workflow Clarity | The 5-step Migration Workflow is clearly sequenced with an explicit validation checkpoint ('Test local ... Verify locally', '--local before --remote'), so the missing-validation cap does not apply; however, no explicit fix-and-retry feedback loop is described for failed migrations, leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | The 'When to Load References' table clearly signals one-level-deep references that all exist, but the body points to seven templates/* files (e.g., templates/basic-queries.ts, templates/drizzle.config.ts, templates/package.json) that do not exist in the bundle, and scripts/check-versions.sh is never referenced — navigation is materially impaired by the broken and orphaned paths. | 3 / 5 |
Total | 15 / 20 Passed |