Content
77%Reviews 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 and well-sequenced with strong validation feedback loops for fragile OOXML and layout operations. Its main weaknesses are verbosity from an inline design catalog and two clearly-signaled reference files (html2pptx.md, ooxml.md) that are missing from the bundle.
Suggestions
Ship the referenced html2pptx.md and ooxml.md alongside SKILL.md (or inline the essential parts) so the "READ ENTIRE FILE" navigation resolves to real files.
Move the 18-palette color catalog and the visual-details/typography/chart-styling option lists into a separate reference (e.g. design-ideas.md) to reduce SKILL.md's token footprint.
Trim redundant emphasis markers (e.g. repeated MANDATORY/CRITICAL/NEVER bolding) where a single clear directive would carry the same instruction.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core workflows are tight and executable, but large encyclopedic catalogs (18 numbered color palettes with hex codes, dozens of visual-detail and typography-treatment bullets) pad the file with material that could be trimmed or moved to a reference; it is mostly efficient but could be tightened. | 2 / 3 |
Actionability | Provides fully executable commands and copy-paste-ready examples throughout — e.g. `python ooxml/scripts/unpack.py <office_file> <output_dir>`, `python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4`, and a complete replacement-text JSON structure — with concrete API guidance. | 3 / 3 |
Workflow Clarity | Each major task is a clearly numbered sequence with explicit validation checkpoints and feedback loops ("Validate immediately after each edit and fix any validation errors before proceeding", "Repeat until all slides are visually correct") plus example validation errors, matching the anchor for clear sequence with explicit validation. | 3 / 3 |
Progressive Disclosure | The body signals one-level-deep references to html2pptx.md and ooxml.md with clear "READ ENTIRE FILE" callouts, but those referenced files are not present in the bundle, and a large design-ideas catalog is kept inline that could live in a separate reference; structure is decent but not cleanly split. | 2 / 3 |
Total | 10 / 12 Passed |