CtrlK
BlogDocsLog inGet started
Tessl Logo

article-magazine

Huashu / huashu-md-html-inspired magazine article layout for turning Markdown or notes into a polished long-form HTML essay.

60

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/article-magazine/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%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, well-ordered template spec: every line carries concrete styling values, structure follows page order, and there is no verbosity or misplaced content. The only weakness is a handful of decorative details left underspecified, which keeps actionability at 4 rather than 5.

DimensionReasoningScore

Conciseness

Every one of the ~10 lines is a concrete style instruction (text-5xl/6xl hero, ~700px column, specific Tailwind classes, serif headings, hr ornament) with zero padding or explanation of concepts Claude already knows. 'Lean and efficient; every token earns its place' is the exact match.

5 / 5

Actionability

Mostly concrete, executable guidance: actual Tailwind classes ('text-lg leading-relaxed text-neutral-700 dark:text-neutral-300'), a px width, serif/accent contrasts, and a language-label requirement. A few details stay loose ('小方块 / accent 圆点', '中央居中的小 ornament', '简单的行动卡片'), so it is 'mostly executable with minor gaps' rather than fully copy-paste ready — not 3, since no part is pseudocode-level vague.

4 / 5

Workflow Clarity

This is a simple single-purpose template skill (under 50 lines) whose one action — apply this layout spec to the user's content — is unambiguous, and the spec is presented in page order (hero → body → sections → footer CTA). Per the rubric's simple-skill exception, workflow clarity scores 5; no destructive or batch operations are involved so no validation cap applies.

5 / 5

Progressive Disclosure

The skill is a 10-line body with no bundle files (references/, scripts/, assets/ do not exist), so nothing needs offloading. Per the guideline that skills under 50 lines with no need for external references can score 5 with well-organized content, this compact labeled list qualifies — it is neither monolithic nor bloated with content that belongs in separate files.

5 / 5

Total

19

/

20

Passed

Description

50%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 communicates a clear and concrete single purpose but is held back by a missing 'when to use' clause and reliance on 'Huashu / huashu-md-html-inspired' jargon that users would never say as a trigger. It consistently lands at the middle anchor across all dimensions.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g. 'Use when the user wants to turn Markdown, notes, or drafts into a magazine-style long-form HTML article or blog page.'

Replace or demote the 'Huashu / huashu-md-html-inspired' jargon and add natural synonyms users would actually say: 'blog post', 'essay', 'newsletter', 'long-form article', '文章'.

Sharpen the capability list (e.g. mention hero metadata block, styled quotes/code blocks, and the share CTA card) so the description covers several concrete features rather than one transformation.

DimensionReasoningScore

Specificity

The description names the domain ('magazine article layout') and one concrete transformation ('turning Markdown or notes into a polished long-form HTML essay'), but offers no broader coverage of actions. It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' — not 4, which requires several specific listed actions, and not 2, since the single action stated is concrete rather than generic.

3 / 5

Completeness

The 'what' is clear — a magazine-article layout converting Markdown/notes into polished long-form HTML — but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the rubric guidelines. It is not 2 because the 'what' is specific, not vague.

3 / 5

Trigger Term Quality

Some relevant natural terms are present ('magazine article', 'Markdown', 'notes', 'HTML essay'), but the lead phrase 'Huashu / huashu-md-html-inspired' is jargon no user would say, and common variations like 'blog post', 'newsletter', 'long-form article', '文章', or file extensions (.md, .html) are missing. This fits 'some relevant keywords but missing common variations or synonyms' rather than 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The description is somewhat specific (a particular styled article template), but 'magazine article', 'essay', and 'Markdown to HTML' overlap heavily with other article/layout/blog template skills in the same family. 'Somewhat specific but could still overlap with similar skills' is the best fit — not 4, since overlap risk with closely related layout skills is real rather than minor.

3 / 5

Total

12

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
nexu-io/open-design
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.