Content
75%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 strong, highly actionable body with an excellent QA feedback loop, undermined by broken progressive disclosure: editing.md and pptxgenjs.md are referenced as the authoritative guides but do not exist in the bundle. The "Visual QA" section is also an empty header with no content between it and "Verification Loop."
Suggestions
Add the missing editing.md and pptxgenjs.md to the bundle (or inline their essential content) — both are linked from the Quick Reference table as the primary guides for editing and creating from scratch.
Fill in or remove the empty '### Visual QA' section, which currently has a header with no content before '### Verification Loop'.
Expand the compressed editing workflow ('Unpack → manipulate slides → edit content → clean → pack') into sequenced steps with an explicit validation checkpoint after packing, mirroring the QA verification loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never re-teaches known concepts; the long Design Ideas section is opinionated, specific guidance (palettes, font pairings, size tables) that Claude cannot be assumed to produce on its own. Only minor padding exists, e.g. "**Don't create boring slides.** Plain bullets on a white background won't impress anyone." | 4 / 5 |
Actionability | Commands are copy-paste ready throughout: `python -m markitdown presentation.pptx`, `python scripts/office/unpack.py presentation.pptx unpacked/`, the placeholder-grep one-liner, `pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed`, and exact dependency installs. Common cases are covered with executable examples. | 5 / 5 |
Workflow Clarity | The QA verification loop is explicit and strong ("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"). Not a 5: the core editing workflow is compressed arrow notation ("Unpack → manipulate slides → edit content → clean → pack") with no validation checkpoint between packing and QA. | 4 / 5 |
Progressive Disclosure | The Quick Reference table and per-section "Read [editing.md] / [pptxgenjs.md] for full details" links are well-signaled and one level deep — but neither file exists in the bundle (only scripts/ is present). Both primary detail paths are dead ends and the deferred content is absent, so navigation effectively fails. Not a 3: this is not merely imperfect organization, the referenced files are missing entirely. | 2 / 5 |
Total | 15 / 20 Passed |