Content
72%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, token-efficient body with executable demos and good read-path sequencing, but destructive/batch write workflows lack validation checkpoints and all content is inlined in one file with no progressive disclosure to references.
Suggestions
Add a validation step after destructive XML edits — e.g. re-open with PptxInspect summary or render the changed slide — to confirm the file is still valid and the edit landed before reporting success.
Split the three full pptxgenjs/adm-zip demos into a references/ file (e.g. examples.md) and keep SKILL.md as an overview that points to them, so the skill practices one-level-deep progressive disclosure.
Add a verify checkpoint to the batch N-page generation demo (e.g. assert slideCount or render a sample slide) so batch operations are not left unvalidated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and information-rich, assuming Claude knows pptxgenjs/adm-zip without explaining them; the three code demos are long but each covers a distinct common case and earns its place, with only minor prose that could be trimmed. | 4 / 5 |
Actionability | It provides three fully executable copy-paste demos, concrete tool invocations with parameters (e.g. PptxInspect { action: "summary", … }), and a compact symptom→cause→fix table covering common cases. | 5 / 5 |
Workflow Clarity | The read path has a clear summary→dispatch sequence and the visual-recognition branch has an explicit anti-hallucination checkpoint, but the destructive XML-edit (2.3) and batch generation (2.2) workflows lack validation/verification steps, capping this per the destructive-operations rule. | 3 / 5 |
Progressive Disclosure | The body is well-organized into numbered sections with tables and callouts, but it is a single monolithic ~250-line file with three long inline code demos and no external reference files to offload detail. | 3 / 5 |
Total | 15 / 20 Passed |