Content
53%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.
The skill body is a clean, token-efficient router with genuinely well-structured one-level-deep references, but it never descends into concrete execution guidance — and its main subcommand target is an empty circular stub, so following the workflow yields no actual instructions for creating slides.
Suggestions
Replace the circular stub in references/create.md with the actual creation steps (e.g. token/design-token loading, template selection, Chart.js integration, output location).
Add a minimal quick-start example in the body (e.g. one concrete invocation for `slides create "seed pitch" 10`) so the core path is executable without chasing references.
Tighten or trim the "Script Paths" section, and remove or correct references to a scripts/ folder that is not part of this bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is efficient with no explanations of concepts Claude already knows; the only trimming candidate is the dense "Script Paths" paragraph, which over-explains a path convention and references a scripts/ folder that does not exist in this bundle. | 4 / 5 |
Actionability | The body is pure routing with no code, commands, or templates, and "Execute with remaining arguments" defers all real guidance to references/create.md — which is itself a circular stub ("Invoke `slides` skill") containing no executable steps, leaving only high-level hints. | 2 / 5 |
Workflow Clarity | The 3-step routing sequence (parse subcommand, load reference, execute) is coherent and ordered, but step 3 is a large undefined gap and there are no checkpoints for what executing actually involves, matching the 'steps listed but gaps' anchor. | 3 / 5 |
Progressive Disclosure | The body provides a clear overview with two well-signaled tables pointing to 5 real reference files that are one level deep and substantive (layout patterns, templates, formulas, strategies); the hollow create.md stub behind the primary subcommand is the notable organization gap keeping this below 5. | 4 / 5 |
Total | 13 / 20 Passed |