research-to-website

Build informative websites from research reports. Transforms research output (markdown or typst/pdf) into polished, domain-appropriate websites with professional design, data visualization, and scroll-based animations. Triggers on research-to-website tasks, report visualization, or when converting research into web presentations.

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./src/ii_agent/agents/skills/builtin/research-to-website/SKILL.md

Quality

Content

57%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, actionable instruction skill with clear domain classification and design guidance, held back by missing validation checkpoints in its build/deploy workflow, inlined content that would benefit from splitting into the referenced (but absent) bundle files, and some redundancy in the image section.

Suggestions

Add explicit validation checkpoints to the workflow (e.g. verify the build renders correctly and content-integrity rules are satisfied before Deploy), to lift workflow_clarity above 3.

Create the referenced bundle files (domains/{domain}.md, components/animations.md, typography.md, color-systems.md, visual-patterns.md) or remove the references, since progressive_disclosure is penalized when signaled references point to non-existent files.

Tighten the Image Strategy section — remove the duplicated "Use image search first..." line and condense the rationale paragraphs — to improve conciseness.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and it does not over-explain basics, but the Image Strategy section pads and even duplicates a line ("Use image search first for accuracy, realism, and credibility." appears twice) and could be tightened.	3 / 5
Actionability	Concrete, actionable guidance throughout — a domain table, classification questions, a YAML output example, a full design-spec template, and a named tech stack — with only minor gaps (no executable code snippets and references to bundle files that are not present).	4 / 5
Workflow Clarity	A clear 6-step sequence (Analyze → Load → Build → Deploy) exists, but there are no explicit validation/verification checkpoints before deploy; per the rubric, a build/deploy workflow lacking validation is capped at 3.	3 / 5
Progressive Disclosure	Structure is reasonable with a signaled "Required Reference Files" section, but the referenced files (domains/.md, components/.md) are not bundled and substantial guidance (Image Strategy, Brand Color, Anti-Patterns) is inlined that could live in separate files.	3 / 5
	Total	13 / 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, third-person description that clearly states capability and triggers with concrete, domain-specific language. Minor gains are possible by adding synonyms or file-format triggers, but it already answers both what and when well.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — "Transforms research output (markdown or typst/pdf) into polished, domain-appropriate websites with professional design, data visualization, and scroll-based animations" — but the overarching "Build informative websites" is broad, leaving minor coverage gaps (e.g. deployment).	4 / 5
Completeness	Explicitly answers both what (build/transform research into polished websites with design, viz, animations) and when via a concrete "Triggers on..." clause, matching the top anchor.	5 / 5
Trigger Term Quality	Natural trigger phrases are present — "research-to-website tasks, report visualization, or when converting research into web presentations" — giving good keyword coverage, though common synonyms and file extensions are absent.	4 / 5
Distinctiveness Conflict Risk	The "research-to-website" niche with triggers like report visualization and converting research into web presentations is distinct and unlikely to fire for unrelated skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: Intelligent-Internet/ii-agent
Path: src/ii_agent/agents/skills/builtin/research-to-website/SKILL.md
Commit: 28563d6

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.