CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

baoyu-markdown-to-html

Converts Markdown to styled HTML with WeChat-compatible themes. Supports code highlighting, math, Mermaid (rendered to PNG via headless Chrome), PlantUML, footnotes, alerts, infographics, and optional bottom citations for external links. Use when user asks for "markdown to html", "convert md to html", "md 转 html", "微信外链转底部引用", or needs styled HTML output from markdown.

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

82%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 high-quality, execution-focused skill body: concrete commands, complete option documentation, and a clearly sequenced workflow with sensible safeguards (backup, fallback). The main improvement space is moving exhaustive lookup tables (colors, full output schema) into a reference file and trimming detail that inflates token cost.

Suggestions

Move the 13-row color-preset table and the full JSON output schema into a references/ file (e.g. references/options.md), keeping a few common examples inline in SKILL.md to cut token cost.

Add an explicit verification checkpoint after Step 2, e.g. confirm the JSON result's htmlPath exists and report non-empty output before declaring success.

Tighten the 'User Input Tools' section to the priority list plus one fallback sentence; the runtime-specific examples and batching detail repeat the same rule.

DimensionReasoningScore

Conciseness

The body is dense and table-driven (options, defaults, themes, color presets) with almost no conceptual explanation Claude already knows, but the 13-row color-preset table and the full JSON output schema are detail that could be trimmed or moved to a reference. Not 5 because not every token earns its place; not 3 because there is no real padding or over-explanation.

4 / 5

Actionability

Fully executable guidance: a concrete command template (`${BUN_X} {baseDir}/scripts/main.ts <markdown_file> --theme <theme> [--cite]`), three copy-paste-ready example invocations, a complete options table with defaults, and the exact JSON output shape. The ${BUN_X} variable is explicitly resolved ("bun if installed → else npx -y bun").

5 / 5

Workflow Clarity

A clear numbered sequence (Step 0 pre-check → Step 1 theme → Step 1.5 citation mode → Step 2 convert → Step 3 report) with first-match-wins decision rules, backup-before-overwrite, and a documented Mermaid render-failure fallback. Not 5 because there is no explicit post-conversion verification step, but this is not a destructive or batch operation, so the validation cap does not apply.

4 / 5

Progressive Disclosure

Well-sectioned body with a real, verified one-level-deep reference to `scripts/main.ts` (present in the bundle alongside main.test.ts, package.json, bun.lock) and no nested reference chains. Not 5 because all reference-worthy detail (color presets, full options, output schema) is inlined rather than split into reference files, though navigation remains easy via clear headers.

4 / 5

Total

17

/

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: comprehensive and concrete about capabilities, explicit about when to trigger, in third person, and clearly differentiated. The only gap is modest trigger-term coverage (no file extensions or a few missing synonyms).

DimensionReasoningScore

Specificity

The description lists many concrete capabilities — "Converts Markdown to styled HTML with WeChat-compatible themes", "code highlighting, math, Mermaid (rendered to PNG via headless Chrome), PlantUML, footnotes, alerts, infographics, and optional bottom citations" — giving comprehensive, specific coverage of what the skill does, in third person.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the detailed capability list, and the "when" is the explicit "Use when user asks for ..." clause with concrete trigger phrases. This matches the anchor-5 example structure directly.

5 / 5

Trigger Term Quality

Triggers include natural phrases users would say — "markdown to html", "convert md to html", "md 转 html", "微信外链转底部引用", "needs styled HTML output from markdown" — with good synonym and Chinese-variant coverage, but misses a few natural terms like file extensions (.md, .html) or "WeChat article". Anchor 5 requires comprehensive coverage including extensions, so 4 fits best.

4 / 5

Distinctiveness Conflict Risk

The niche (WeChat-compatible styled HTML from Markdown) is distinct and the triggers — including the Chinese "微信外链转底部引用" and "md 转 html" — are specific to this skill, minimizing overlap with generic markdown or HTML utilities.

5 / 5

Total

19

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

JimLiu/baoyu-skills

Path

skills/baoyu-markdown-to-html/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.