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.
A highly actionable skill with excellent, well-validated workflows covering creation, editing, and templating. Its weaknesses are token bloat from design-catalog and schema content inlined in SKILL.md, and broken navigation: the mandatory html2pptx.md and ooxml.md references do not exist in the bundle.
Suggestions
Move the 18-entry color-palette catalog, visual-detail treatments, and the inventory JSON schema into a separate reference file (e.g., design.md) and link to it from SKILL.md to cut inline token cost.
Fix the broken bundle references: either include html2pptx.md, ooxml.md, and the ooxml/scripts/ (unpack.py, validate.py, pack.py) files in the bundle, or rewrite those workflow steps to be self-contained.
Trim redundant emphasis by consolidating the many repeated CRITICAL/MANDATORY/IMPORTANT markers — each workflow needs at most one or two flagged points.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body inlines ~90 lines of visual-detail treatments, an 18-entry color-palette catalog, and a ~60-line inventory JSON schema that belong in reference files, and repeats CRITICAL/MANDATORY emphasis heavily — mostly useful operational content but clearly tighten-able. Not 2, since nothing explains concepts Claude already knows. | 3 / 5 |
Actionability | Commands are concrete and copy-paste ready throughout (markitdown, rearrange.py, replace.py, thumbnail.py, pdftoppm, plus worked JSON examples and sample validation errors), but the html2pptx conversion step has no inline code example and its mandated reference (html2pptx.md) is absent from the bundle, leaving minor gaps. | 4 / 5 |
Workflow Clarity | Three workflows are explicitly numbered with validation checkpoints and feedback loops: 'Validate immediately after each edit and fix any validation errors before proceeding', the visual thumbnail inspection loop with named failure modes (text cutoff, overlap, contrast) and 'Repeat until all slides are visually correct', and worked validation-error examples. | 5 / 5 |
Progressive Disclosure | References are clearly signaled and scripts/ contents match, but the two mandatory one-level-deep references (html2pptx.md and ooxml.md) and all ooxml/scripts/* paths referenced in the body are missing from the bundle, and large reference-appropriate content (palettes, visual treatments, inventory schema) is inlined in SKILL.md. | 3 / 5 |
Total | 15 / 20 Passed |