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 content is a well-structured, actionable overview with strong progressive disclosure via real reference files and a validation-driven repair section. The main improvement is adding a complete copy-paste HTML example and tightening the longer guidance paragraphs.
Suggestions
Include one complete minimal copy-paste HTML example for a 1242x1660 red-note page so the concrete classes and budgets are shown end-to-end.
Tighten the composition and vertical-rhythm paragraphs into shorter bullet-style rules to reduce token overhead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence without explaining basic concepts; a few guidance-heavy paragraphs (composition/vertical-rhythm) could be tightened but each token carries real instruction. | 4 / 5 |
Actionability | Provides concrete, executable guidance — exact font floors (33px/44px/22px), specific classes (`text-[33px]`, `flex flex-col`, `flex-1`), budget px ranges, and markers (`@ppt-chart-height=N`, `data-ppt-density="high"`) — though no complete copy-paste HTML example is included. | 4 / 5 |
Workflow Clarity | Clear sequenced workflow (Preflight → Canvas Grammar → Pattern lookup → Note Budget → Repair/Self-check) with a validation checkpoint ('Before delivery, run references/checklist.md') and a repair feedback loop; minor gaps in explicit retry-after-fix wording. | 4 / 5 |
Progressive Disclosure | The body is a clean overview with two clearly signaled, real one-level-deep references (`references/catalog.md` and `references/checklist.md`), and content is appropriately split between the overview and those bundle files. | 5 / 5 |
Total | 17 / 20 Passed |