Content
100%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 exemplary instruction skill: lean and project-specific with zero padding, fully executable commands and code patterns, a clearly sequenced five-phase workflow with explicit validation checkpoints and error-recovery loops, and bulk detail appropriately delegated to five clearly signaled, one-level-deep reference files. No dimension shows a meaningful weakness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative, assumes competence (no explanations of zod, drizzle, transactions, or hooks), and every rule is non-obvious project-specific knowledge (e.g., 'Plain `pnpm doctor` runs pnpm's own command and exits 0', the 6,000-character AGENTS.md cutoff). Nothing is padded, matching anchor 5 rather than 4. | 5 / 5 |
Actionability | Fully executable guidance throughout: copy-paste commands ('pnpm exec agent-native dev', 'pnpm action <name> --key value'), concrete code patterns ('export * from "@agent-native/toolkit/ui/dialog";', 'fail(message, { errorCode, statusCode })' with 409/404/403 mapping, 'toast.error(actionErrorMessage(error) ?? "<fallback>")'), and exact file paths. Matches anchor 5's copy-paste-ready coverage of common cases. | 5 / 5 |
Workflow Clarity | Five clearly sequenced phases (Orient, Decide, Build, Verify, Report) with six numbered up-front decisions and an explicit ordered verification sequence including feedback loops ('Fix every finding, then rerun only what failed', guarded write called twice, browser smoke asserting the rejection toast). Destructive database operations are guarded (additive migrations, 'Never edit an applied entry'), so the workflow-clarity cap does not apply; this matches anchor 5. | 5 / 5 |
Progressive Disclosure | The body holds the decisions and core workflow while bulk detail is split across five real, one-level-deep reference files (edit-points-chat/default selected by scaffold template, data-and-access, rooms-example, verification), each clearly signaled by path and verified to exist with no nested references. This matches anchor 5's well-signaled, appropriately split structure. | 5 / 5 |
Total | 20 / 20 Passed |