Content
87%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a tight, highly actionable authoring guide with concrete file paths and two copy-paste recipes, appropriately deferring detail to the upstream master skill. Its main gap is the absence of an explicit validation step to confirm the copied deck's runtime and navigation actually work before shipping.
Suggestions
Add an explicit validation checkpoint after copying/rewriting assets, e.g. 'Open index.html and confirm slides advance and base.css/animations.css/runtime.js load without 404s before replacing demo content.'
Trim the explanatory aside about why the ../../../assets/... URLs break to a single clause, since the recipes already make the fix self-evident.
State the verification outcome expected (slides navigate, theme cycles with `T`) so the checkpoint is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: it provides exact paths and two concrete recipes rather than explaining what HTML/CSS or decks are, and nearly every token earns its place. | 3 / 3 |
Actionability | Guidance is concrete and executable — exact files to copy (e.g. design-templates/html-ppt/assets/base.css), precise <link>/<script> path rewrites for Recipe A and B, the `T` theme cycle, and the `<aside class="notes">` rule are all copy-paste ready. | 3 / 3 |
Workflow Clarity | The numbered authoring sequence (read master skill, copy template, bring runtime, pick theme, replace content, add notes) is clearly ordered, but there is no explicit validation/verification checkpoint despite the skill itself warning that 'slide navigation is dead' if the asset URLs 404. | 2 / 3 |
Progressive Disclosure | The card is a focused entry point with well-organized sections that defer detail to the master skill via one-level-deep, clearly signaled references (../html-ppt/SKILL.md, ../html-ppt/references/full-decks.md); no bundle files are present to organize. | 3 / 3 |
Total | 11 / 12 Passed |