create-design-md

Creates DESIGN.md files documenting complete design systems in a 9-section markdown format.

5|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ItamarZand88/design-skills --skill create-design-md-itamarzand88
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-design-md
Source: https://github.com/ItamarZand88/design-skills/tree/main/.claude/skills/create-design-md
Command: npx skills add https://github.com/ItamarZand88/design-skills --skill create-design-md-itamarzand88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design teams and developers lack a standardized, AI-readable way to document a design system, making it hard for AI coding agents to generate UI that matches a brand's visual language. ## Core Features & Use Cases - Structured 9-Section Authoring: Guides creation of every required section, from color palettes and typography hierarchies to component specs, shadows, and responsive breakpoints. - Multiple Input Sources: Builds a DESIGN.md from a live website URL, existing CSS or Tailwind config, a from-scratch description, or a visual reference brand. - Quality Validation: Includes a completeness checklist ensuring hex values, font tables, component states, and guardrails are all present before output. - Use Case: A startup founder asks to document their app's visual language; the skill extracts tokens from their CSS and produces a complete DESIGN.md that any AI agent can use to generate on-brand UI. ## Quick Start Ask the AI to create a DESIGN.md for your website or app by providing a URL, existing CSS files, or a description of the design you want.

Frequently Asked Questions about create-design-md

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

FAQPage Schema
How do I create a DESIGN.md file for my website?▼

Provide the skill with your site's URL, existing CSS or Tailwind config, or a description of your design. It extracts colors, typography, and component specs, then writes a complete 9-section DESIGN.md to your project root.

What sections does a DESIGN.md file contain?▼

A DESIGN.md has 9 required sections: visual theme, color palette with hex values, typography rules with a hierarchy table, component stylings, layout principles, depth and elevation, do's and don'ts, responsive behavior, and an agent prompt guide.

Can I generate a design system from existing CSS or Tailwind config?▼

Yes, the skill accepts existing CSS files, Tailwind configs, theme objects, or design token files as input. It extracts the values and restructures them into the standardized DESIGN.md format.

What is the DESIGN.md format used for?▼

DESIGN.md is a markdown design system document optimized for LLM comprehension, originating from Google Stitch. Placing it in a project root lets AI coding agents generate UI that matches the documented brand's colors, typography, and components.

How do I contribute a new design to the awesome-design-md collection?▼

Create a directory under design-md/{lowercase-name}/ containing the DESIGN.md and a brief README.md, then update design-md/_index.md with the new entry and open a PR following the repository's CONTRIBUTING.md guidelines.