CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

markstream-migration

Audit and migrate existing Markdown rendering to Markstream, or upgrade a markstream-vue 1.x integration to 2.x. Use when Codex needs to replace another renderer, classify direct vs custom vs plugin-heavy adoption, preserve behavior during adoption, migrate custom renderers into scoped Markstream overrides, decide when `nodes` streaming is worth adopting, or replace removed 1.x code-block dependencies, APIs, preview payloads, and parser types.

Quality

87%

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 well-structured, lean instruction-only skill: two clearly sequenced migration routes with an explicit routing rule, concrete prop/API names, real one-level-deep references, and validation plus rollback guidance. The main weaknesses are mild verbosity in the Vue 3 streaming/fade policy bullets and implicit rather than explicit fix-and-revalidate feedback loops.

Suggestions

Tighten or split the multi-clause Vue 3 mode/fade/smooth-streaming bullets (Route A step 6) and consider moving the mode-selection detail into references/adoption-checklist.md, keeping only the decision rule inline.

Make feedback loops explicit in validation steps, e.g., 'If checks fail: fix the issues, then re-run the same checks before reporting' in both routes.

Convert the 'Useful Doc Targets' bare paths into clearly signaled links (or state where these docs live, e.g., in the Markstream repo) so navigation is unambiguous.

DimensionReasoningScore

Conciseness

The body is directive-dense with no concept explanations Claude already knows (e.g., 'Renderer swap first, streaming optimization second'). However, bullets like the Vue 3 fade/streaming policy ('they can be enabled together... Do not carry a legacy :fade="!isStreaming" binding...') are multi-clause and partially overlap, so minor trimming is possible. This is the 4 anchor (efficient, minor instances that could be trimmed) rather than 5 (every token earns its place).

4 / 5

Actionability

Concrete, executable guidance throughout: named props and options (mode="chat", smooth-streaming="auto", codeBlockOptions, stream-diffs, parseOptions.preTransformTokens, htmlPolicy / html-policy="trusted"), concrete audit search terms, and unambiguous decision rules. As an instruction-only skill, absent code is not penalized, but there are minor gaps such as no example install command and no sample scoped override mapping. Solidly 4, not 5.

4 / 5

Workflow Clarity

Both routes are clearly numbered and sequenced, with an explicit routing decision up front and validation steps ('Run the smallest relevant tests or build', 'Validate the migrated behavior and leave a rollback path'). Feedback loops (fix and re-validate) are implied rather than explicit, which fits 4 (clear sequence, most checkpoints, minor validation gaps) rather than 5.

4 / 5

Progressive Disclosure

Good structure: an overview with two clearly signaled, real, one-level-deep reference links (verified present in references/ with no nested references) plus a Default Decisions section. Minor gaps: the dense mode/fade/streaming decision guidance in Route A step 6 reads like reference material inlined in the overview, and the 'Useful Doc Targets' are bare repo paths rather than signaled links to the bundle. Fits 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

92%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 description: concrete, comprehensive action list in third person with an explicit 'Use when...' trigger clause covering both adoption and 1.x-to-2.x upgrade scenarios. The only gap is that common competing-renderer names (react-markdown, markdown-it, marked), which the body already uses for routing, are absent from the trigger terms.

Suggestions

Add the natural trigger terms users would say when replacing a renderer (e.g., 'react-markdown', 'markdown-it', 'marked') to the description so it fires on those requests, not just on Markstream-named ones.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions (audit and migrate Markdown rendering, upgrade markstream-vue 1.x to 2.x, migrate custom renderers into scoped overrides, replace removed 1.x code-block dependencies, APIs, preview payloads, and parser types) with comprehensive coverage and no vague filler. Third person is used throughout, and 4 would require minor coverage gaps that are not present.

5 / 5

Completeness

It explicitly answers both what ('Audit and migrate existing Markdown rendering to Markstream, or upgrade a markstream-vue 1.x integration to 2.x') and when ('Use when Codex needs to replace another renderer, classify direct vs custom vs plugin-heavy adoption...'). The when-clause is fully explicit with concrete trigger phrases, matching the 5 anchor; 4 would require a less explicit when.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('Markdown rendering', 'renderer', 'markstream-vue', '1.x integration to 2.x', 'custom renderers', 'streaming'), but common renderer names users would naturally say (react-markdown, markdown-it, marked) appear only in the body, not the description. This fits the 4 anchor (good coverage, a few natural terms missing) rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Markstream / markstream-vue migration) with product-specific trigger terms unlikely to appear in other skills. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

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-migration/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.