Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with strong QA/verification workflows, but it carries a large inline design-guidance section that trades against token efficiency and relies on two referenced markdown files (editing.md, pptxgenjs.md) that are missing from the bundle. Fixing the broken references and offloading the design material would lift both weak dimensions.
Suggestions
Create the missing editing.md and pptxgenjs.md bundle files referenced by 'Read [editing.md](editing.md)' and 'Read [pptxgenjs.md](pptxgenjs.md)', or remove the links — they currently point to nonexistent files.
Move the Design Ideas section (color palettes, typography, spacing, and the 'Avoid' list) into a separate reference file such as design.md and link to it from SKILL.md, keeping only the core read/edit/create workflow inline.
Trim general design coaching Claude already knows ('Don't create boring slides', 'Plain bullets on a white background won't impress anyone') to tighten the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands, but the large inline Design Ideas section (10 color palettes, font-pairing tables, spacing rules, and coaching like 'Don't create boring slides') spends tokens on general design principles Claude already knows and could live in a reference file. | 2 / 3 |
Actionability | Provides copy-paste-ready, executable commands throughout — 'python -m markitdown presentation.pptx', 'python scripts/thumbnail.py', 'python scripts/office/unpack.py', the soffice/pdftoppm conversion pair, and a grep one-liner for leftover placeholders. | 3 / 3 |
Workflow Clarity | The QA section gives an explicit verification loop with checkpoints — 'Generate slides → Convert to images → Inspect → List issues → Fix → Re-verify affected slides → Repeat until no new issues' and 'Do not declare success until you've completed at least one fix-and-verify cycle' — exactly the feedback-loop pattern the top anchor rewards. | 3 / 3 |
Progressive Disclosure | Structure is clear (Quick Reference table, well-signaled one-level links to editing.md and pptxgenjs.md), but those referenced files do not exist in the bundle and the bulky Design Ideas content that should be split out is inline, matching the mid anchor rather than the top. | 2 / 3 |
Total | 10 / 12 Passed |