Content
81%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, workflow-sound skill body with excellent routing (decision matrix), validation checkpoints, and an unusually thoughtful visual-QA execution model. Its weaknesses are length — the image-sourcing material in particular restates itself two to three times and belongs partly in a reference file — and reference links (create.md, edit.md, read.md) that point at files missing from the bundle.
Suggestions
Ship create.md, edit.md, and read.md in the bundle — the decision matrix and 'Where each detail lives' route to them, but only SKILL.md and scripts/ exist, so every primary detail link dead-ends.
Collapse the image-sourcing section: state the L1–L4 channel list once, then keep only the decision table, download patterns, and anti-patterns; the current channel descriptions are repeated nearly verbatim in 'Decision (run per slide)'.
Move the typography defaults, slide-size tables, and scene-default mix into create.md (already the designated home for 'palette and typography guidance'), leaving SKILL.md with a one-line pointer — this would materially cut the overview file's token load.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and largely free of concepts-Claude-already-knows filler, but it runs ~560 lines for what is styled as an overview file, and sections repeat themselves: the L1–L4 image channels are fully described, then re-stated in 'Decision (run per slide)', then again across the anti-patterns; the Live preview section spends many lines on host-environment caveats. This is 'mostly efficient but could be tightened' (anchor 3) rather than anchor 4's 'minor instances of over-explanation' — the trimming opportunity is a section, not a sentence. | 3 / 5 |
Actionability | Guidance is copy-paste ready throughout: nine exact CLI invocations ('uv run scripts/dump_text.py input.pptx --notes'), complete download code patterns (urllib Request with User-Agent header, BytesIO variant, curl equivalent), a grep-able QA text-integrity check, and concrete tables (typography sizes, slide dimensions, channel budget per deck type). Specific commands cover the common cases, matching anchor 5; the only near-gap is the actor({...}) subagent snippet, which mirrors harness tool syntax rather than being runnable code, but it is illustrative by design. | 5 / 5 |
Workflow Clarity | The decision matrix routes every situation to a path and a 'read first' file, the pipeline order is explicit ('read → plan slide-by-slide → edit/create → validate → visual QA'), and the QA checklist supplies validation checkpoints with an explicit feedback loop ('If any of these fail, fix and re-run — don't paper over') for the batch/destructive XML operations (explode/prune/assemble). This matches anchor 5 — clear sequence, explicit validation, feedback loops, and a checklist — and clearly exceeds anchor 4's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | Structure and signaling are strong: a decision matrix with 'Read first' pointers, and a closing 'Where each detail lives' map — all one level deep. However, the three primary reference files it points to (create.md, edit.md, read.md) do not exist in the bundle (only SKILL.md and scripts/ are present), so the main disclosure links dead-end; the scripts referenced (dump_text.py, preview.ts, soffice_bridge.py, etc.) all exist. Additionally, ~130 lines of image-sourcing detail and the typography/scene-default tables are inline here even though the skill's own map says such recipes live in create.md. That is 'good structure... minor organization gaps' (anchor 4) rather than anchor 3, whose hallmarks (buried, unclearly signaled references) are absent — but the broken reference targets keep it below anchor 5's 'easy navigation'. | 4 / 5 |
Total | 17 / 20 Passed |