create-design-md

Create or update a DESIGN.md documenting a product's design language from repository or URL evidence.

1|Updated Aug 31, 2026
One-click install
npx skills add https://github.com/gagandeepgill/puzzle-game --skill create-design-md-gagandeepgill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-design-md
Source: https://github.com/gagandeepgill/puzzle-game/tree/main/.claude/skills/create-design-md
Command: npx skills add https://github.com/gagandeepgill/puzzle-game --skill create-design-md-gagandeepgill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @google/design.md.

What problem does it solve? Design knowledge in a product is scattered across tokens, stylesheets, and components, leaving coding agents and contributors without a single source of truth for the interface's visual system. This Skill reconstructs that system into a validated DESIGN.md without touching product source code. ## Core Features & Use Cases - Dual evidence modes: Repository mode audits tokens, themes, and shared primitives from source; URL mode reconstructs design systems from rendered pages, computed styles, and loaded stylesheets. - Schema-gated output: Normalizes evidence into a strict frontmatter schema (colors, typography, rounded, spacing, components) with export targets for Tailwind v3/v4 and DTCG. - Validation pipeline: Runs npx @google/design.md lint, export, and diff checks before reporting, rejecting invalid token shapes and unsupported claims. - Use Case: Point it at a React/Tailwind repository to generate a DESIGN.md capturing semantic color tokens, typography scales, and component rules so coding agents produce on-brand UI. ## Quick Start Create a DESIGN.md for this repository that documents its design tokens, typography, and component rules.

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 for an existing repository?▼

Run the Skill in repository mode against the product root. It audits existing guidance, tokens, themes, shared primitives, and representative routes, then writes a validated DESIGN.md without modifying any product source files.

How to document a website's design system without source code?▼

Use URL mode with a public URL. The Skill inspects rendered DOM, computed styles, and loaded stylesheets at desktop and mobile widths, promoting only values confirmed by both computed output and CSS declarations into a reconstructed draft DESIGN.md.

Does DESIGN.md support Tailwind CSS export?▼

Yes. The Skill selects css-tailwind for Tailwind v4 and json-tailwind for Tailwind v3, then verifies the export emits expected families such as --color-*, --font-*, --text-*, --radius-*, and --spacing-* before reporting success.

Can it handle light and dark theme tokens?▼

It checks the installed specification with npx @google/design.md spec. If themes and default-theme are supported it uses theme-aware syntax; otherwise it records default values in canonical tokens and preserves alternates in a Themes table.

What are the limitations of URL-mode reconstruction?▼

URL mode cannot establish internal token names, component ownership, or design rationale. It only records observable computed values that recur across sampled pages, labels the output as a reconstructed draft, and omits anything failing its three-proof evidence gate.