Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable body with clear, validated multi-step workflows and concrete copy-paste commands. Its weaknesses are verbosity from large inline reference catalogs and progressive-disclosure gaps: two referenced files are missing from the bundle and reference material is inlined rather than separated.
Suggestions
Move the 18-entry color palette catalog and the visual-detail/border/typography option lists into a separate referenced file (e.g. design-reference.md) and summarize the key rules inline.
Provide the missing html2pptx.md and ooxml.md files the workflows MANDATE reading, or remove the mandatory-read instructions, since the referenced paths do not exist in the bundle.
Extract the full inventory.py JSON schema into its own reference doc, keeping only a minimal example inline in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and actionable, but the 18-palette color catalog and lengthy visual-detail/border/typography option lists are inline reference material that much of is design guidance Claude could derive or that could live in a referenced file, so it earns 'mostly efficient but could be tightened'. | 2 / 3 |
Actionability | Provides fully executable commands and code throughout — 'python -m markitdown path-to-file.pptx', 'python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52', and concrete inventory/replacement JSON schemas — copy-paste ready, matching the top anchor. | 3 / 3 |
Workflow Clarity | Three numbered multi-step workflows each include explicit validation checkpoints ('Validate immediately after each edit and fix any validation errors before proceeding', 'Repeat until all slides are visually correct') with error-recovery feedback, matching 'Clear sequence with explicit validation steps'. | 3 / 3 |
Progressive Disclosure | References to html2pptx.md and ooxml.md are clearly signaled one-level-deep pointers, but those files are not present in the bundle, and the SKILL.md itself is a ~480-line monolith with large inline reference material (palette catalog, full inventory JSON schema) that should be split out — 'some structure but could be better organized'. | 2 / 3 |
Total | 10 / 12 Passed |