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 strong, lean code cookbook with excellent token efficiency and near-copy-paste actionability, undermined by missing migration validation steps and a progressive-disclosure section that points to reference files that are absent from the bundle.
Suggestions
Create references/migrations.md and references/performance.md (or remove the 'When to Load References' section) — the body currently points to files that don't exist.
Add a validation checkpoint around migrations (e.g., inspect generated SQL in ./drizzle before applying, and verify the schema with drizzle-kit studio or a smoke query after migrating).
Fix the small executability defects: import sql in the schema example, replace the '{ ... }' placeholder in the rollback example, and align select/update examples with columns actually defined in the users schema.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely lean, executable code under terse section headers ('Quick Start', 'Schema Definition', 'CRUD Operations') with zero padding — no explanation of what an ORM or SQLite is, no library pros/cons. Every section adds Drizzle/Bun-specific knowledge Claude would otherwise have to recall or guess, so it matches the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Mostly copy-paste-ready, executable code covering the common cases (install commands, schema, config, generate/migrate/push, full CRUD, transactions, prepared statements, raw SQL). It falls short of fully executable because of small defects: the schema example uses 'sql' (in '.default(sql`(unixepoch())`)') without importing it, the rollback example contains a literal '{ ... }' placeholder, and select examples reference 'users.status'/'users.age'/'users.updatedAt' columns that are not in the defined schema. | 4 / 5 |
Workflow Clarity | The implied sequence is coherent and well ordered (install → schema → db setup → config → migrate → CRUD), and the 'Common Errors' table plus the '(dev only)' caveat on 'drizzle-kit push' show some care. However, this is a database skill where migrations can be destructive or batch-applied, and there is no explicit validation checkpoint (e.g., verify migration output or inspect the generated SQL before applying) — the guidelines cap workflow clarity at 3 for exactly this gap. | 3 / 5 |
Progressive Disclosure | Structure is good: clear section headers and a dedicated 'When to Load References' section that states exactly when to open 'references/migrations.md' and 'references/performance.md'. But those files do not exist (no references/ directory in the bundle), so the pointers are dangling, and ~350 lines of inline cookbook/reference material (full CRUD matrix, Column Types Reference) is the kind of content the rubric expects split into those separate files — fitting the 'some structure, content that should be separate is inline' anchor rather than a 4. | 3 / 5 |
Total | 15 / 20 Passed |