Content
78%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 a tight, well-structured spec: concrete input enumeration, an exact output contract with a worked schema example, explicit convergence criteria, and genuinely useful anti-patterns. The only notable gaps are the unspecified screenshot-extraction path and the absence of a recovery loop for malformed sources, plus a little design-rationale padding in the intro.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanation of concepts Claude already knows, and the output schema and anti-patterns earn their tokens. Minor trimmable padding: the 'Spec §10 / §21.3.2' pointers and the rationale sentence 'the input shape is intentionally generic so the same atom serves both code-migration and figma-migration' read as design justification rather than instruction — one notch below 'every token earns its place'. | 4 / 5 |
Actionability | A fully concrete I/O contract: exact output path and directory tree, a complete JSON entry schema with example values, and concrete anti-patterns with real syntax ('color: #fff' in JSX, deduping 'bg-blue-500' vs 'bg-blue-600'). Minor gap: screenshot input is listed but never specified, keeping it below fully executable anchor 5. | 4 / 5 |
Workflow Clarity | Clear sequence of Inputs -> Output -> Convergence, and the Convergence section is an explicit validation checkpoint ('completes when code/tokens.json exists'; empty bags emit a warning and downstream handling is specified), which handles the batch-scan case. Missing an explicit fix/retry loop for malformed or unparseable sources keeps it below anchor 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), and the body is under 50 lines with clean, well-labeled sections (Inputs, Output, Convergence, Anti-patterns, Status). Per the rubric's simple-skill note, well-organized sections with no need for external references score 5. | 5 / 5 |
Total | 17 / 20 Passed |