Content
96%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.
An exceptionally dense, expert-oriented skill that maximizes token value with environment-specific footguns, executable commands, and a validation-driven workflow. The only structural gap is the absence of a separate reference doc for the sizable design-guidance section.
Suggestions
Consider extracting the Design Ideas section (palettes, typography, spacing, avoid-list) into a referenced DESIGN.md so the main body stays a lean overview.
The color-palette table is large static reference data that could live in the bundle as a data file loaded on demand rather than always occupying the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and expert-oriented throughout — no filler explaining what a PPTX is or how libraries work; nearly every line is a footgun, exact value, or environment-specific constraint Claude would not know ('pptxgenjs mutates option objects in place', 'outEnd corrupts the file'). Long design/palette/typography sections are actionable reference data, not over-explanation. | 5 / 5 |
Actionability | Fully executable guidance: copy-paste bash blocks for unpack/edit/zip/validate, exact script invocations with flags, and concrete API values (color: "FF0000", transparency: 0-100, charSpacing) covering the common creation and editing cases. | 5 / 5 |
Workflow Clarity | Sequenced editing workflow with explicit, emphasized validation checkpoints ('run after <p:sldIdLst> is final', 'After writeFile(), run validate.py') and a mandatory QA section with a render-inspect-fix feedback loop for the destructive repack/delete operations — validation is present, so no cap applies. | 5 / 5 |
Progressive Disclosure | Good single-file structure with a clear scripts table referencing real bundle files (thumbnail.py, add_slide.py, clean.py, office/validate.py, office/soffice.py — all verified present) one level deep and well-signaled; falls short of 5 because the large Design Ideas section is inline with no separate one-level-deep reference document. | 4 / 5 |
Total | 19 / 20 Passed |