Content
71%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 lean, well-structured template skill with a clear workflow and an exact output contract. Its main weaknesses are dangling references — the bundle ships none of the files the body points to (example.html, template.json, LICENSE, assets/deck-stage.js) — and the absence of any final verification step for the produced deck.
Suggestions
Ship the referenced files in the bundle (example.html, template.json, LICENSE, and any assets/ runtime) or remove/repair the pointers so every link resolves.
Add a final validation step to the Workflow, e.g., "7. Critic pass: re-open the deck, confirm every must-keep number, name, and date survived replacement, and that page-number labels match the final slide count."
Trim the duplicated design-system warning — keep it in one place (either the intro paragraph or Workflow step 3) to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is compact and each section (At a glance, Best for, Avoid for, Workflow, Output contract, Source & license) delivers template-specific guidance Claude could not infer. Minor trimmable redundancy: "Mixing layouts across templates breaks the system; stay inside this one" restates Workflow step 3's "Preserve the design system. Never substitute fonts, recolor the palette...". Not 5 because of that small duplication; not 3 because there is no over-explanation of concepts Claude already knows. | 4 / 5 |
Actionability | The workflow gives concrete, executable instruction ("Clone `example.html`", "Replace placeholder content", "duplicate an existing slide of the most appropriate layout", "drop slides from the bottom", "Update page-number labels") and the Output contract specifies the exact artifact tag format. As an instruction-only skill, absence of code is not penalized. Not 5 because key referenced artifacts (the actual layouts in `example.html`, `template.json`) are not available to consult, leaving the executor to discover structure on their own. | 4 / 5 |
Workflow Clarity | The six-step workflow is clearly sequenced (clone → replace → preserve → resize → design missing layouts → keep runtime) with an explicit consistency checkpoint ("Update page-number labels") and a guard ("leave it intact"). Not 5 because there is no final validation/critic step (e.g., verify the deck renders or that must-keep numbers survived); not 3 because the operation is low-risk and the sequence has no gaps or incoherence. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and references are one level deep and clearly signaled ([`LICENSE`](./LICENSE), `template.json`, `example.html`, `assets/deck-stage.js`), but none of these referenced files exist in the skill bundle — there are no `references/`, `scripts/`, or `assets/` directories, so every external pointer dangles. Not 4 because navigation to the referenced material actually fails; not 2 because the inline content itself is appropriately placed and organized, not a monolith. | 3 / 5 |
Total | 15 / 20 Passed |