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 with copy-paste commands and a strong QA verification loop, and it avoids conceptual padding. Its main weaknesses are in progressive disclosure: the two detailed guides it routes users to (editing.md, pptxgenjs.md) are missing from the bundle and the office scripts path is broken, and the sizable Design Ideas material is inlined rather than split into a reference file.
Suggestions
Add the missing referenced files editing.md and pptxgenjs.md to the bundle (or remove/replace the links), since the Quick Reference table and section pointers currently route users to documents that do not exist.
Fix scripts/office: it is a 20-byte file containing '../../_shared/office' rather than a real directory, so 'python scripts/office/unpack.py …' cannot run — restore the actual office scripts or correct the path.
Move the large Design Ideas content (color palettes, typography pairings, layout/avoid lists) into a separate design.md reference file and link to it from SKILL.md, keeping the main skill as a lean overview that routes to the detailed guides.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids conceptual padding (it never explains what a PPTX is or how libraries work) and is dense with actionable specifics, matching the 'efficient; minor instances that could be trimmed' anchor; it does not reach 5 because the large inlined Design Ideas section (10 color palettes, 8 font pairings, an extended 'Avoid' list) is heavy token load for the main file. | 4 / 5 |
Actionability | Copy-paste-ready, executable commands cover the common cases — 'python -m markitdown presentation.pptx', 'soffice --headless --convert-to pdf output.pptx', 'pdftoppm -jpeg -r 150 output.pdf slide', the placeholder grep, and pip/npm installs — plus concrete hex codes, pt sizes, and a ready subagent QA prompt, matching the anchor-5 example. | 5 / 5 |
Workflow Clarity | The QA section provides an explicit fix-and-verify feedback loop ('Do not declare success until you've completed at least one fix-and-verify cycle') and a content-QA grep checkpoint, but the core Editing Workflow ('Unpack → manipulate slides → edit content → clean → pack') is terse and defers detail to editing.md, leaving minor validation gaps that fit anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Structure is well-formed — a one-level-deep Quick Reference table with clearly signaled links to editing.md and pptxgenjs.md — but scored against the actual bundle, those referenced files do not exist and scripts/office is a 20-byte broken path file rather than a directory, so the promised navigation is not delivered; this fits the 'some structure… references present but not delivered / content that should be separate is inline' band rather than the 4–5 anchors. | 3 / 5 |
Total | 16 / 20 Passed |