Content
77%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, actionable body with strong QA feedback loops and executable commands. The main defects are broken references to missing detail files (editing.md, pptxgenjs.md) and a heavy inlined design section that would benefit from being split into its own reference.
Suggestions
Add the missing editing.md and pptxgenjs.md files (or remove/repoint the references) so the Quick Reference table and workflow sections resolve to real content.
Move the large Design Ideas section (color palettes, typography pairings, layout options) into a separate reference file (e.g. design.md) and keep a brief pointer in SKILL.md to improve token efficiency and progressive disclosure.
Tighten the editing workflow step 2 ('Unpack → manipulate slides → edit content → clean → pack') into explicit sub-steps with the corresponding script commands inline, since the detail file is currently absent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean with no concept-explanation fluff (no 'what is a pptx' padding) and executable commands throughout, though the Design Ideas section is voluminous (10 color palettes, 8 font pairings) and could be trimmed or moved to a reference file. | 4 / 5 |
Actionability | Concrete executable commands throughout ('python -m markitdown', 'python scripts/thumbnail.py', 'python scripts/office/unpack.py', 'pdftoppm -jpeg -r 150', pip/npm installs) and a ready-to-use QA subagent prompt, but the editing/creating-from-scratch detail files (editing.md, pptxgenjs.md) are referenced and missing, leaving a gap in executable guidance for those paths. | 4 / 5 |
Workflow Clarity | Clear sequenced editing workflow plus an excellent QA Verification Loop with explicit feedback checkpoints ('Fix issues → Re-verify affected slides → Repeat until a full pass reveals no new issues') and a guard ('Do not declare success until you've completed at least one fix-and-verify cycle'), matching the anchor for validation with error-recovery loops. | 5 / 5 |
Progressive Disclosure | Good top-level structure (Quick Reference table routing to the three main paths, clearly signaled section references) but two referenced files — editing.md and pptxgenjs.md — do not exist in the bundle, breaking navigation, and the large inlined Design Ideas section is content that could live in a separate file. | 3 / 5 |
Total | 16 / 20 Passed |