Content
80%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, concise reference of executable migration patterns across multiple databases and ORMs, held back by the absence of explicit error-recovery feedback loops and by its monolithic structure with no progressive disclosure into reference files.
Suggestions
Add an explicit validate→fix→retry loop for migration application (e.g., apply on a prod-sized copy, inspect errors, fix the migration, re-run) to lift workflow clarity past the database-operations cap.
Move the per-ORM detailed sections into one-level-deep reference files (e.g., references/prisma.md, references/django.md) and keep SKILL.md as an overview with clearly signaled links, improving progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is action-dense — concrete SQL, bash, and ORM code with minimal prose — and does not explain concepts Claude already knows (no "what is an ORM" filler), so most tokens earn their place. | 3 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands and code for each tool (e.g., `npx prisma migrate deploy`, `CREATE INDEX CONCURRENTLY`, batched `DO $$ … LOOP` blocks), matching the score-3 anchor. | 3 / 3 |
Workflow Clarity | The expand-contract phases and pre-flight safety checklist give a clear sequence with verification, but there is no explicit validate→fix→retry feedback loop; for database operations the rubric caps workflow clarity at 2 when such loops are missing. | 2 / 3 |
Progressive Disclosure | No bundle files exist and the ~430-line SKILL.md is monolithic, with per-ORM sections (e.g., the long Kysely programmatic migrator) that could be split into one-level-deep reference files; it is well-organized but content that should be separate is inline, matching score 2 rather than 3. | 2 / 3 |
Total | 10 / 12 Passed |