Content
88%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.
This is a strong script-bundle skill body: fully executable commands verified against the bundle, a clear five-step procedure with explicit validation checkpoints and fallbacks, and pitfalls restricted to genuinely non-obvious operational knowledge. The only real defects are command duplication between the 'How to Run' block and the Quick Reference table, and a 'tests/' reference pointing at a directory not present in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — no concept explanations, a command table, and pitfalls limited to non-obvious behaviors like run splitting and rId remapping — matching 'efficient; minor instances of over-explanation that could be trimmed'. It is not 5 because the 'How to Run' bash block and the 'Quick Reference' table duplicate roughly a dozen identical command lines, and the Procedure section repeats some of the same flags a third time. | 4 / 5 |
Actionability | Every operation has a copy-paste-ready command whose flags all verify against the actual scripts (e.g. 'pptx_edit.py deck.pptx --replace-text OLD NEW', '--chart-data spec.json'), with concrete inline JSON spec formats ('{"slide": 0, "chart": 0, "categories": [...], "series": {...}}') and an exact PDF-export command — fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | A five-step Procedure (create, read, edit, template, visual verification) is followed by a dedicated Verification section with numbered checkpoints and feedback loops: 'After any create/edit, run pptx_read.py OUT.pptx --outline and check slide count, texts, tables, notes', render-fallback guidance when tools are missing, and per-pitfall recovery notes ('re-read the deck afterward to confirm'). This matches the top anchor for explicit validation with error recovery on destructive/batch edit operations. | 5 / 5 |
Progressive Disclosure | Structure is good: the body is an overview plus quick reference, heavy detail is correctly deferred one level deep to the bundle scripts (full spec format via 'pptx_create.py --help'), and all five referenced scripts exist with matching flags. It is not 5 because the Verification section references 'python -m pytest tests/ -q' but no tests/ directory exists in the bundle — a dangling reference — and the create-spec/chart-ops field inventories are borderline content that could live in a reference file. | 4 / 5 |
Total | 18 / 20 Passed |