Content
88%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.
This is a high-quality, deeply operational skill body: copy-paste commands, explicit validation with feedback loops, and a concentration on genuine footguns (file corruption, silent option ignores, QA font substitution) rather than general knowledge. The main improvement opportunities are removing the duplicated warnings and splitting the design-guidance material into a reference file.
Suggestions
Deduplicate repeated warnings: state the thumbnail prefix/overwrite hazard and the validate --original rationale once (e.g., in the scripts table) and reference them elsewhere, trimming the conciseness penalty.
Move the Design Ideas section (palette table, typography tables, layout options) into a references/design.md and keep a short pointer plus the hard rules inline, improving both token efficiency and progressive disclosure.
Trim the AI-generation 'Avoid' list entries that restate guidance already given elsewhere (text-box padding, low-contrast) to a single line each.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, high-value specifics (corruption triggers like '"00000020"' hex alpha, font-substitution QA caveats, EMU mutation gotchas) and assumes Claude's competence rather than teaching basics — matching 'efficient, minor instances that could be trimmed'. Not 5 because a few warnings are stated twice (the thumbnail prefix/overwrite warning appears in both the scripts table and the Editing section; the validate --original rationale is repeated in the table and QA section), and the Design Ideas section is somewhat padded relative to the rest. | 4 / 5 |
Actionability | Every workflow ships copy-paste-ready commands: the unzip/edit/zip/validate bash block, `markitdown output.pptx | grep -iE "..."` for placeholder checks, exact pptxgenjs option names (`charSpacing`, `paraSpaceAfter`, `dataLabelPosition: 'ctr'`), and a concrete pdftoppm invocation with zero-padding behavior explained. Fully executable with the common cases covered. | 5 / 5 |
Workflow Clarity | A task→approach table routes the three workflows, the edit pipeline is sequenced with ordering constraints ('Do all structural work ... before editing any slide's content'), and validation is explicit with feedback loops at every stage: validate.py with --original baselining, 'If grep returns results, fix them before declaring success,' and 'After fixes, rerun all four commands above.' This matches the top anchor including error-recovery loops for the XML manipulation context. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all referenced paths (scripts/thumbnail.py, add_slide.py, clean.py, office/validate.py, office/soffice.py) exist and are surfaced up front in a well-signaled scripts table, and the body is clearly sectioned. Not 5 because there are no reference files at all — ~85 lines of Design Ideas content (palette table, typography tables, layout lists) and the detailed QA checklist live inline in SKILL.md where a one-level-deep reference file would keep the overview leaner. | 4 / 5 |
Total | 18 / 20 Passed |