Content
70%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 highly actionable with three well-sequenced workflows, explicit validation feedback loops, and concrete executable commands throughout. Its main weaknesses are token bloat from inline design-palette content that belongs in a reference file, a missing inline code example for the html2pptx creation step, and references to files (html2pptx.md, ooxml.md, ooxml/scripts/) that are absent from the bundle.
Suggestions
Move the 18 example color palettes and the "Visual Details Options" lists into a design reference file (e.g., references/design.md), keeping a short pointer in SKILL.md to reduce token consumption on every load.
Fix the broken references: html2pptx.md, ooxml.md, and the ooxml/scripts/ directory (unpack.py, validate.py, pack.py) are marked as MANDATORY reads but are not present in the bundle, so both the creation and editing workflows cannot actually be executed as written.
Add a minimal inline html2pptx.js usage snippet (import, html2pptx() call, pptx.writeFile()) to the creation workflow so the most common task has copy-paste-ready guidance without requiring the external reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Commands and workflows are mostly efficient, but roughly 100 lines of inline content (18 example color palettes and the extensive "Visual Details Options" lists) pad the file, and lines like "A .pptx file is essentially a ZIP archive containing XML files" explain orientation Claude already knows. This is more than the 'minor instances' of level 4 but far from the heavy padding of level 2. | 3 / 5 |
Actionability | Provides fully executable commands (unpack/pack, rearrange.py with concrete index lists, thumbnail.py with all flags) and complete JSON schema examples with error-message samples. Not a 5 because the primary creation workflow's step 3 ("Create and run a JavaScript file using the html2pptx.js library") has no inline code snippet, leaving the most common task without copy-paste-ready guidance. | 4 / 5 |
Workflow Clarity | All three workflows are clearly sequenced with explicit validation checkpoints and feedback loops: the editing workflow mandates "Validate immediately after each edit and fix any validation errors before proceeding", and the creation workflow includes a visual validation loop with a concrete issue checklist (text cutoff, overlap, positioning, contrast) repeated "until all slides are visually correct". This matches the top anchor including error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body correctly delegates detail to separate files with clearly signaled MANDATORY reads, but scored against the actual bundle: the referenced html2pptx.md, ooxml.md, and ooxml/scripts/ (unpack.py, validate.py, pack.py) do not exist in the bundle (only the five scripts/ files are present, all of which are real and referenced). Combined with ~100 lines of palette/design content inlined in SKILL.md, this fits anchor 3; not 4 because broken references and inlined bulk exceed 'minor organization gaps', not 2 because the overall structure and reference signaling are good. | 3 / 5 |
Total | 15 / 20 Passed |