Content
77%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.
An exceptionally actionable skill with a best-practice QA workflow (gates, fix-verify loops, escalation), held back by redundancy and monolithic structure. The same shell-escaping and JSON-schema facts are repeated two to three times each, and the design references (font tables, palettes, recipes) could live in one-level-deep bundle files.
Suggestions
Deduplicate the shell-escaping guidance: state the `\$` / `\n` / `\t` rules once in "Shell & Execution Discipline" and have the visual delivery floor and Pitfalls table cross-reference it instead of restating it.
Move the font-pairing table, the 10 color palettes, and recipes (a)–(f) into references/ files (e.g. references/design.md, references/recipes.md) linked one level deep from SKILL.md, keeping the core rules and Quick Start inline.
State the `query --json` `.data.results[]` schema once in "Reading & Analysis" and drop the repetition in recipe (c).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and assumes Claude's competence (no "what is a pptx" padding), but the same gotchas are restated repeatedly: the `\$` / `\n` shell-escaping rules appear in "Shell & Execution Discipline", again under "No `\$` literals in slide text" in the visual delivery floor, and a third time in the Pitfalls table; the `.data.results[]` JSON-schema note appears in both "Reading & Analysis" and recipe (c); contrast floors are specified twice. That is more than minor duplication — matches "mostly efficient but could be tightened", not anchor 4's "minor instances", and well above anchor 2 since nothing explains concepts Claude already knows. | 3 / 5 |
Actionability | Everything is executable and copy-paste ready: the Quick Start builds a real minimal deck, recipes (a)–(f) give exact commands with pre-computed cm coordinates and hex colors, the QA gates are runnable shell scripts, and the Pitfalls table pairs each trap with its concrete fix. Not 4: no gaps — the common cases (cover, data slide, flowchart, KPI grid, decision tree) each have a complete runnable block. | 5 / 5 |
Workflow Clarity | A numbered Common Workflow (1–7) enforces incremental validation ("One command → check exit code → continue", "get --depth 1" after structural ops), and the QA section is exactly the anchor-5 feedback loop: Gates 1/2/2b/3 with REJECT-and-exit semantics, a mandatory fix-verify loop capped at 3 cycles with a convergence criterion, and an escalation protocol when it doesn't converge. Batch/deck operations have emphatic, explicit validation. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ all absent), so everything is inline in a ~587-line single file. Section structure and headers are clear, and detailed prop schemas are delegated to `officecli help` (a well-signaled external reference), but large blocks that clearly belong in separate reference files are inlined — the 8-row font-pairing table, 10 full color palettes, and 6 complete recipes — matching anchor 3's "content that should be separate is inline". Not 2: structure is strong, not minimal; not 4: the split opportunity is more than a minor organization gap at this file size. | 3 / 5 |
Total | 16 / 20 Passed |