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 body is a thorough, well-sequenced guide with strong validation feedback loops and concrete commands, scoring high on workflow clarity and actionability. Its weaknesses are token-heavy inline design material that belongs in reference files and references to .md/ooxml files that are not present in the bundle.
Suggestions
Move the 18 color palettes and the Visual Details / Typography / Chart / Layout / Background option lists into a dedicated reference file (e.g., references/design-options.md) and link to it from SKILL.md.
Add the missing referenced files (html2pptx.md, ooxml.md, ooxml/scripts/unpack.py, validate.py, pack.py) to the bundle, or correct the paths to point at files that actually ship with the skill.
Include an executable html2pptx() code snippet and a minimal full HTML slide example so the create-without-template workflow is fully copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The workflow sections are efficient and assume competence, but the design section inlines heavy content Claude largely already knows (18 full color palettes, plus six bulleted categories of visual/typography/chart/layout/background options) that could be tightened or moved to a reference, matching the 'mostly efficient but includes unnecessary material' anchor. | 3 / 5 |
Actionability | It provides copy-paste-ready commands with arguments across all workflows (markitdown, unpack/validate/pack, rearrange.py, inventory.py, replace.py, thumbnail.py, soffice, pdftoppm) plus concrete JSON schemas, but the html2pptx step only describes the html2pptx() call without an executable code snippet and shows no full HTML slide example, leaving a minor gap. | 4 / 5 |
Workflow Clarity | Each path (create-without-template, edit-existing, create-from-template) is a clearly numbered sequence with explicit validation checkpoints — 'Validate immediately after each edit and fix any validation errors before proceeding', replace.py shape validation, and the thumbnail 'Repeat until all slides are visually correct' feedback loop — matching the anchor with explicit validation, error-recovery loops, and checklists. | 5 / 5 |
Progressive Disclosure | Structure and reference signaling are good in intent (mandatory reads of html2pptx.md and ooxml.md for deep detail), but those referenced .md files and the ooxml/scripts/* paths do not exist in the actual bundle (only scripts/ with 5 files is present), so navigation is broken, and large design reference material (palettes, visual options) is inlined rather than split out. | 3 / 5 |
Total | 15 / 20 Passed |