Content
76%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 concise, well-structured body that points cleanly to its bundle files and gives concrete editing guidance. Its main gaps are the absence of an explicit validation step in the workflow and a resource-map entry (example.html) that is not actually present.
Suggestions
Add an explicit final workflow step that validates the deck against references/checklist.md (e.g. '6. Verify against references/checklist.md P0 items before emitting') to create a validate -> fix -> retry feedback loop.
Either create example.html with realistic fintech numbers and labels, or remove it from the resource map and the frontmatter od.outputs.secondary list so referenced paths all resolve.
Include a short inline snippet (e.g. the metric-card markup pattern or the navigation JS) so the body is actionable without requiring the full template.html to be read first.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: a one-line intro, a tight resource map, a five-step workflow, and a short output contract, with no padding or explanation of concepts Claude already knows. | 5 / 5 |
Actionability | Concrete, executable guidance is given ('Start from `assets/template.html`', preserve 'Prev / Next buttons', 'ArrowLeft / ArrowRight', 'dot navigation', 'no sandbox-hostile APIs'); not a 5 because the body contains no inline code and relies entirely on the bundled template file for the actual markup. | 4 / 5 |
Workflow Clarity | A clear five-step numbered sequence is present, but no explicit validation or verification checkpoint is wired into the workflow itself; the bundled checklist.md exists but is never referenced as a step, so checkpoints are only implicit. | 3 / 5 |
Progressive Disclosure | Good structure with well-signaled one-level-deep references (assets/template.html and references/checklist.md are real and clearly mapped); not a 5 because the resource map lists example.html, which does not exist on disk, leaving a dead reference. | 4 / 5 |
Total | 16 / 20 Passed |