Content
77%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 highly actionable with an excellent workflow and validation checklist, and the reference signaling is well organized by content type. Its two real weaknesses are duplication between the Style and Anti-Patterns sections (inflating token cost) and four referenced template files that do not exist in the bundle, which would cause an agent following the instructions to fail when trying to read them.
Suggestions
Add the missing ./templates/*.html files to the bundle (architecture.html, mermaid-flowchart.html, data-table.html, slide-deck.html) or remove those references and inline the essential patterns, since the body instructs the agent to read them in the Structure step and before generating slides.
Deduplicate the Anti-Patterns section against the Style section: forbidden fonts, forbidden accent colors, and forbidden animations are each stated twice; consolidate into one canonical list and cross-reference it.
Fix or remove the dangling reference to websocket-implementation-plan.html (line 36) — it has no path and does not exist in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The guidance is mostly non-obvious and earns its tokens, but there is real duplication: forbidden fonts, accent colors, and animations are stated in both the Style section and again in the Anti-Patterns section; Mermaid zoom controls appear twice (lines 83 and 337); and the rendering-approach table (lines 67-79) is restated across the Diagram Types sections. This matches the mostly-efficient-but-could-be-tightened anchor rather than the minor-trimming anchor at 4. | 3 / 5 |
Actionability | Fully executable throughout: exact hex accent palettes, named font pairings, a complete HTML file skeleton, concrete Mermaid theming directives, and copy-paste bash for surf-cli including OS-specific base64 variants (base64 -i vs base64 -w 0). | 5 / 5 |
Workflow Clarity | A clear four-step sequence (Think, Structure, Style, Deliver) with an explicit pre-delivery validation checklist (squint test, swap test, both themes, no overflow, clean file open) and a regeneration feedback loop in the Slop Test ("If two or more of these are present, the page is slop. Regenerate"). | 5 / 5 |
Progressive Disclosure | References are one level deep and well signaled per content type, and all four ./references/*.md files exist with their cited sections. However, the body directs the agent to read ./templates/architecture.html, ./templates/mermaid-flowchart.html, ./templates/data-table.html, and ./templates/slide-deck.html — none of which exist in the bundle — plus an unpathed websocket-implementation-plan.html at line 36. Broken navigation paths are more than the minor organization gaps of the 4 anchor, so this sits at 3. | 3 / 5 |
Total | 16 / 20 Passed |