Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, highly actionable body with excellent workflow and validation guidance, slightly weakened by some advisory prose Claude already knows and by overview references to create.md/edit.md/read.md that are missing from the bundle.
Suggestions
Ship the missing referenced files create.md, edit.md, and read.md (or remove their links) so the progressive-disclosure path resolves and the 'Where each detail lives' map is not dead.
Trim the 'Authoring principles' section and opening recap to the non-obvious operational guidance (e.g. keep the CJK East-Asian font-slot recipe and autofit behavior, drop 'bullets are not the default' / 'one idea per slide' which Claude already knows) to lift conciseness.
Optionally move the typography and slide-size reference tables into create.md to keep SKILL.md as a leaner overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and high-signal (exact commands, tsconfig, tables of pt sizes and pixel dimensions that are genuinely non-obvious), but the 'Authoring principles' section ('One idea per slide', 'Title, not label', 'Bullets are not the default') restates presentation-design wisdom Claude already knows and the opening paragraph recapitulates the description. Not a 3 because it could be tightened; not a 1 because there is no condescending library/format primer and most tokens earn their place. | 2 / 3 |
Actionability | Copy-paste-ready throughout — "uv run scripts/dump_text.py input.pptx --notes > input.txt", "uv add python-pptx lxml Pillow", a complete tsconfig.json, and the QA grep one-liner. Not below 3 because the guidance is concrete and executable rather than descriptive. | 3 / 3 |
Workflow Clarity | Clear sequence ("read → plan slide-by-slide → edit/create → validate → visual QA") plus a QA checklist with explicit validation commands and a feedback loop ("If any of these fail, fix and re-run — don't paper over") on document/XML operations. Not below 3 because validation checkpoints and retry guidance are explicit, exactly the fragile-operation pattern the rubric rewards. | 3 / 3 |
Progressive Disclosure | The structure is well-signaled and one-level-deep — a 'Where each detail lives' map pointing to create.md / edit.md / read.md — but those three referenced detail files are absent from the bundle (only scripts/ exists), so the disclosure path is partially broken. Not a 3 because the actual bundle does not contain the files the overview points to; not a 1 because references are clearly signaled, not deeply nested, and inline content is appropriately kept in the overview. | 2 / 3 |
Total | 10 / 12 Passed |