Content
57%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.
The content is actionable with solid code examples across schema, migrations, queries, connections, and transactions, but it is a monolithic single file with no progressive disclosure and lacks explicit validation feedback loops for its destructive database operations.
Suggestions
Add explicit validate-fix-retry checkpoints to the migrations and production-deploy workflows (e.g. run `prisma validate` then retry on failure before proceeding).
Split the large problem playbooks into one-level-deep reference files (e.g. references/migrations.md, references/query-optimization.md) and keep only an overview in SKILL.md.
Remove the generic 'When to Use' filler line or replace it with concrete trigger guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete code and checklists, but it is padded in places — notably the generic filler 'When to Use: This skill is applicable to execute the workflow or actions described in the overview' and some redundant diagnosis sections that could be tightened. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready bash commands (npx prisma validate, migrate status), TypeScript client snippets, and schema examples covering the common cases, with only minor gaps. | 4 / 5 |
Workflow Clarity | A rough sequence exists (Step 0 routing, environment detection, apply strategy, per-problem playbooks), but destructive/batch database operations like migrate reset and production deploys lack explicit validate-fix-retry checkpoints, capping workflow clarity at 3 per the database-operations feedback-loop rule. | 3 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so ~350 lines of five full problem playbooks, checklists, and anti-patterns are inlined in one monolithic SKILL.md; section headers give some structure, but content that clearly belongs in separate files is not split out. | 3 / 5 |
Total | 13 / 20 Passed |