CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

render-html

Render an ARIS Markdown / JSON artifact (IDEA_REPORT, AUTO_REVIEW, KILL_ARGUMENT, PAPER_PLAN, research-wiki state, etc.) into a single-file HTML view designed for human reading. Use when the user says "渲染 HTML", "出一份 HTML 报告", "render html", "make this readable", "export to html", or wants a polished web-rendered view of a Markdown artifact.

Quality

85%

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

81%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 highly actionable and workflow-safe: executable resolver and commands, a complete reviewer prompt, and a validation gate with explicit FAIL/WARN/unavailable handling. The main weakness is token efficiency — routing boilerplate, the Phase-2 hook table, and time-sensitive promotional detail pad the file without adding operational value.

Suggestions

Move the mandated Codex reviewer prompt and the Phase-2 cost-tiered review-gate table into a referenced file (e.g. references/review-gate.md) and keep only the resolution rule and verdict handling inline, tightening the SKILL.md body.

Trim or delete the non-operational detail: the html-anything star count ("3000⭐ at time of writing"), the "activated 2026-05" dates, and the dense reviewer-routing preamble blockquote, which duplicates content already delegated to shared-references/reviewer-backends.md.

Replace the verbose two-phase integration narrative with a short summary line plus a pointer, keeping the per-skill RENDER_HTML toggle instructions as the only inline operational content.

DimensionReasoningScore

Conciseness

The operational core (resolver script, invocations, review prompt) is efficient and free of concept re-teaching, but padded stretches remain: the dense reviewer-routing preamble blockquote, the full Phase-2 hook table, the "html-anything … 3000⭐ at time of writing" promotion, and time-sensitive markers like "activated 2026-05" that are not confined to a deprecated/old-patterns section. It is above anchor 2 (the verbosity is domain policy, not explanation of things Claude already knows) but not the 'minor instances' of anchor 4.

3 / 5

Actionability

Everything needed to execute is present and copy-paste ready: the full $RENDER_HTML resolver bash chain, exact python3 invocations covering every flag (--template, --out, --state, --json, --offline, --lang, --review/--no-review), the complete mandated cross-model reviewer prompt with a strict JSON response schema, and explicit output/trace paths. Matches the anchor-5 'fully executable, common cases covered' example.

5 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced and gated by an explicit validation checkpoint (the HTML Review Gate) with feedback loops: FAIL → report blocking issues, fix source, re-render; WARN → deliver but surface warnings; REVIEW_UNAVAILABLE → never fabricate PASS. This is exactly the anchor-5 pattern of validation steps plus error-recovery loops.

5 / 5

Progressive Disclosure

Good structure: the helper and both templates are correctly split into real bundle files (scripts/render_html.py, scripts/templates/{academic,dashboard}.html, verified present), and routing/tracing detail is pushed one level deep to clearly signaled ../shared-references/*.md links. It falls short of anchor 5 because sizable operational blocks — the ~60-line reviewer prompt and the Phase-2 integration table — are inlined in SKILL.md where a reference file would keep the overview leaner.

4 / 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 description: it states a concrete capability over an enumerated artifact set and gives explicit, natural (bilingual) trigger phrases for when to invoke the skill. The only gap is that it describes a single render action rather than multiple concrete operations, which keeps specificity and trigger coverage just short of the top anchor.

DimensionReasoningScore

Specificity

Names the domain and a concrete action — "Render an ARIS Markdown / JSON artifact (IDEA_REPORT, AUTO_REVIEW, KILL_ARGUMENT, PAPER_PLAN, research-wiki state, etc.) into a single-file HTML view" — with an enumerated artifact list. It sits below anchor 5, which expects multiple distinct concrete actions (render plus transform operations), not one action over an enumerated input set.

4 / 5

Completeness

Explicitly answers both what ("Render an ARIS Markdown / JSON artifact … into a single-file HTML view designed for human reading") and when ("Use when the user says …" followed by concrete trigger phrases), matching the anchor-5 example's structure. Not 4 because the 'when' clause is fully explicit with quoted triggers rather than merely present.

5 / 5

Trigger Term Quality

Quoted natural triggers — "render html", "make this readable", "export to html", "polished web-rendered view" — plus two Chinese equivalents ("渲染 HTML", "出一份 HTML 报告"), giving good bilingual coverage. A few natural terms ("generate an HTML page", "HTML report", ".html") are missing, so it does not reach anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is tightly bounded (ARIS Markdown/JSON artifacts rendered to single-file HTML) with distinct trigger phrases, so overlap risk with generic document or PDF skills is minimal. Third-person voice is used; no person-penalty applies.

5 / 5

Total

18

/

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.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 missing, 2 suspicious

Warning

Total

13

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/render-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.