Content
88%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.
Highly actionable content with concrete commands, executable examples, and an exemplary validate-then-regenerate workflow including feedback loops and failure-mode guidance. Its only real costs are mild repetition of the core rule across sections and the fully-inline layout, which keeps edge-case material in the main file rather than in references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence with Drizzle, spending its tokens on project-specific policy and non-obvious failure modes (journal desync, rename-as-DROP-COLUMN, numeric-vs-double driver behavior) rather than tutorials. It stops short of 5 because the never-hand-write-migrations rule is restated in three sections and a few sentences editorialize ('This is the single rule that matters most in this skill') rather than just instruct. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready commands ('npx drizzle-kit generate', 'git status --short') with expected outcomes, complete working schema code in the worked example, a concrete type-mapping table, and a runnable node one-liner for diagnosing snapshot drift. The common path requires no invention by the reader. | 5 / 5 |
Workflow Clarity | The 8-step workflow has explicit validation checkpoints ('Read the emitted SQL before committing', verify every entity/relationship/validation rule, expect 'exactly one new .sql file, plus the journal') and a genuine error-recovery feedback loop ('If it contains a DROP you did not intend ... fix the schema and regenerate'), plus a stop-and-diagnose path for desynced history — matching the anchor for clear sequence, explicit validation, and feedback loops for a database operation. | 5 / 5 |
Progressive Disclosure | Sections are well organized and cross-file references are clearly signaled with one-level-deep glob locators ('**/*implement/references/project-layout.md', '**/rules/mcp-servers.md'), with external links gathered in a Resources section. It falls short of 5 because no bundle files exist and all ~230 lines live in SKILL.md — edge-case material like the desync-repair diagnosis and the money-column tradeoff discussion could be split into reference files, per anchor 5's 'content appropriately split'. | 4 / 5 |
Total | 18 / 20 Passed |