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.
A lean, well-sequenced migration runbook with concrete directory structures, naming conventions, and technology mappings. Its main gaps are the absence of executable validation commands and an explicit error-recovery loop between phases.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~25-line body is entirely instructional with zero padding — phrases like "Map the module (files, patterns, dependencies, Pages Router usage)" and "getServerSideProps -> async Server Component" convey dense specifics telegraphically without explaining any concept Claude already knows. It assumes competence throughout; every token earns its place. | 5 / 5 |
Actionability | Guidance is mostly executable: exact directory layouts ("Create `src/modules/[name]/` (components/, hooks/, services/, adapters/, stores/, actions/, types/, __tests__/)"), exact file conventions ("Create `.types.ts` + `.contracts.ts` + adapter"), and specific tech mappings (React Query, Zustand, Server Actions). Minor gaps: no copy-paste validation commands ("Validate build/tsc/tests" names the checks but not the commands), and "Use `@migrator`" presumes the agent is already known. Not a 5 because nothing is copy-paste ready; not a 3 because the guidance is concrete and specific, not pseudocode or high-level hints. | 4 / 5 |
Workflow Clarity | Seven phases are clearly numbered and sequenced, with an explicit repeated checkpoint ("Validate build/tsc/tests after each phase. Ask for approval before each phase.") — so the destructive/batch cap at 3 does not apply since validation is present. It falls short of the 5 anchor because there is no explicit error-recovery feedback loop (what to do when build/tsc/tests fail) and no checklist for the complex 7-phase process. | 4 / 5 |
Progressive Disclosure | Per the rubric's simple-skill guidance, an under-50-line skill with no need for external references can score 5 with well-organized sections. The body is ~25 lines, cleanly sectioned, and its one external pointer (`docs/ARCHITECTURE.md`) is a clearly signaled, one-level-deep project reference rather than a nested skill reference. | 5 / 5 |
Total | 18 / 20 Passed |