Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, source-grounded guidelines skill with executable code examples and clean section organization. Its only gap is the absence of an explicit validation feedback loop for the migration/schema operations it governs.
Suggestions
Add an explicit validate->fix->retry sequence for migrations (e.g. run drizzle-kit generate, review the snapshot/SQL diff, fix schema, regenerate until the diff is clean) to lift workflow_clarity.
Make the migration review checkpoint a numbered checklist mirroring the upstream-grounding decision tree so the verification step is unambiguous.
Consider a short 'Quick start' anchor at the top so the rule sections can be scanned in priority order.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and purposeful throughout: rule statements are tight and the explanatory prose (e.g. the $type runtime-overhead "Why" with concrete call counts) covers non-obvious Drizzle internals Claude does not already know, not generic concepts. | 3 / 3 |
Actionability | Provides fully executable, copy-paste-ready TypeScript examples for bad/good $type patterns, customType, and DateTimeString, plus concrete driver-boundary rules (bun:sqlite, better-sqlite3, D1, libSQL/Turso). | 3 / 3 |
Workflow Clarity | The upstream-grounding section gives a sequenced decision tree with a verify step and the migration rule says to review generated SQL and snapshots together, but there is no explicit validate->fix->retry feedback loop for the schema/migration operations the skill describes. | 2 / 3 |
Progressive Disclosure | No bundle files exist, so this scores against body organization: the content is self-contained and split into well-signaled cohesive sections (rules, driver boundaries, $type deep-dive, intermediate representation) with one-level external grounding pointers to the Drizzle/Turso repos. | 3 / 3 |
Total | 11 / 12 Passed |