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 body is highly actionable and pairs strong command coverage with an excellent QA verification loop, but it suffers from two missing referenced files (editing.md, pptxgenjs.md) that break navigation for the editing and create-from-scratch paths, plus some over-explained design prose that could be trimmed.
Suggestions
Add the missing editing.md and pptxgenjs.md files to the bundle (or remove the dead links and inline the essential steps), so the editing and create-from-scratch workflows are actually navigable.
Trim the conceptual prose in Design Ideas (e.g., "Don't create boring slides…", "Dominance over equality") and lead with the concrete palette/font/size tables, which are the genuinely useful reference data.
Expand the compressed editing workflow ("Unpack → manipulate slides → edit content → clean → pack") into explicit numbered steps with the underlying script commands, matching the clarity of the QA verification loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The operational sections (Quick Reference, Reading, QA, Converting, Dependencies) are lean and command-driven, but the Design Ideas section opens with preachy conceptual advice ("Don't create boring slides. Plain bullets on a white background won't impress anyone", "Dominance over equality") that over-explains design ideas Claude largely already knows; the concrete palette/font/size tables, however, earn their place. | 4 / 5 |
Actionability | Provides copy-paste-ready commands for the common cases (markitdown extraction, thumbnail.py, office/unpack.py, soffice PDF conversion, pdftoppm rendering), a ready-to-use subagent visual-QA prompt, and a grep pattern for leftover placeholders — fully executable guidance. | 5 / 5 |
Workflow Clarity | The QA section is exemplary: an explicit verification loop (generate → convert → inspect → list issues → fix → re-verify → repeat) with a "do not declare success until one fix-and-verify cycle" checkpoint, but the editing workflow sequence ("Unpack → manipulate slides → edit content → clean → pack") is compressed and high-level. | 4 / 5 |
Progressive Disclosure | Navigation is signaled well (one-level-deep bold callouts to editing.md and pptxgenjs.md from the Quick Reference table), but those two referenced files do not exist anywhere in the bundle, so the two main editing/creation workflows lead to dead links — navigation is effectively broken for those paths. | 3 / 5 |
Total | 16 / 20 Passed |