Content
75%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 body is a well-structured, action-oriented entry card: a clear six-step workflow with concrete paths and a genuinely useful warning about parent-relative asset URLs breaking after template copy. Its main weaknesses are the absence of any validation checkpoint and its reliance on upstream paths that are inconsistent and unverifiable within this bundle.
Suggestions
Add an explicit post-rewrite validation step, e.g. 'After rewriting, confirm the four asset links resolve (open index.html and check base.css/runtime.js load) before shipping'.
Reconcile the inconsistent path roots — '../html-ppt/SKILL.md' vs 'design-templates/html-ppt/templates/...' — into one canonical reference so the steps are executable as written.
Move the lengthy Recipe A/B asset-relocation detail into a reference file (e.g. references/asset-paths.md) and keep a one-line pointer in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative with no explanation of concepts Claude already knows — every instruction (template copy, asset relocation, theme swap, notes placement) is operational. Minor trimming is possible in the 'because it sits three folders deep' rationale and the asset paths repeated across Recipe A, keeping it at anchor 4 rather than 5. | 4 / 5 |
Actionability | Concrete file paths, exact source-to-target URL rewrites ('../../../assets/...' to project-local paths), and explicit keep-rules ('.tpl-pitch-deck' body class, notes in <aside class="notes">) make the guidance mostly executable. It is not 5 because the referenced files and paths ('../html-ppt/SKILL.md' vs 'design-templates/html-ppt/...') are inconsistent and none exist in this skill's bundle, so the steps cannot be executed or verified as written. | 4 / 5 |
Workflow Clarity | Six clearly sequenced numbered steps with an explicit failure-mode warning (shared CSS/JS will 404 if upstream URLs ship verbatim) give a clear sequence. It is not 5 because there is no explicit validation checkpoint after the rewrite (e.g., verify the four links resolve before shipping), and not below 4 since this is neither a destructive nor batch operation requiring a feedback loop. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and references (the html-ppt master skill, full-decks catalog) are one level deep and clearly signaled with markdown links. It is not 5 because the bundle ships no reference files at all, the signaled links resolve outside the bundle, and the detailed asset-rewrite recipes in step 3 arguably belong in a separate reference file. | 4 / 5 |
Total | 16 / 20 Passed |