DESIGN.md is a single instruction file written for AI tools to read. It contains the full visual language of a template — colors, typography, spacing, surfaces, voice, do’s and don’ts, and example prompts. When you give it to an AI, the AI uses it as context for everything it generates afterward.
The exact way you feed it in depends on the tool, but the principle is the same everywhere: load DESIGN.md as context, then prompt as normal.
Claude is our favorite tool for this workflow because it handles long context well and supports several ways to load a Design System.
The simplest way — drop it into a chat:
Claude will use the colors, typography, spacing, and voice from the file in everything it generates after that point.
For repeated use — turn it into a Claude Skill:
If you’ll be working with the same Design System across many sessions, it’s worth turning it into a Skill so Claude can load it automatically.
From that point on, Claude will pull in the Design System whenever the Skill is triggered, without you having to attach the file every time.
Here’s a flow that works well: open a Claude chat, attach a Design System’s DESIGN.md, then attach a screenshot of any section from another website you like the layout of. Ask Claude something like: “Build a section with the same layout as the screenshot, but in the style of this design system.”
What you get back is a section that combines the layout you wanted with the colors, typography, spacing, and voice of the BYQ template. From there you can iterate, refine, and once you’re happy, take the HTML output into the Converter to bring it into Webflow.
We’ve used this exact flow with templates like Bobolobo and Harbor and the results match the template’s character closely on the first try.
ChatGPT works the same way as Claude for the basic flow. The most reliable approach is to use a Project:
If you don’t want a Project, you can also just attach DESIGN.md to a single chat — same effect, but only for that conversation.
The same principle applies to most AI builders and coding assistants:
Anywhere you can give an AI tool persistent context — a system prompt, a project file, a rules file, a custom instruction — DESIGN.md will work. The format is intentionally generic so it doesn’t depend on any one tool.
A few things that consistently improve output:
Once you have HTML you like, you have a few options:
The Design System makes the AI fluent in the template’s style. What you do with that fluency is up to you.