CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

markstream-vue2-vite

Integrate markstream-vue2 into a Vue 2 plus Vite app. Use when Codex needs Vite-friendly worker imports, `?worker` or `?worker&inline` setup for Mermaid or KaTeX, modern CSS ordering, or Vue 2 compatibility in a Vite-based repository.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/markstream-vue2-vite/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 tight, well-structured body that concentrates on non-obvious, library-specific decisions (streaming vs. history prop states, html-policy and Mermaid strict-mode defaults, CSS ordering). Its weaknesses are execution-level concreteness — no install command, no import snippet, no explicit validation command — and doc-target paths that are not verifiable within the skill bundle.

Suggestions

Add the concrete install command for step 2 (e.g., the exact npm/yarn/pnpm command with the optional Mermaid/KaTeX peers) and a one-line import snippet for `markstream-vue2/index.css` in step 3.

Make the step 6 validation checkpoint executable by naming the command (e.g., `vite build` or `vite dev` smoke test) instead of 'the smallest useful Vite dev or build command'.

Clarify where the 'Useful Doc Targets' paths live (e.g., in the installed package's docs directory) or move them into a real references/ bundle file so navigation is unambiguous.

DimensionReasoningScore

Conciseness

The body is lean and consists almost entirely of library-specific knowledge Claude cannot infer (prop defaults, streaming-vs-history configurations, html-policy defaults) with no padding of known concepts. It sits at anchor 4 rather than 5 because a few justificatory asides ('Content is already complete — pacing would slow it down, but fade gives a polished entry animation') could be trimmed, and it exceeds anchor 3 since none of the content is generic explanation.

4 / 5

Actionability

The prop configurations are concrete and copy-pasteable (':smooth-streaming="isStreaming ? \'auto\' : false"', '`markstream-vue2/workers/... ?worker`'), but there are no executable code blocks or commands anywhere: step 2 gives no install command, step 3 states 'Import `markstream-vue2/index.css` after resets' without a snippet, and step 6 says only 'Validate with the smallest useful Vite dev or build command'. This lands between anchors 3 and 4 — several key executable details are missing, but it is more concrete than the minimal high-level hints of anchor 2.

3 / 5

Workflow Clarity

A clear six-step sequence with checkpoints present: step 1 confirms the Vue 2 + Vite premise, a sub-step says 'verify its animation behavior before enabling both', and step 6 validates the build. It matches anchor 4 rather than 5 because the validation checkpoint is soft — 'smallest useful Vite dev or build command' is not a concrete command and there is no fix-and-retry feedback loop — though the non-destructive nature of the task means the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections (Workflow, Default Decisions, Useful Doc Targets) and appropriately keeps detail at overview level, which would otherwise merit a 5 under the simple-skill guidance. It drops to anchor 4 because the 'Useful Doc Targets' paths ('docs/guide/vue2-quick-start.md' etc.) do not exist as bundle files in the skill directory and their base location is never stated, leaving navigation ambiguous — a minor organization gap.

4 / 5

Total

15

/

20

Passed

Description

83%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 'Use when...' clause and concrete, distinctive triggers (worker import query strings, Mermaid/KaTeX, Vue 2 + Vite). Its main weakness is that it never mentions the library's central markdown rendering/streaming functionality, slightly under-representing what the skill covers and its most natural trigger terms.

DimensionReasoningScore

Specificity

The description names the domain ('Integrate markstream-vue2 into a Vue 2 plus Vite app') and several concrete specifics: 'Vite-friendly worker imports, `?worker` or `?worker&inline` setup for Mermaid or KaTeX, modern CSS ordering, or Vue 2 compatibility'. It falls at anchor 4 rather than 5 because it omits the library's core markdown-streaming/rendering capability entirely, a noticeable coverage gap; it is well above anchor 3 since it lists several specific, non-generic items.

4 / 5

Completeness

It explicitly answers both parts: the 'what' is 'Integrate markstream-vue2 into a Vue 2 plus Vite app' and the 'when' is an explicit 'Use when Codex needs Vite-friendly worker imports, `?worker` or `?worker&inline` setup for Mermaid or KaTeX, modern CSS ordering, or Vue 2 compatibility in a Vite-based repository' with concrete trigger phrases. This matches anchor 5; it is above anchor 4 because the 'when' clause is explicit and enumerates specific triggers rather than being weakly implied.

5 / 5

Trigger Term Quality

Natural terms users would say are present: 'Vue 2 plus Vite app', 'worker imports', 'Mermaid or KaTeX', 'CSS ordering', 'Vite-based repository'. Good coverage but a few natural variations are missing (e.g., markdown chat/streaming UI phrases, 'Vue2', '.vue'), so it matches anchor 4 rather than the comprehensive synonym coverage of anchor 5, while clearly exceeding the sparse keyword coverage of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The trigger conditions are tightly scoped (markstream-vue2 + Vue 2 + Vite + specific worker-import patterns), giving a clear niche. However, the body references a separate generic 'markstream-vue2' skill covering the same library, and the description does not itself draw that boundary, so there is minor overlap risk with that closely related skill — matching anchor 4 rather than the minimal-conflict profile of anchor 5.

4 / 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-vue2-vite/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.