Content
77%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 content is highly actionable with strong, validated multi-step workflows, but it is longer than necessary and its progressive-disclosure structure is undermined by referenced files that are not present in the bundle plus bulky reference content inlined in SKILL.md.
Suggestions
Move the 18-palette color catalog and the "visual details options" menu into a separate reference file (e.g. design-reference.md) and link to it from a short "Design Principles" summary to reduce SKILL.md length.
Verify html2pptx.md, ooxml.md, and the ooxml/scripts/unpack.py, validate.py, pack.py files are actually shipped in the bundle, since the workflows mark them MANDATORY reads but they are not present in the visible package.
Trim repeated emphasis scaffolding (multiple "MANDATORY/CRITICAL/NEVER set range limits" markers) into a single note near each workflow to tighten the token budget without losing the instruction.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and avoids explaining concepts Claude already knows, but the 18-palette color catalog (~70 lines), the extended "visual details options" menu, and the fully inlined inventory JSON schema are bulky content that could be tightened or moved to a reference, fitting the mostly-efficient-but-could-be-tighter anchor. | 3 / 5 |
Actionability | It provides fully executable, copy-paste-ready commands (markitdown, unpack/validate/pack, thumbnail, rearrange, inventory, replace, soffice, pdftoppm) plus concrete JSON examples that cover the common cases, matching the score-5 anchor. | 5 / 5 |
Workflow Clarity | Three numbered workflows are clearly sequenced with explicit validation checkpoints and feedback loops (validate-after-each-edit then fix; generate thumbnails, inspect, adjust, regenerate), matching the score-5 anchor. | 5 / 5 |
Progressive Disclosure | References to html2pptx.md and ooxml.md are clearly signaled as one-level-deep reads, but those files (and the referenced ooxml/scripts/ unpack/validate/pack scripts) are absent from the visible bundle, and substantial reference-grade content (palette catalog, visual-options menu, inventory schema) is inlined rather than split out, fitting the some-structure-but-could-be-better-organized anchor. | 3 / 5 |
Total | 16 / 20 Passed |