CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

markstream-svelte

Integrate the beta markstream-svelte package in Svelte 5 or SvelteKit apps. Use when Codex needs Svelte 5 runes, CSS and optional peers, smooth streaming, worker setup, renderer-local or scoped custom components, or SSR-safe boundaries. Svelte 4 is unsupported.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, expert-level checklist that captures real API specifics (defaults, streaming-vs-history prop triples, worker and custom-component scoping) without padding, closing with a verification step. Its weaknesses are the absence of any complete executable snippet, an implicit rather than explicit step order, and doc-target references that point to files not included in the bundle.

Suggestions

Add one minimal complete example — import of the component plus its CSS and a `<MarkdownRender {content} />` usage — so the core flow is copy-paste ready.

Number or explicitly sequence the checklist (confirm version → install → CSS → render → configure → verify) and add a brief 'if svelte-check fails' follow-up to close the feedback loop.

Resolve the 'Useful Doc Targets' paths — either include the referenced docs in the bundle as one-level-deep reference files or state they live inside the markstream-svelte package repo.

DimensionReasoningScore

Conciseness

The checklist is dense and non-obvious API facts (defaults like 'smoothStreaming="auto"', activation conditions, typewriter/fade defaults) earn their tokens. A few rationale asides ('Content is already complete — pacing would slow it down, but fade gives a polished entry animation') could be trimmed, placing it at efficient-with-minor-trimmables (4) rather than the every-token-earns-its-place level (5).

4 / 5

Actionability

Concrete, exact guidance throughout: '<MarkdownRender {content} />', the streaming/history prop triples ('smoothStreaming="auto", fade={false}, typewriter={true}'), the dynamic-switch expression 'smoothStreaming={isStreaming ? \'auto\' : false}', and verification commands ('svelte-check, build, or e2e'). It falls short of 5 because there is no complete executable snippet — no import statement or runnable code block — only prop-level fragments.

4 / 5

Workflow Clarity

A clear implicit sequence runs from environment check ('Confirm Svelte 5; ask Svelte 4 users to upgrade') through install, CSS, default usage, advanced options, to verification ('Verify with svelte-check, build, or e2e'). Not a 5 because the ordering is implicit (unnumbered checklist), the verify step gives no failure-handling feedback loop, and the destructiveness cap does not apply since this is not a destructive or batch operation.

4 / 5

Progressive Disclosure

At ~26 lines the skill needs no external files, and it is organized into clean topic sections, which would merit 5 under the simple-skill exception. It drops to 4 because 'Useful Doc Targets' points at 'docs/guide/svelte.md' and 'docs/frameworks/svelte.md', which are not present in the skill bundle — references that cannot be resolved from the skill itself, a minor navigation gap.

4 / 5

Total

16

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description with an explicit what/when pair, good trigger terms, and a clear niche plus a supported-version boundary. The main gap is that it states only one action verb and omits the word 'markdown', the most natural thing a user would say when needing this skill.

Suggestions

Add the term 'markdown' (e.g., 'render streaming markdown in Svelte 5/SvelteKit apps') so users who say 'markdown' naturally trigger this skill.

Replace some noun-phrase capability lists with 1-2 more concrete action verbs (e.g., 'Configure smooth streaming, register KaTeX/Mermaid workers, and scope custom components') to lift specificity from 3 to 4-5.

DimensionReasoningScore

Specificity

The only stated action is 'Integrate the beta markstream-svelte package in Svelte 5 or SvelteKit apps'; the rest lists capability areas ('smooth streaming, worker setup, renderer-local or scoped custom components, or SSR-safe boundaries') rather than concrete actions the skill performs. It names the domain plus 1-2 actions with minor gaps, matching the score-3 anchor rather than 4, which requires several specific actions.

3 / 5

Completeness

It explicitly answers both: what ('Integrate the beta markstream-svelte package in Svelte 5 or SvelteKit apps') and when ('Use when Codex needs Svelte 5 runes, CSS and optional peers, smooth streaming, worker setup...'), with a concrete boundary statement ('Svelte 4 is unsupported'). This matches the score-5 anchor; the 'when' clause is explicit, not merely implied as at 4.

5 / 5

Trigger Term Quality

Natural terms users would say are present: 'Svelte 5', 'SvelteKit', 'streaming', 'worker setup', 'custom components', 'SSR'. A few common terms are missing — notably 'markdown' itself and phrases like 'render markdown' — so it falls between the good-coverage (4) and comprehensive-synonym (5) anchors.

4 / 5

Distinctiveness Conflict Risk

The trigger set (markstream-svelte, Svelte 5 runes, SvelteKit workers, smooth streaming) occupies a clear niche with minimal overlap with generic skills. It clearly matches the clear-niche, minimal-conflict anchor; moving to 4 would require demonstrable overlap with a closely related skill, which is not the case.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Simon-He95/markstream-vue

Path

.agents/skills/markstream-svelte/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.