Content
81%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 thorough, highly actionable skill body with strong workflow sequencing and built-in validation gates; its main weakness is verbosity, re-teaching inherited pptx v2 material that could be deferred to the base skill, and progressive-disclosure relies on a reference/ tree that is not present in this bundle.
Suggestions
Trim the 'Inherited from pptx v2 (do NOT re-teach)' bullet block and the Shell & Execution Discipline expansion to one-line pointers — these duplicate the base skill and inflate the body; rely on the `→ see pptx v2 §X` cross-references you already use.
Consolidate the repeated ghost/accumulation warnings (Mental Model, Ghost Discipline, Pitfalls table M-2, Known Issues M-2) into a single canonical section; the same per-slide re-ghost rule is stated four times.
Verify the reference/ bundle files referenced in the body (decision-rules.md, morph-helpers.py, morph-helpers.sh, pptx-design.md, styles/INDEX.md) actually ship alongside SKILL.md, or inline the minimal essentials so progressive-disclosure is self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with copy-paste-ready recipes and tables, but at 539 lines it re-explains substantial inherited pptx v2 detail (the 'Inherited from pptx v2' bullet block, the Shell & Execution Discipline expansion, repeated caveats) that could be trimmed or deferred to the base skill. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready bash and python blocks cover the common morph cases; commands, prop names, readback queries, and jq filters are all specific and runnable, and the helper signatures are pointed to concretely. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints (pre-code Morph Pair Planning table, Delivery Gate 1–5a plus Gate 5b-morph-1..4 proof loops, COUNT-then-if/else gate pattern, and fix-and-revalidate feedback loops). | 5 / 5 |
Progressive Disclosure | Good structure with clearly signaled one-level-deep references to reference/ files (decision-rules.md, morph-helpers.py/.sh, styles/INDEX.md, pptx-design.md) and to the pptx base skill; the directory is absent from the bundle, so the in-file content carries more than an ideal overview would, preventing a 5. | 4 / 5 |
Total | 17 / 20 Passed |