Content
46%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 skill body is well organized and its QA/verification loop is genuinely strong, with concrete commands for reading, rendering, and validation-by-eye. However, the two main authoring workflows defer to editing.md and pptxgenjs.md, which are not present in the bundle, and the editing steps themselves lack commands and validation checkpoints despite validate.py shipping unused.
Suggestions
Ship editing.md and pptxgenjs.md (or replace the four references to them with real content or existing files) — the Quick Reference, Editing Workflow, and Creating from Scratch sections all dead-end on these missing guides.
Make the Editing Workflow steps concrete with the bundled scripts (e.g., scripts/office/unpack.py, scripts/office/validate.py, scripts/office/pack.py) and add an explicit validate-before-pack checkpoint.
Move the ~90-line Design Ideas section (palettes, font pairings, layout options) into a separate reference file and keep a short checklist inline in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Command sections (Reading, QA, Converting, Dependencies) are lean, but the ~90-line Design Ideas section ("Plain bullets on a white background won't impress anyone," full font-pairing and 10-palette tables, repeated "Don't…" admonitions) is padded relative to what the skill needs inline. Mostly efficient with a sizable block that could be tightened or externalized — the level-3 anchor; not 4 because the design block is a real, systematic verbosity cost, not a minor instance. | 3 / 5 |
Actionability | Reading/QA/rendering are fully executable ("python -m markitdown presentation.gpptx", "pdftoppm -jpeg -r 150", a ready-to-use subagent prompt), but the two core authoring paths are high-level only: Editing gives "Unpack → manipulate slides → edit content → clean → pack" with no commands, and both paths rest on "Read [editing.md]" / "Read [pptxgenjs.md]" — files that do not exist in the bundle. Some concrete, executable guidance but key details missing or dead-ending — level 3; not 2 because two of the three task families are copy-paste ready. | 3 / 5 |
Workflow Clarity | The QA section has a genuine feedback loop ("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"), but the editing workflow itself is a vague arrow sequence with no per-step validation — the bundled scripts/office/validate.py is never cited. Level 3 per the cap for file-modifying workflows lacking validation checkpoints; not 4 because the primary edit sequence has neither commands nor an inline validate step. | 3 / 5 |
Progressive Disclosure | The Quick Reference table is clear navigation, but the two primary references — editing.md and pptxgenjs.md, cited four times as the source of "full details" — are missing from the bundle, so the disclosure chain dead-ends at the exact point detail is deferred. Additionally, the long Design Ideas block is inline content that belongs in a reference file. This matches level 2 (structure present but the load-bearing references are broken and separable content is inlined); not 3 because the problem is not weak signaling but absent targets. | 2 / 5 |
Total | 11 / 20 Passed |