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.
A well-structured, dense instruction-only skill: the workflow is clearly sequenced with an explicit validation step, prop-level guidance is concrete, and it avoids teaching concepts Claude already knows. Main gaps are the absence of any copy-paste code example (install command or minimal JSX), a near-verbatim duplication of the streaming-vs-history guidance between two sections, and a bare doc-target list that would benefit from one-line descriptions.
Suggestions
Deduplicate the streaming-vs-recovering-history guidance: keep the full prop triple in one place (Workflow step 5 or Default Decisions) and cross-reference it from the other instead of repeating it nearly verbatim.
Add one minimal executable example — the install command (e.g. `npm install markstream-react`) and a small `<Markstream content={...} smoothStreaming="auto" />` snippet — to lift actionability to copy-paste readiness.
Annotate the Useful Doc Targets with a one-line purpose per file (e.g. `react-next-ssr.md` — SSR boundaries and client-only loading) so the right reference is discoverable at a glance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with API facts and assumes Claude's competence — no basic React/SSR/markdown tutorials, and lines like "`typewriter` only controls the blinking cursor and defaults to `false`" earn their tokens. Not 5 because the streaming-vs-history guidance ("Streaming: `smoothStreaming="auto"`, `fade={false}`, `typewriter={true}`... Recovering history: `smoothStreaming={false}`, `fade={true}`, `typewriter={false}`") appears nearly verbatim in both Workflow step 5 and Default Decisions, a trimmable duplication; not 3 since the verbosity is confined to that one repeated block. | 4 / 5 |
Actionability | Concrete, near-executable guidance throughout: exact import paths ("Import `markstream-react/index.css`"), exact entrypoints (`markstream-react/next`, `/server`), exact prop values and defaults (`smoothStreaming="auto"`, `maxLiveNodes <= 0`, `htmlPolicy="safe"`), and named helpers (`defineStreamingComponents(...)`, `setCustomComponents`). Not 5 because there is no copy-paste-ready code — no install command syntax and no minimal JSX usage example; the guidance is prop-level rather than example-level. | 4 / 5 |
Workflow Clarity | The 8-step Workflow is a clear, correctly ordered sequence (confirm host → install → import CSS → choose entrypoint → choose content/nodes → SSR boundaries → custom components → validate) with step 8 "Validate with the smallest useful dev, build, or typecheck command" as an explicit checkpoint. Not 5 because there is no error-recovery feedback loop (nothing about what to do when validation or the build fails); not 3 because a validation checkpoint is explicitly present and each step's decision branches are well defined. | 4 / 5 |
Progressive Disclosure | Good single-file structure with clear sections (Workflow, Default Decisions, Useful Doc Targets) and one-level-deep doc references (`docs/guide/react-quick-start.md` etc., plus an inline pointer to `docs/guide/ai-chat-streaming.md`). No bundle files (references/, scripts/, assets/) exist to split content into, and at ~56 lines the body is within reasonable SKILL.md bounds. Not 5 because the doc-target list is bare paths without per-target descriptions or markdown links, and the dense streaming/animation default reference in step 5 is arguably material that belongs in a guide file. | 4 / 5 |
Total | 16 / 20 Passed |