Content
71%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 well-organized, highly actionable body with excellent QA/validation loops and concrete design guidance. Its main defect is structural: the two central workflow guides (editing.md, pptxgenjs.md) are referenced but missing from the bundle, leaving the edit and create-from-scratch paths without their promised detail.
Suggestions
Add the missing editing.md and pptxgenjs.md files (or a references/ directory containing them) so the two core task routes in the Quick Reference table resolve to real content.
Expand the compressed editing workflow step ('Unpack → manipulate slides → edit content → clean → pack') with the concrete per-step commands (e.g., scripts/office/unpack.py, add_slide.py, clean.py, scripts/office/pack.py) so the workflow is executable even before following the external guide.
Trim motivational framing ('Don't create boring slides. Plain bullets on a white background won't impress anyone') to pure instructions to tighten the body's token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and nearly every line is actionable (hex color palettes, pt-size tables, exact commands, a copy-paste subagent QA prompt), with only minor rhetorical padding such as 'Don't create boring slides. Plain bullets on a white background won't impress anyone' and similar editorial framing in the Avoid section. It fits the 4 anchor ('efficient; minor instances that could be trimmed') — not 5 because a few lines are motivational rather than instructional, and not 3 because no section explains concepts Claude already knows. | 4 / 5 |
Actionability | Inline commands are copy-paste ready and complete for reading and QA ('python -m markitdown presentation.pptx', 'python scripts/thumbnail.py', the soffice/pdftoppm conversion chain, the placeholder grep). However, the two core creation paths defer entirely to 'Read [editing.md](editing.md)' and 'Read [pptxgenjs.md](pptxgenjs.md)' — neither file exists in the bundle — so edit/create tasks lack accessible executable detail. This places it at 4 ('mostly executable with minor gaps') rather than 5, but above 3 since the inline guidance that is present is fully executable rather than pseudocode. | 4 / 5 |
Workflow Clarity | The QA workflow is exemplary with an explicit validation loop and feedback structure ('List issues found... Fix issues... Re-verify affected slides — one fix often creates another problem... Do not declare success until you've completed at least one fix-and-verify cycle'), plus content validation via markitdown and the placeholder grep. The editing workflow itself is compressed into a single line ('Unpack → manipulate slides → edit content → clean → pack') without per-step commands, leaving minor sequence gaps, so it matches 4 ('clear sequence with most checkpoints; minor validation gaps') rather than 5. | 4 / 5 |
Progressive Disclosure | The body is well-structured with a Quick Reference table routing each task to its guide, and references are clearly signaled — but the bundle listing shows 'editing.md' and 'pptxgenjs.md' do not exist anywhere (no references/ or assets/ directories), so two of the three primary task guides are dead links. Broken core references undermine navigation more than the 4 anchor's 'minor organization gaps', while the good in-body structure keeps it above the 2 anchor's 'buried references' — matching 3 ('could be better organized'). | 3 / 5 |
Total | 15 / 20 Passed |