design-md-to-shadcn

Map DESIGN.md design tokens to shadcn CSS variables in theme files.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/douinc/agent-skills --skill design-md-to-shadcn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md-to-shadcn
Source: https://github.com/douinc/agent-skills/tree/main/skills/design-md-to-shadcn
Command: npx skills add https://github.com/douinc/agent-skills --skill design-md-to-shadcn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translates an external DESIGN.md (Google Labs design-token format) into shadcn/ui theme tokens, enabling teams to apply a design system consistently without editing code manually.

Core Features & Use Cases

  • Maps DESIGN.md front matter and prose into shadcn CSS variables within the project's theme file.
  • Follows the official token-mapping guidance (rules/token-mapping.md) to produce light/dark token sets and component guidance.
  • Intended for inbound-only design-system adoption; does not extract DESIGN.md from the target project.

Quick Start

Provide a DESIGN.md file path to apply its tokens to your shadcn theme.

Frequently Asked Questions about design-md-to-shadcn

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

FAQPage Schema
How do I map design tokens from a DESIGN.md file to shadcn UI CSS variables?

To map design tokens to shadcn UI, you provide a DESIGN.md file path. The Skill parses its front matter and prose, then translates the tokens into shadcn CSS variables within your project's theme file using official token-mapping guidance.

What is the DESIGN.md token format for applying a design system to shadcn?

The DESIGN.md token format is a Google Labs design-token structure used for inbound design-system adoption. It contains front matter and prose that can be parsed and mapped directly to shadcn UI theme tokens without manual code editing.

Do I need external tooling to convert DESIGN.md tokens into a shadcn theme?

No external tooling is required to convert DESIGN.md tokens into a shadcn theme. The transformation relies entirely on the file's front matter and built-in mapping guide rules to locate the theme CSS file and apply the token translations.

Can I extract a DESIGN.md file from my existing shadcn project?

No, you cannot extract a DESIGN.md file from an existing shadcn project. This workflow is intended for inbound-only design-system adoption, meaning it applies an external DESIGN.md to your theme rather than generating one from your current codebase.

How does the token mapping handle light and dark mode CSS variables for shadcn?

Token mapping handles light and dark mode by translating DESIGN.md tokens into distinct :root and .dark blocks within the shadcn theme CSS file. This ensures the design system is applied consistently across both theme variants.