Content
86%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.
An exemplary operational skill: concrete commands for every step, explicit restore verification with failure semantics, safety guardrails (throwaway preview, hygiene, deploy-guard gating), and clean structure with no padding beyond minor Workflow/Rules duplication. The only refinements would be an explicit remediation path when the assert fails and consolidating the duplicated Rules bullets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no explanations of concepts Claude already knows — every line carries instructions, commands, or safety constraints. It sits at anchor 4 rather than 5 because the Rules section duplicates several Workflow points (0-rows-is-failure, RPO schedule, hygiene, preview-not-prod), and asides like "(the half almost nobody does — this is the point)" could be trimmed. | 4 / 5 |
Actionability | Every step has copy-paste-ready commands: "npx convex export --path backup-<date>.zip", "npx convex deploy --preview-create restore-drill-<date>", "npx convex import backup-<date>.zip --deployment restore-drill-<date> --replace", and the prod runbook "npx convex import backup.zip --replace --prod". Verification names specific MCP tools (tables, data, runOneoffQuery), preconditions and a fallback path are given, and even a CLI gotcha ("there is no --preview-name on import") is flagged — this matches the fully-executable anchor 5. | 5 / 5 |
Workflow Clarity | The six-step sequence is explicit with a leading GUARD, a precondition check with a stated fallback, and a genuine validation checkpoint (ASSERT recovery: row counts + real-record sample, with a 0-rows restore defined as FAILED). It falls short of anchor 5 only because there is no error-recovery feedback loop — the workflow says to surface a failed drill loudly but not what to diagnose or retry when the assert fails. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references (none exist in the bundle), and is cleanly organized into an intro, a numbered Workflow, and Rules — squarely matching the guideline that short single-purpose skills with well-organized sections and no needed external files score 5 on progressive disclosure. | 5 / 5 |
Total | 18 / 20 Passed |