Content
82%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 concise, highly actionable database-operations skill with executable commands, a migration safety checklist, and clear rollback/deprecation workflows. Validation checkpoints are present for the destructive operations, satisfying the database-ops feedback-loop expectation; the main gap is a single under-specified failure branch in the deploy confirmation step.
Suggestions
Add an explicit failure branch to the deploy procedure: after 'npx prisma migrate status', state what to do if migrations are not all applied (e.g., fall back to the rollback procedure) to lift workflow_clarity to 5.
Consider moving the detailed Removing Deprecated Tables procedure and Credentials into a separate reference file to reduce SKILL.md length and improve progressive_disclosure.
Trim the one-line rationale sentences (e.g., 'Zero-downtime deploys require that existing rows satisfy the new schema immediately') to push conciseness closer to a 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean checklist content that assumes Claude's competence ('Never use prisma db push outside of development'), with only minor rationale lines like 'Zero-downtime deploys require...' that could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout — 'npx prisma migrate deploy', 'npx prisma migrate status', 'grep -r "oldColumn" src/', 'cat prisma/migrations/*/migration.sql' — plus concrete safe/unsafe Prisma snippets covering common cases. | 5 / 5 |
Workflow Clarity | Numbered deploy, rollback, and deprecation sequences with an explicit 'Confirm status' checkpoint and a rollback feedback loop; not a 5 because the deploy step states the expected status output without an explicit 'if not applied, do X' branch. | 4 / 5 |
Progressive Disclosure | Well-organized into clearly signaled sections (When to Use, Migration Safety Checklist, Removing Deprecated Tables, Credentials) in a single appropriately-scoped file with no nested references; not a 5 because at ~95 lines it sits above the under-50 simple-skill threshold and could not point to external detail files. | 4 / 5 |
Total | 17 / 20 Passed |