CtrlK
BlogDocsLog inGet started
Tessl Logo

md2wechat

Convert Markdown to WeChat Official Account HTML, inspect supported providers/themes/prompts, generate article images, create drafts, write with creator styles, prepare title suggestions, and remove AI writing traces.

66

Quality

81%

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

88%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.

The body is a tight, decision-oriented protocol: executable commands with exact JSON flags, sequenced workflows with validation gates and feedback loops, and well-headed sections that keep it navigable. It would move from strong to excellent by tightening a few long compound sentences and optionally offloading the command catalog to a reference file.

DimensionReasoningScore

Conciseness

The body is dense and decision-focused — e.g. "Treat `convert --draft` and `create_image_post` as different publish targets, not interchangeable variants" — with almost no padding or explanation of concepts Claude already knows. A few long compound sentences (the multi-clause `inspect`/`preview`/`convert` paragraph in the Article Workflow section) could be trimmed, so it sits at score 4 ('efficient; minor instances that could be trimmed') rather than the fully lean score 5.

4 / 5

Actionability

It provides copy-paste-ready, executable commands throughout — "md2wechat themes list --json", "md2wechat inspect <article.md> --json", "md2wechat layout validate --file <formatted.md> --json" — covering the common cases with exact flags and JSON output. This matches the score-5 anchor ('fully executable; copy-paste ready commands; specific examples cover common cases') and exceeds score 4.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints and feedback loops, e.g. the Article Workflow confirm-first steps, the Formatting Protocol (validate → pass to convert), and Failure Handling ("run `layout validate`, inspect the failing module with `layout show`, fix the generated artifact, then validate again"). Destructive/publish side effects gate on `inspect --json` readiness and explicit user confirmation, matching the score-5 anchor with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

Content is well-organized into clearly headed sections (Intent Routing, Discovery First, Configuration Boundaries, Article Workflow, etc.) and stays one level deep — it points to the embedded CLI SOP via `md2wechat skills read md2wechat --json` and to project docs rather than nesting files. No references/ scripts/ assets/ bundle exists, so most detail lives inline; this is mostly well-placed but slightly inlined where a reference file could carry the command catalog, fitting score 4 ('good structure; most content appropriately placed; minor gaps') over the ideal split of score 5.

4 / 5

Total

18

/

20

Passed

Description

75%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.

The description is specific and distinct, enumerating many concrete md2wechat capabilities, but it lacks any explicit 'Use when...' trigger guidance, so completeness is capped at 3. Adding a concrete trigger clause (e.g. 'Use when converting Markdown to WeChat posts, creating drafts, or generating article images/titles') would lift completeness and trigger-term quality.

Suggestions

Add an explicit 'Use when...' clause naming the situations that should trigger this skill (e.g. 'Use when converting Markdown to WeChat Official Account posts, creating WeChat drafts, or generating article covers/images and title suggestions').

Include common synonyms and file extensions users actually say (e.g. .md, WeChat公众号 / Official Account post) to broaden trigger-term coverage.

Consider reordering so the primary trigger ('convert Markdown to WeChat HTML') leads, followed by the supporting capabilities, to sharpen the 'when' signal.

DimensionReasoningScore

Specificity

The description lists many concrete actions — "Convert Markdown to WeChat Official Account HTML, inspect supported providers/themes/prompts, generate article images, create drafts, write with creator styles, prepare title suggestions, and remove AI writing traces" — giving comprehensive coverage of the tool's capabilities. It is not above 5 (the top anchor) and clearly exceeds the score-4 anchor's 'several specific actions; minor gaps' by spanning convert, inspect, image generation, drafts, styling, titles, and humanizing.

5 / 5

Completeness

The 'what' is clearly stated (convert, inspect, generate images, create drafts, write styles, titles, humanize) but there is no 'when'/Use-when trigger clause at all. Per the rubric, a missing 'Use when...' clause or equivalent explicit trigger guidance should cap completeness at 3, which it does; it is not score 4 because that requires an explicit 'when'.

3 / 5

Trigger Term Quality

Natural user-facing terms appear — "Markdown", "WeChat", "article images", "drafts", "title suggestions" — but it omits common synonyms/extensions (e.g. .md, 公众号, WeChat Official Account post) and leans slightly technical in places like "inspect supported providers/themes/prompts". It fits the score-4 anchor ('good keyword coverage; a few natural terms missing') better than score 3 (only some relevant keywords) or score 5 (comprehensive synonyms and extensions).

4 / 5

Distinctiveness Conflict Risk

The narrow niche — WeChat Official Account HTML, drafts, and md2wechat-specific operations — has distinct triggers and minimal conflict risk with generic markdown or HTML skills. It matches the score-5 anchor ('clear niche with distinct triggers; minimal conflict risk') and is clearly above score 4 (mostly distinct, minor overlap).

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation13 / 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

Total

13

/

16

Passed

Repository
geekjourneyx/md2wechat-skill
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.