mock-markup

Converts design mock images into verified HTML/CSS pages through a deterministic verify-markup loop.

22|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/mizchi/vlmkit --skill mock-markup-mizchi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mock-markup
Source: https://github.com/mizchi/vlmkit/tree/main/.apm/skills/vlmkit/workflows/mock-markup
Command: npx skills add https://github.com/mizchi/vlmkit --skill mock-markup-mizchi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an exported design image (Figma export, retina screenshot, competitor-site capture) into working HTML/CSS is error-prone: retina scale factors break pixel comparison, small text gets mistranscribed, and there is no reference page to calibrate against. This Skill normalizes the image, transcribes the mock's content, and drives a deterministic verification loop until the page matches. ## Core Features & Use Cases - Image normalization: vlmkit scan mock infers @2x/@3x device-pixel scale and writes a normalized @1x target, with degraded-capture tolerances for JPEG-history screenshots via --capture real. - Guided transcription: one-pass vision transcription of structure, sizes, colors, and exact copy, with a pixel-side check copy --target review that must be read by a second reader to catch transcription errors. - Deterministic verify loop: vlmkit verify markup runs to a DONE verdict (composition 0/0, height in tolerance), with strict rules for declaring design-tool rendering residuals and model-selection guidance (Sonnet vs Haiku) for the 1px endgame. - Use Case: Given a 2560px-wide Figma export of a landing page, normalize it, transcribe the copy, build the page, and iterate the verify loop until the rendered page matches the mock within tolerance. ## Quick Start Ask the agent to implement the page shown in mock.png as HTML/CSS and iterate with vlmkit verify markup until it reports DONE.

Frequently Asked Questions about mock-markup

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

FAQPage Schema
How do I turn a Figma export or screenshot into HTML/CSS?

Normalize the image with vlmkit scan mock to get a @1x target, transcribe its structure and copy once with your own vision, then iterate vlmkit verify markup against the normalized target until it prints DONE.

How do I handle @2x or @3x retina design exports for pixel comparison?

Run vlmkit scan mock on the raw export; it infers the device-pixel scale by matching common CSS viewport widths and writes a normalized @1x PNG. Always loop against the normalized file, never the raw retina export.

Does mock-to-markup conversion require a VLM API key?

No. The agent's own vision handles transcription, and the verify-markup loop is deterministic. An API key is only needed for the optional check copy --vlm second-reader review of transcription accuracy.

Why does a pixel-perfect page fail verification against a real screenshot?

JPEG compression smears small text, so sub-fragment composition and pixel-presence checks fail against degraded captures. Pass --capture real during intake so verify markup uses looser tolerances for screenshots with compression history.

Which model works best for mock-to-page implementation tasks?

Measured A/B results show Sonnet reaches DONE autonomously in about 9 rounds, while Haiku 4.5 stalls on the 1px-divider endgame at roughly one-sixth the cost. Use Sonnet for one-off pages and Haiku with escalation handoffs for batch work.