CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

markstream-vue2-cli

Integrate markstream-vue2 into a Vue 2 Vue CLI or Webpack 4 app. Use when Codex needs Webpack 4-friendly setup, CDN worker fallbacks for Mermaid or KaTeX, `dist/index.css` imports, Vue 2 composition-api shims, or code block choices limited to `stream-diffs` or plain `<pre>`.

Quality

86%

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

78%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 compact, well-structured body that documents genuinely non-obvious decisions (streaming vs history-recovery prop combos, CDN-worker preference, html-policy defaults) without teaching basics. The main gaps are executable completeness — no install command, import statement, or named validation command — and slight redundancy with the frontmatter.

Suggestions

Add a copy-paste install and import snippet (e.g. npm install command plus `import 'markstream-vue2/dist/index.css'`) so step 2-3 are fully executable.

Make the worker guidance concrete by showing a complete `createMermaidWorkerFromCDN(...)` call with its actual arguments instead of ellipsis signatures.

Name the validation command in step 6 (e.g. the specific `vue-cli-service build` or dev command) and add a one-line fallback if it fails, which would also lift workflow clarity.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — it never explains what Vue, Webpack, or Mermaid are, and every line carries non-obvious domain decisions (e.g. 'smooth-streaming="auto" is the default and activates when typewriter=true or max-live-nodes <= 0'). Not a 5 because the opening line 'Use this skill when the host app is Vue 2 on Vue CLI or another Webpack 4-style stack' duplicates the frontmatter description, and a few glosses ('gives a polished entry animation') could be trimmed.

4 / 5

Actionability

Guidance is largely concrete: named functions ('createKaTeXWorkerFromCDN(...)', 'createMermaidWorkerFromCDN(...)'), an import path ('markstream-vue2/dist/index.css'), and ready prop/value pairs for each scenario ('smooth-streaming="auto", :fade="false", typewriter=true'). Not a 5 because there is no install command, no copy-paste import statement or code block, and the worker functions are given as ellipsis signatures rather than complete calls with arguments.

4 / 5

Workflow Clarity

A clear six-step sequence runs from environment confirmation through install, CSS import, worker strategy, renderer choice, to 'Validate with the smallest useful local dev or build command'. Not a 5 because step 6 is a directive to validate without naming an actual command, and there is no error-recovery loop if validation fails; not a 3 because a validation checkpoint is explicitly the final step and the ordering is unambiguous.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files, and is organized into three well-labeled sections (Workflow, Default Decisions, Useful Doc Targets) with the doc targets serving as clearly signaled one-level navigation. Per the simple-skill guideline, well-organized sections alone warrant a 5 here; nothing is inlined that belongs in a separate file.

5 / 5

Total

17

/

20

Passed

Description

87%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, niche-scoped description with an explicit 'Use when' clause, third-person voice, and dense concrete triggers. Its only weaknesses are the thin single-verb 'what' statement and the absence of synonym/extension variants among trigger terms.

DimensionReasoningScore

Specificity

The opening 'Integrate markstream-vue2 into a Vue 2 Vue CLI or Webpack 4 app' names the domain and target, and the when-clause enumerates concrete specifics ('CDN worker fallbacks for Mermaid or KaTeX', 'dist/index.css imports', 'Vue 2 composition-api shims', 'code block choices limited to stream-diffs or plain <pre>'). It falls just short of the 5 anchor because the 'what' rests on a single generic action ('Integrate') with the remaining specifics framed as trigger conditions rather than distinct capabilities.

4 / 5

Completeness

Both halves are explicit: 'Integrate markstream-vue2 into a Vue 2 Vue CLI or Webpack 4 app' answers what it does, and 'Use when Codex needs Webpack 4-friendly setup, CDN worker fallbacks...' answers when with concrete trigger phrases. This matches the 5 anchor ('clearly and explicitly answers both what AND when with concrete trigger phrases'); it is not a 4 because the when-clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Strong natural terms users of this stack would actually say: 'Vue 2', 'Vue CLI', 'Webpack 4', 'Mermaid', 'KaTeX', 'composition-api'. Not a 5 because it lacks synonyms and file-extension variants (e.g. .vue, webpack.config.js, vue.config.js) that would broaden natural recall, and 'markstream-vue2' itself is the only package-name spelling offered.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — one named library pinned to a specific stack (Vue 2 + Vue CLI/Webpack 4) with distinctive tokens (markstream-vue2, stream-diffs, dist/index.css) — so it would rarely fire for a different skill. Not a 4 because the overlap risk with a generic Vue or Webpack skill is negligible given the package-name triggers.

5 / 5

Total

18

/

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