design2html

Generate a single-file HTML showcase from a design spec Markdown file.

30|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/s-choung/Research-Skills --skill design2html
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design2html
Source: https://github.com/s-choung/Research-Skills/tree/main/skills/design2html
Command: npx skills add https://github.com/s-choung/Research-Skills --skill design2html

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts a downloaded design spec Markdown file into a faithful single-file HTML showcase, removing the need to manually recreate tokens, typography, layout, and component examples.

Core Features & Use Cases

  • Spec-driven HTML generation: Reads a design system MD file and renders its color, typography, spacing, component, and surface guidance into a polished showcase page.
  • Strict compliance checks: Enforces spec rules such as token-based styling and the prohibition on left accent borders, then validates the output for consistency.
  • Single-file deliverable: Produces one self-contained HTML file suitable for sharing, reviewing, or benchmarking a design system.
  • Use Case: A designer downloads a refero.design spec and asks for a showcase page to present the system with real examples, swatches, and type scales.

Quick Start

Use the design2html skill on a spec Markdown file to generate a single-file HTML showcase that matches the design system exactly.

Frequently Asked Questions about design2html

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a design spec markdown file into an HTML showcase?

To convert a design spec markdown file into an HTML showcase, use a spec-driven generator to render tokens, typography, and components into a single-file webpage. This removes the need to manually recreate layout and color guidance for presentation.

Can I generate a single-file HTML webpage from design system tokens?

Yes, you can generate a single-file HTML webpage directly from design system tokens. The process reads token-based styling instructions and enforces compliance rules to produce a self-contained showcase file with swatches and type scales.

What is a design spec markdown file and when do I need an HTML showcase?

A design spec markdown file contains instructions for color, typography, spacing, and surfaces. You need an HTML showcase when you want to present a design system with real visual examples for review or benchmarking without manual coding.

Does design spec to HTML generation enforce strict token-based styling rules?

Yes, design spec to HTML generation enforces strict token-based styling rules. It validates the output for consistency and prohibits specific patterns like left accent borders to ensure the showcase matches the design system exactly.

What's the best way to visualize design system typography and surfaces for a review?

The best way to visualize design system typography and surfaces for a review is to generate a single-file HTML showcase. It automatically renders layout patterns and component examples from the spec markdown into a shareable webpage.

Are there limitations when generating a single-file HTML showcase from a markdown spec?

A limitation when generating a single-file HTML showcase is that it requires a valid spec markdown file with explicit design instructions. Without proper token definitions and layout guidance, it cannot enforce compliance or render the showcase accurately.