Create design.md

Given a source — live URL, codebase, or HTML snapshot — produce a design.md spec plus a references/[context]/NN-asset.{md,json} tree, such that another agent (or human) can reproduce the design's intent and concrete values from those files alone.

design.md is the headline artifact. The references/[context]/ tree is the evidence that backs every claim in design.md with a paired prose description and machine-readable JSON. Both ship together; one without the other is incomplete.

This skill follows the open DESIGN.md format published by Google Labs (frontmatter tokens + markdown body sections) and extends it with a per-asset references tree.

When to use this skill

• "Produce a design.md for this dashboard / URL / repo".
• "Generate a design.md and per-asset references for our marketing site".
• "Document the design system of this existing SaaS as a portable spec".
• "Extract this app's visual system into a file another agent can read".
• "Create a design.md from this HTML snapshot / Figma export / Tailwind codebase".
• "Hand off the design system so another team can match the look" — when the deliverable is a file, not buildable UI.

Do NOT use this skill when