Content
92%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 short instruction-only guard skill: dense with exact commands, flags, and file paths, structured as a clear identify-then-act workflow with validation gates and an error-recovery loop. The only minor inefficiency is that the Rules section reiterates several workflow steps, which could be consolidated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative (~25 lines) with no explanation of concepts Claude already knows; the only trimmable material is the brief incident-rationale intro ("most incidents start with a command aimed at the wrong one") and the Rules section substantially restating workflow steps 3-6. Not 5 because that Workflow/Rules duplication could be tightened; not 3 because there is no padding or unnecessary conceptual explanation. | 4 / 5 |
Actionability | Fully concrete and executable: exact env vars and files to read (`CONVEX_DEPLOYMENT` in .env.local, `convex.json`), exact commands (`npx convex run --prod`, `npx convex env list`), exact MCP flags (`--deployment dev`, `--cautiously-allow-production-pii`, `--dangerously-enable-production-deployments`, `--disable-tools run,envSet,envRemove`), a concrete classification taxonomy, and a copy-paste announcement format (`target: dev (joyful-capybara-123, personal dev)`). Not 4 because the enumerated commands and flags cover the common deployment-affecting cases with no significant gaps. | 5 / 5 |
Workflow Clarity | Clear numbered sequence (IDENTIFY → ANNOUNCE → consent → MCP defaults → read-only → diagnosis → ambiguity) with explicit validation checkpoints ("If two sources disagree, resolve before proceeding"; "Ambiguity = stop... never guess") and a genuine error-recovery feedback loop (a deploy that "didn't change anything" means re-run step 1, not re-deploy). Not 4 because both the checkpoints and the recovery loop are present for this destructive-operation context, satisfying the feedback-loop requirement. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references (no references/, scripts/, or assets/ files exist in the bundle), and is well organized into a Workflow section and a Rules section with no dangling references. Per the rubric's guideline for short self-contained skills, well-organized sections alone earn the top score; not 4 because there is no content that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |