Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable code, well-sequenced workflows and validation checkpoints, and clean one-level reference splitting. Its only weakness is length and some safety-rule repetition that could be tightened.
Suggestions
Consolidate the repeated 'never apply migrations to a hosted DB / never run DDL through a direct connection' guidance into one authoritative section and have other sections link back to it rather than restating it.
Consider moving the full legacy-extension comparison table and the first-deploy-provisioning failure playbook into references, keeping SKILL.md focused on the recommended GA path.
Trim explanatory phrasing around guardrails (e.g. 'Wandering off the documented surface is how agents end up…') to reduce token cost without losing the safety signal.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and assumes Claude's competence, but at ~360 lines it restates the 'never run DDL / never apply migrations to a hosted DB' rule across several sections (CRITICAL blocks, Common mistakes, CLI commands, local dev), which is justified by safety but adds verbosity. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready code (schema, Drizzle client, config, query patterns, native driver, transactions) plus exact CLI commands with version pins and concrete install lines. | 3 / 3 |
Workflow Clarity | The schema-change and preview-first provisioning workflows are numbered with explicit validation checkpoints ('Verify the deploy log shows…', 'Only proceed when…') and dedicated failure playbooks, satisfying the feedback-loop requirement for destructive database operations. | 3 / 3 |
Progressive Disclosure | SKILL.md acts as an overview that offloads deep material to one-level-deep, clearly signaled references (migrations.md, cli-commands.md, local-dev.md, legacy-extension.md, migration-from-extension.md), all of which are real bundle files. | 3 / 3 |
Total | 11 / 12 Passed |