Content
88%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 body is an exceptionally actionable operational ruleset: every change type has an exact verification command, validation is woven through as both the goal and the checkpoint, and unverifiable situations have an explicit fallback script. Its only weaknesses are mild token redundancy (the quoted user-failure anecdotes and repeated framing) and a dense single-file structure that could offload some per-area detail to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with repo-specific, non-obvious knowledge (per-template `action` scripts, the local-dev sign-in endpoint, `test:fast` exclusion suffixes) and avoids explaining concepts Claude already knows. Minor over-explanation remains: the "Real failures this replaces" quote block and some "Do NOT report done" framing restate rules already stated elsewhere, keeping it below anchor 5's every-token-earns-its-place bar. | 4 / 5 |
Actionability | Every change area maps to a copy-paste-ready command (`pnpm --filter <app> dev`, `pnpm action <name> --key value`, `pnpm guard:<name>`, `node --experimental-strip-types --test scripts/ci-change-scope.test.ts`, `pnpm qa:deploy-paths --target node`) including edge-case workarounds like signing in via `POST /_agent-native/auth/local-dev`. The per-area table fully covers the common cases with executable commands. | 5 / 5 |
Workflow Clarity | The process is unambiguous and validation is the skill's explicit subject: scale the verification, run the per-area proof, put the proof in the reply, and state the exact gap when verification is impossible. Validation checkpoints and feedback loops are explicit throughout ("A failing check is a reason to keep working"; the guard row requires testing both a case that should pass and one that should still fail; the migration row boots then reads back the new column). | 5 / 5 |
Progressive Disclosure | The single file is well-organized with clear sections, the "Proof by area" table is core content that belongs inline, and there are no buried or nested references. However, at roughly 100 body lines with a very dense table and no reference files to offload per-area detail, it exceeds the under-50-line simple-skill case that would justify anchor 5, landing at anchor 4's good-structure-with-minor-gaps level. | 4 / 5 |
Total | 18 / 20 Passed |