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

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

72%Weight 40%Scale 1-3

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

A concise, well-organized skill body that gives concrete configuration decisions and assumes Claude's intelligence, with clean section structure. Its weakness is actionability and workflow validation: the final validation step and a couple of instructions stay abstract rather than providing literal commands or a recovery loop.

Suggestions

Replace 'Validate with the smallest useful Vite dev or build command' with the actual command, e.g. `vite build` or `npm run build`, and add a brief 'if it fails, fix and re-run' note to close the validation loop.

Add one minimal complete example (a short Vue 2 SFC snippet) showing the import order and a MarkdownRender with the recommended streaming props, so the guidance is fully copy-paste ready.

Make the worker-import guidance in step 4 explicit with a one-line code example (e.g. `import MermaidWorker from 'markstream-vue2/workers/mermaid?worker'`) rather than only describing the pattern.

Dimension	Reasoning	Score
Conciseness	Lean and assumes Claude's competence — it states parameter defaults and decisions ('smooth-streaming="auto" is the default', 'typewriter only controls the blinking cursor') without explaining what Vite, Mermaid, or workers are.	3 / 3
Actionability	Gives copy-paste-ready attribute bindings (':smooth-streaming="isStreaming ? \'auto\' : false"', 'html-policy="safe"') and exact import paths, but step 6 says only 'Validate with the smallest useful Vite dev or build command' without the literal command or a complete runnable example.	2 / 3
Workflow Clarity	The six-step workflow is clearly sequenced and includes a validation step (step 6), but the validation is described abstractly with no concrete command and no fix-and-retry feedback loop, leaving checkpoints implicit.	2 / 3
Progressive Disclosure	A sub-50-line body organized into clear sections (Workflow, Default Decisions, Useful Doc Targets) with a well-signaled one-level-deep list of doc paths, satisfying the simple-skill allowance for progressive disclosure.	3 / 3
	Total	10 / 12 Passed

Description

100%Weight 40%Scale 1-3

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 tightly scoped, third-person description that states concrete integration actions and pairs them with an explicit 'Use when' trigger covering the main Vite/Vue 2 scenarios. It earns top marks across all four dimensions with no fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple distinct concrete actions — worker import setup ('?worker or ?worker&inline setup for Mermaid or KaTeX'), 'modern CSS ordering', and 'Vue 2 compatibility' — going beyond a single domain + some actions.	3 / 3
Completeness	Explicitly answers what ('Integrate markstream-vue2 into a Vue 2 plus Vite app' plus setup tasks) and when ('Use when Codex needs...'), with an explicit 'Use when' clause so it is not capped at 2.	3 / 3
Trigger Term Quality	Uses the natural vocabulary of its niche ('Vue 2', 'Vite', 'worker imports', '?worker', 'Mermaid', 'KaTeX', 'CSS ordering') that a developer would actually say, not abstract jargon.	3 / 3
Distinctiveness Conflict Risk	The bundler+framework+library combination (Vue 2 + Vite + markstream-vue2 with Mermaid/KaTeX workers) is a tight, distinct niche unlikely to trigger for unrelated skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

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
Commit: f25ebd5

Reviewed: 11 days ago

Table of Contents

Discovery Implementation Validation

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.