Content
70%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 highly actionable body with excellent, validation-gated workflows for each of the three main task types, held back by broken progressive disclosure (mandated html2pptx.md/ooxml.md references absent from the bundle) and padding from inlined design catalogs and repetitive emphasis markers.
Suggestions
Ship html2pptx.md and ooxml.md (or inline their essential syntax) — both are declared MANDATORY reads but are missing from the bundle, breaking the core navigation.
Move the 18-palette color list and the 'Visual Details Options' catalogs into a reference file (e.g., references/design.md) and keep 2-3 illustrative examples inline.
Reduce redundant emphasis scaffolding — many steps stack CRITICAL/IMPORTANT/MANDATORY/NEVER markers, which dilutes the signal; reserve emphasis for genuinely dangerous steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational and information-dense, but sizable inlined design catalogs (18 example color palettes, extensive 'Visual Details Options' lists) and heavy repeated emphasis scaffolding (**CRITICAL**/**MANDATORY**/**NEVER** on nearly every step) could be tightened or moved out of the main file. The padding is real but localized, so this sits between anchor 4 and anchor 2 rather than at either extreme. | 3 / 5 |
Actionability | Nearly everything is executable: exact shell commands, full JSON schemas for inventory/replacement formats, and sample validation error output. It falls short of anchor 5 because the common creation case depends on a missing reference file and lacks a concrete inline HTML starting point, though it is clearly above anchor 3 since commands and data formats are copy-paste ready. | 4 / 5 |
Workflow Clarity | All three workflows are explicitly numbered with validation checkpoints and feedback loops: editing mandates 'Validate immediately after each edit and fix any validation errors before proceeding', the creation workflow closes with thumbnail inspection and 'Repeat until all slides are visually correct', and the template workflow includes pre-flight checks (count content before selecting layouts, verify indices in range) plus concrete error examples. This matches the anchor-5 pattern of sequence + explicit validation + fix-and-retry loop, with no risky operation lacking a checkpoint. | 5 / 5 |
Progressive Disclosure | Section structure is good and references are clearly signaled (MANDATORY READ directives), but the two central references — html2pptx.md and ooxml.md — do not exist anywhere in the bundle, nor do the ooxml/scripts/*.py files, so the promised one-level-deep navigation is broken; additionally, content that belongs in reference files (color palettes, visual treatment catalogs) is inlined. It is below anchor 4 because the most important referenced files are missing, yet above anchor 2 because the structure is well organized with clearly labeled task-type sections. | 3 / 5 |
Total | 15 / 20 Passed |