Content
78%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 well-disciplined entry-point card: highly actionable template-copy and asset-rewrite recipes with a genuinely useful 404 gotcha, at a lean token budget. Weak spots are the missing post-build validation step and reference paths that are inconsistent and do not resolve within the shipped bundle.
Suggestions
Add a final verification step, e.g., 'Open the assembled index.html and confirm arrow-key navigation and the T theme cycle work before delivering' — this closes the workflow's only checkpoint gap.
Unify the master-skill reference to one consistent root path (it currently appears as both ../html-ppt/SKILL.md and design-templates/html-ppt/SKILL.md) so navigation is unambiguous.
Trim Recipe B's repeated file list and the duplicated 'do not ship upstream URLs' caveat — the shared warning once after the two recipes would suffice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: no primer on HTML/CSS concepts, and the one long passage (step 3) earns its tokens by documenting a genuinely non-obvious failure mode (parent-relative asset URLs 404 after copying). Not a 5: Recipe B's inline instructions repeat the file list from Recipe A and restate the URL caveat twice ("Either way, do not ship the upstream ../../../assets/... URLs verbatim"), which could be tightened. | 4 / 5 |
Actionability | Guidance is fully executable: exact template folder to copy from ("templates/full-decks/hermes-cyber-terminal/ — copy index.html and style.css"), exact files to copy (fonts.css, base.css, animations/animations.css, runtime.js), exact rewrites for the four link/script tags, theme swapping via "<link id=\"theme-link\">" with T to cycle, and a concrete destination for speaker notes ("<aside class=\"notes\">"). Paths and outcomes are specified so nothing is left to guesswork. | 5 / 5 |
Workflow Clarity | A clear numbered sequence (read master skill -> copy template -> fix asset URLs -> pick theme -> replace content -> place notes) with the riskiest step explicitly flagged with its failure mode (deck never activates, navigation dead) and two remedies. Not a 5: there is no explicit validation checkpoint after assembly (e.g., 'open index.html and confirm arrow keys / T cycle themes before delivery'), so error recovery is by recipe rather than by verification. | 4 / 5 |
Progressive Disclosure | The card correctly stays a thin overview pointing one level deep into a master skill ([../html-ppt/SKILL.md](../html-ppt/SKILL.md), the full-decks catalog, themes folder), but references are not cleanly signaled: the master skill is cited under two different root paths ("../html-ppt/SKILL.md" vs "design-templates/html-ppt/SKILL.md"), and none of these paths resolve within the skill's own bundle (no references/ or assets/ directories ship alongside it), so navigation depends on an unstated parent-repo layout. Not a 2 because the structure itself is well-organized sections that delegate detail appropriately. | 3 / 5 |
Total | 16 / 20 Passed |