Agent skill · design visual · ibelick
create-design-md
Create or update a DESIGN.md from an existing product repository or public website. Use when asked to document an interface's design language, reconstruct its visual system, extract design tokens and guidance from current evidence, or give coding agents persistent UI context. Do not modify product source or promote accidental implementation patterns into design decisions.
Why this skill is useful
Adds a structured approach to documenting design languages and visual systems that the AI wouldn't reliably generate on its own.
What it needs
About 9k tokens when loaded. Last updated 2026-08-03. 7,013 stars on the source repository.
What this skill does
Create DESIGN.md Create a DESIGN.md for one product or coherent website. Record the design language that governs it, not every value that happens to exist. Boundaries Modify only DESIGN.md. Do not change product source, dependencies, configuration, or generated files. Use the DESIGN.md format contract below. Do not invent a competing schema. Do not copy every discovered token or component into the document. Do not convert repetition, local styling, or visual preference into product intent. 1. Choose the mode Repository mode Use when a local product repository is available. Create or update DESIGN.md at the root of the selected product. If the repository contains multiple deployable products, select the one named by the user. If the request does not identify one and ownership is ambiguous, ask before writing. Repository evidence may establish normative values, token names, component ownership, and documented rationale. URL mode Use when the user provides a public URL without its source repository. Create a reconstructed DESIGN.md draft in the current workspace. URL mode requires rendered browser access. Inspect the DOM, computed styles, and publicly loaded stylesheets at desktop and mobile widths. Screenshots may support interpretation but cannot establish exact values by themselves. Inspect the supplied page and shared chrome. For a site-wide request, sample up to three same-origin pages that represent distinct templates. URL evidence may establish only observable visual patterns and computed values. It cannot establish internal token names, component ownership, undocumented rationale, or whether a pattern is intentionally canonical. If rendered inspection is unavailable, ask for screenshots or source files. Do not create a DESIGN.md from copy, metadata, or HTML structure alone. Choose repository mode whenever source is available. A supplied URL may verify rendered presentation but does not replace repository evidence. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ibelick/create-design-md