Content
63%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, highly actionable authoring guide with exact commands, code snippets, and a sensible infer-first workflow, and its references/*.md navigation is clean and one level deep. Its weaknesses are runtime-internals verbosity in the presenter-mode section, duplicated theme cataloging, count inconsistencies (14 vs 15 templates, 30 vs 31 layouts), and bundle paths (templates/, examples/) that are referenced throughout but missing. Progressive disclosure and conciseness are the lowest-scoring dimensions.
Suggestions
Trim the presenter-mode implementation details (iframe/?preview=N mechanics, postMessage/BroadcastChannel sync, localStorage persistence) from SKILL.md and keep them in references/presenter-mode.md; retain only the trigger conditions, the S-key behavior, and the 3 script rules.
Fix the count inconsistencies ("15 full-deck templates" vs "One of the 14" and "gallery of all 14"; "31 layouts" vs "if none of the 30 fit") and ensure every referenced path ships in the bundle — new-deck.sh exits with an error when templates/deck.html is absent, and the quick start's core steps 3 and 5 cannot run without templates/single-page/ and templates/full-decks/.
Drop the inline 36-theme name enumeration and keep only the per-tone recommendation clusters (or 2-3 examples), deferring the full list to references/themes.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely dense, useful instruction, but the presenter-mode section explains runtime internals Claude does not need for authoring ("each preview is an <iframe> that loads the actual deck HTML with a ?preview=N query param", postMessage/BroadcastChannel sync, localStorage persistence), and the 36-theme name list plus per-tone recommendations duplicate the themes.md catalog — "Mostly efficient but includes some unnecessary explanation or could be tightened". | 3 / 5 |
Actionability | Guidance is concrete and mostly copy-paste ready ("./scripts/new-deck.sh my-talk", exact <link> tags, `data-anim="fade-up"`, `color: var(--text-1)` with explicit good/bad examples, "./scripts/render.sh examples/my-talk/index.html 12"), but internal inconsistencies ("15 full-deck templates" vs "One of the 14", "31 layouts" vs "if none of the 30 fit") and workflow steps that depend on a templates/ tree not present in the bundle leave minor gaps. | 4 / 5 |
Workflow Clarity | The sequence is clear and ordered — infer three decisions first, scaffold, pick theme, copy layouts, add animations, render to PNG — with a real error checkpoint ("If the managed renderer fails once, surface that error and stop instead of retrying alternate Chrome launch commands") and a rendering step that serves as output verification, matching "Clear sequence with most checkpoints present; minor validation gaps". | 4 / 5 |
Progressive Disclosure | Reference navigation is good — a dedicated "Catalogs (load when needed)" section pointing one level deep to references/themes.md, layouts.md, animations.md, full-decks.md, presenter-mode.md, authoring-guide.md, all of which exist — but scored against the actual bundle, the entire templates/ tree the body depends on (templates/deck.html, templates/single-page/*.html, templates/full-decks/<name>/, examples/demo-deck/) is absent, so core workflow paths do not resolve. | 3 / 5 |
Total | 14 / 20 Passed |