You find a landing page with the perfect visual rhythm—the spacing is tight, the shadows are subtle, and the color palette just works. You want your AI agent to replicate that "vibe" for your next project. Usually, this involves a tedious hour of inspecting elements, copying hex codes into a text file, and trying to explain border-radius constants to Claude. It is a friction-filled workflow that kills momentum.
Most "site to code" tools try to do too much and fail by generating bloated, unreadable CSS. design-md chrome takes a different path. It doesn't write the code for you; it builds the blueprint so your AI can do the heavy lifting. I spent a week using this extension to see if it actually saves time or if it's just another piece of Github-dwelling shelfware.
What is design-md chrome?
design-md chrome is an open-source browser extension that extracts visual styles from websites to generate AI-ready DESIGN.md files—allowing developers to instantly port design systems into LLM tools like Claude Code or Google Stitch by using the standardized TypeUI format.
Built by Bergside, this tool targets a very specific niche: developers who use AI "agents" rather than just chat boxes. While other extensions focus on grabbing raw CSS, this one translates those styles into a structured markdown language called TypeUI. It captures typography, color tokens, spacing scales, and even motion guidelines, then packages them into a DESIGN.md or SKILL.md file that an LLM can parse as a set of strict instructions.
Hands-on Experience: Using design-md chrome in the Wild
Testing design-md chrome is a reality check for anyone used to polished, one-click SaaS products. This is a developer's tool through and through. When you fire it up on a complex site like Stripe or a modern SaaS dashboard, the extraction process is surprisingly fast. You aren't sitting there watching a progress bar; it scrapes the computed styles of the active tab and presents you with a structured preview almost instantly.
The Extraction Logic: Signals vs. Noise
The standout feature here is the "Extract Signals" action. Most scrapers give you a thousand lines of CSS variables. design-md chrome is opinionated—it looks for patterns. It identifies your primary, secondary, and accent colors, then maps them to tokens. When I tested it on a site with inconsistent button radiuses, the tool didn't just report the errors; it attempted to infer the intended design system. This makes the resulting markdown much more useful for an AI agent that needs to follow a "vibe" rather than copy pixel-perfect mistakes.
DESIGN.md vs. SKILL.md
The split between these two file types is where the tool shows its value for AI-driven development. The DESIGN.md output is a documentation file—great for humans and general context. But the SKILL.md output is formatted as an "agent-ready" skill. I fed a generated SKILL.md into Claude Code, and the difference in output was immediate. Instead of the AI guessing how to style a "modern button," it used the specific spacing and shadow tokens defined in the file. It turns the AI from a creative guesser into a disciplined implementer.
Where the Polish Fails
It isn't all smooth. Because it relies on computed styles, design-md chrome can struggle with sites that use heavy obfuscation or non-standard layout engines (like some older React-based heavyweights). I noticed that if a site uses complex SVG-based components for its UI, the extension often misses the "intent" of those styles. Also, the UI within the extension itself is utilitarian at best. You are looking at raw text and basic buttons. If you want a pretty dashboard to manage your design systems, you won't find it here. You are here to get the markdown and get out.
Getting Started with design-md chrome
Since this is an open-source project and not currently on the Chrome Web Store, you have to get your hands slightly dirty with the installation. It takes about 60 seconds if you know where to click.
- Navigate to the bergside/design-md-chrome repository on GitHub.
- Download the repository as a ZIP file and extract it to a folder on your machine.
- Open your Chrome browser and type
chrome://extensionsinto the address bar. - Toggle the Developer mode switch in the top right corner to "On."
- Click the Load unpacked button that appears.
- Select the folder where you extracted the repository.
Once installed, pin the extension to your toolbar. To use it, simply navigate to a site you admire, click the extension icon, and hit Extract Signals. You can then toggle between the DESIGN.md and SKILL.md views before clicking Save to download the files to your local environment.
Pricing Breakdown
The pricing model for design-md chrome is the best kind: it is completely free and open-source under the MIT License. There are no "Pro" tiers, no credit system for extractions, and no hidden subscriptions.
| Tier | Cost | Features |
|---|---|---|
| Open Source | $0 (Free) | Unlimited extractions, DESIGN.md/SKILL.md generation, full source code access. |
| Self-Hosted | $0 | You can fork the repo and modify the extraction logic for your specific AI workflow. |
While the tool itself is free, remember that you are essentially the "support team." If a site doesn't scrape correctly, your options are to fix the code yourself or open an issue on GitHub. For most developers, this is a fair trade for a tool that doesn't gatekeep its best features behind a $20/month paywall.
Strengths vs. Limitations
The value of design-md chrome lies in its utility for AI-first workflows. It trades the visual polish of commercial scrapers for the structural precision required by LLMs. While it excels at turning messy CSS into logic, the friction of its installation and bare-bones interface reminds you it is a community-driven project.
| Strengths | Limitations |
|---|---|
Generates AI-native SKILL.md files. |
Requires manual "Developer Mode" installation. |
| Privacy-first: runs entirely on your local machine. | Lack of visual UI for style management. |
| Zero cost with no subscription or credit limits. | Fails on canvas-based or heavily obfuscated sites. |
| Opinionated extraction reduces style noise. | No cloud storage or history for saved designs. |
Competitive Analysis
Most design tools focus on visual replication for designers using Figma. design-md chrome competes in a niche space between browser inspectors and AI prompt engineering, prioritizing structural logic over pixel-perfect visual cloning.
| Feature | design-md chrome | CSS Scan | HTML to Design |
|---|---|---|---|
| Output Format | Markdown (TypeUI) | Raw CSS | Figma Layers |
| AI Ready | Native Support | Manual Copying | No |
| Cost | Free (Open Source) | Paid ($) | Freemium |
| Privacy | Local Only | Local Only | Cloud Processing |
| Install | Manual (Unpacked) | Chrome Store | Figma Plugin |
| Best For | AI Agents/Devs | Frontend Devs | UI/UX Designers |
Pick design-md chrome if: You use Claude Code, Cursor, or specialized AI agents and need a design system they can actually understand. Pick CSS Scan if: You are a traditional developer who wants to copy-paste specific CSS snippets with a polished UI. Pick HTML to Design if: You are a designer who needs to pull a live website into Figma for a redesign.
FAQ
- Does this tool work with Tailwind CSS? Yes, it extracts the computed styles regardless of the CSS framework used by the target website.
- Is the extension safe to use? Since it is open-source and runs entirely locally on your machine, your browsing data and extracted styles are never sent to a third-party server.
- Can I export these styles directly to Figma? No, this tool is specifically designed to generate markdown documentation for AI agents rather than design files.
Verdict: 4.2/5 Stars
design-md chrome is a high-utility tool for a very specific user. If you are a developer integrating AI into your build process, this is an essential bridge between a visual "vibe" and a functional design system. It eliminates the manual labor of documenting tokens for your LLM.
Who should use it: Developers using "Agentic" AI tools who need to feed design context into their prompts.
Who should skip: Designers looking for visual assets or developers who aren't yet using AI for UI implementation.
Who should wait: Users uncomfortable with manual Chrome extension installation should wait for a potential Web Store release.
Try design-md chrome Yourself
The best way to evaluate any tool is to use it. design-md chrome is free and open source — no credit card required.
Get Started with design-md chrome →