CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

markstream-custom-components

Override built-in Markstream node renderers and add trusted custom tags across Vue, React, Solid, Svelte, and Angular. Use when Codex needs scoped `setCustomComponents`, renderer-local React `streamingComponents` or `htmlComponents`, Angular/Svelte `customComponents`, Vue app-scoped components, node override keys such as `image`, `code_block`, `mermaid`, or `link`, or nested renderers for tags such as `thinking`.

Quality

82%

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

71%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, information-dense instruction skill with a clear sequenced workflow and an appropriately split reference file. Its main weakness is actionability: it names APIs precisely but never shows a concrete registration example, and validation guidance lacks an executable check.

Suggestions

Add one minimal executable example per major pattern, e.g. a scoped Vue registration (setCustomComponents('x', { thinking: Component })) and a React defineStreamingComponents map, so implementers have copy-adaptable code.

Make step 6's validation concrete: name a specific command or check (e.g. the docs build command or a targeted test invocation) instead of 'Prefer a local demo, targeted test, or docs build'.

Trim or merge the 'Default Decisions' section, which repeats the scoped-first, leaf-before-container, and nested-renderer guidance already stated in workflow steps 2-4.

DimensionReasoningScore

Conciseness

The workflow is dense and every step carries API-level information with no explanation of concepts Claude already knows. Not 5 because the 'Default Decisions' section restates guidance already given in steps 2-4 (scoped before global, leaf before container, nested renderers for Markdown bodies) and could be trimmed; not 3 because there is no padded or unnecessary conceptual explanation.

4 / 5

Actionability

Concrete API names and signatures appear throughout ("setCustomComponents(customId, mapping)", "defineStreamingComponents(...)", "removeCustomComponents(customId)", props like node, loading, indexKey, estimatedPreviewHeightPx), but there is no code example showing an actual registration or component mapping in any framework. Missing the executable usage details that would lift it to anchor 4, yet far more specific than anchor 2's high-level hints.

3 / 5

Workflow Clarity

Six clearly sequenced steps (classify, prefer scoped, smallest safe override, preserve nested Markdown, keep props/cleanup, validate) with a validation step ('Prefer a local demo, targeted test, or docs build'). Not 5 because validation is soft guidance with no concrete command or fix-and-retry feedback loop; not 3 because the sequence and checkpoints are explicit, and the operations are not destructive/batch so no cap applies.

4 / 5

Progressive Disclosure

The ~50-line body is a clear decision guide, and references/patterns.md (verified to exist) is well-signaled ('Read references/patterns.md before choosing an override strategy'), one level deep, and appropriately holds the override-key table and per-framework patterns. Matches anchor 5's clear overview with well-signaled one-level-deep references; the sibling-skill and docs-guide pointers are supplementary, not nested.

5 / 5

Total

16

/

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 description: concrete capabilities, explicit and specific trigger guidance, and a well-defined niche. The only gap is that trigger coverage relies entirely on enumerated API identifiers rather than also including natural-language phrasings users might say.

DimensionReasoningScore

Specificity

Names the domain and two concrete actions ("Override built-in Markstream node renderers and add trusted custom tags") plus specific APIs (setCustomComponents, streamingComponents, htmlComponents) and override keys (image, code_block, mermaid, link) across five frameworks. Between anchor 3's 1-2 actions and anchor 5's comprehensive coverage, since cleanup/registry-removal and parser-level capabilities are not stated.

4 / 5

Completeness

Explicitly answers both: "what" in the first sentence (override built-in node renderers, add trusted custom tags across Vue, React, Solid, Svelte, and Angular) and "when" via a concrete trigger list ("Use when Codex needs scoped setCustomComponents ... or nested renderers for tags such as thinking"). The when-clause lists concrete trigger phrases, matching the anchor-5 example rather than anchor 4's more generic 'Use when working with PDF files.'

5 / 5

Trigger Term Quality

Triggers are the exact identifiers a user of this library would say ("scoped setCustomComponents", "node override keys such as image, code_block, mermaid, or link", "nested renderers for tags such as thinking") with good framework breadth. Not 5 because broader natural phrasings like "custom renderer" or "component override" are absent; not 3 because coverage far exceeds a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche with Markstream-specific APIs, framework names, and override keys, so it is unlikely to trigger for the wrong skill. Matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk'; nothing here is generic enough to overlap with sibling skills.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

Simon-He95/markstream-vue

Path

.agents/skills/markstream-custom-components/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.