Content
92%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 concrete commands, specific design reference data, and a strong QA fix-and-reverify loop. Its main weakness is progressive disclosure: the referenced editing.md and pptxgenjs.md files are missing from the bundle, and a sizable design section is inlined rather than split into a referenced file.
Suggestions
Add the missing referenced files editing.md and pptxgenjs.md to the bundle (or remove the links) — the Quick Reference and Editing/Creating sections point to them but they do not exist, so navigation breaks when Claude tries to load them.
Move the large inline Design Ideas block (color palettes, typography, spacing, avoid-list) into a separate reference such as design.md and link to it from a brief overview, keeping SKILL.md a lean index.
Reconcile all referenced paths against the bundle: thumbnail.py, office/unpack.py, and office/soffice.py exist, but editing.md and pptxgenjs.md do not, so either ship them or switch those pointers to inline guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, providing concrete reference data (hex palettes, "36-44pt bold", "0.5\" minimum margins") and copy-paste commands rather than explaining concepts Claude already knows; it does not pad with generic background, so it sits at the top anchor despite its length. | 3 / 3 |
Actionability | Fully executable, copy-paste-ready guidance throughout — "python -m markitdown presentation.pptx", "python scripts/office/unpack.py presentation.pptx unpacked/", "pdftoppm -jpeg -r 150 output.pdf slide" — with specific examples and concrete values, matching the top anchor. | 3 / 3 |
Workflow Clarity | The QA section gives a clear sequenced loop with explicit validation checkpoints — "1. Generate slides → Convert to images → Inspect ... 5. Repeat until a full pass reveals no new issues" and "Do not declare success until you've completed at least one fix-and-verify cycle" — providing the feedback loop the rubric requires for document manipulation. | 3 / 3 |
Progressive Disclosure | References are well-signaled and one level deep ("Read [editing.md](editing.md) for full details", "Read [pptxgenjs.md](pptxgenjs.md)"), but those two referenced files are absent from the bundle and a large inline Design Ideas section (palettes, typography, spacing, avoid-list) that could be split out keeps it below the top anchor. | 2 / 3 |
Total | 11 / 12 Passed |