Content
72%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 lean, highly actionable hard spec with exemplary reference structure — exact measurements, class names, and gotchas throughout, and an on-demand references table whose files all exist. Its main weaknesses are the absent example.html seed the body tells the reader to copy verbatim (mitigated by html-template.md), and the lack of an explicit build sequence or validation checkpoint in the body itself.
Suggestions
Add an explicit ordered workflow (e.g. 1. copy seed from references/html-template.md, 2. pick a preset from STYLE_PRESETS.md, 3. ask density mode, 4. compose slides from the layout vocabulary, 5. verify no overflow/overlap at 1920×1080 before delivering) with a final validation checkpoint.
Fix the dangling seed reference: either ship example.html (and the LICENSE file the Attribution section promises) in the bundle, or repoint the 'Start from example.html' instruction to references/html-template.md, which does contain the controller and stage CSS.
Trim the duplication between the intro and the Attribution section (the upstream repo link is stated twice) and the repeated 'embed viewport-base.css in full' instruction.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~72-line body is dense, project-specific spec ('factor = min(innerWidth/1920, innerHeight/1080)', exact class names, '~650ms' debounce, '≥40px' swipe threshold, the calc(-1 * clamp(...)) fix) that assumes Claude's competence with no concept explanations. Only minor trimming is available — the upstream repo link appears in both the intro and the Attribution section, and 'embed viewport-base.css in full' is stated twice — which fits anchor 4 rather than 5. | 4 / 5 |
Actionability | Guidance is concrete and executable: exact selectors, scaling formula, keyboard keys, easing bezier, output contract, and a specific CSS gotcha with its fix. The gap is that the primary directive 'Start from example.html in this plugin folder... copy... verbatim' cannot be followed as written because example.html is not in the bundle (the SlidePresentation controller does exist in references/html-template.md, which mitigates it). Fits 'Mostly executable guidance... with minor gaps'; not 5 because the named seed file is missing, not 3 because the inline spec plus html-template.md covers the common cases. | 4 / 5 |
Workflow Clarity | The build order is implicit in the section order (copy seed → pick preset → decide density mode → compose slides → output contract) but never given as an explicit sequence, and the body contains no validation or critic checkpoint — the 'critic pass against this rubric' lives only in the frontmatter example_prompt. Fits 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'; not 4 because no explicit step sequence or verification step is written in the body, not 2 because the sections do define a coherent build order. | 3 / 5 |
Progressive Disclosure | A 'References (read on demand)' table with File/When columns points to four real, verified files in references/ (STYLE_PRESETS.md, viewport-base.css, html-template.md, animation-patterns.md), one level deep, with the essential stage spec inlined in the body. Fits 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'. | 5 / 5 |
Total | 16 / 20 Passed |