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-orchestrated workflow skill with excellent progressive disclosure — it keeps only the workflow and delegates every technical detail to a clearly-signaled sibling skill. The steps are concrete and sequenced, though Step 2 repeats itself, snippets are shape hints rather than complete code, and validation depends on the external self-review checklist.
Suggestions
Tighten Step 2: state the skip-then-restate-assumption rule once and apply it to both the topic question and the aesthetic question, instead of repeating it three times across Steps 1 and 2.
Inline a minimal copy-paste-ready skeleton for the two exports the skill mandates (the design const and the meta export with theme/createdAt), leaving only the full token reference to slide-authoring.
Summarize the 4-6 highest-value items from slide-authoring's self-review checklist inline in Step 7 so basic structural validation does not require a second skill load.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — it explicitly refuses to duplicate the technical reference ('Don't duplicate that knowledge here; use it.') and explains no general concepts. But Step 2 is padded: the skip-then-restate-your-assumption rule is stated three times across Steps 1-2, and long parentheticals (the AskUserQuestion option-cap explanation, the aesthetic example triples) could be tightened. This fits anchor 4 (efficient, minor over-explanation to trim) rather than 5 (every token earning its place). | 4 / 5 |
Actionability | Guidance is highly concrete for an instruction-only skill — exact path 'slides/<id>/index.tsx', kebab-case id examples, explicit option brackets for each question, commands ('npm run dev', 'pnpm dev'), URL format, and named framework primitives (<Steps>/<Step>, SlideTransition, <ImagePlaceholder> from @open-slide/core). However, code snippets like 'export const design: DesignSystem = { … }' and the meta export are shape hints rather than copy-paste-ready, with the full contract delegated to slide-authoring, so it fits anchor 4 rather than 5. | 4 / 5 |
Workflow Clarity | Eight clearly numbered and logically sequenced steps (theme → clarify → id → structure → direction → write → self-review → handoff) with an explicit 'MUST ask before writing code' gate, id-collision checking, and restated-assumption correction points. Step 7 is an explicit validation step, but its actual checklist content lives in slide-authoring rather than being inline or summarized, a minor gap versus anchor 5's inline validate-fix-retry pattern; it is clearly above anchor 3 (checkpoints present, just not self-contained). | 4 / 5 |
Progressive Disclosure | This SKILL.md is purely a workflow overview and delegates all technical depth one level deep to the slide-authoring skill, clearly signaled with named sections ('Image placeholders', 'Speaker notes', 'Design system', 'Self-review before finishing', 'references/webfonts.md'). No content that belongs elsewhere is inlined, no bundle files exist to misplace, and navigation is easy — matching anchor 5's clear overview with well-signaled one-level-deep references. The single second-hop pointer (webfonts.md inside slide-authoring) is a purposeful cross-skill layer reached only when slide-authoring is already open, not buried content. | 5 / 5 |
Total | 17 / 20 Passed |