Migrate Design System

This is the bridge you need when you're adopting Material 3, migrating from Chakra to shadcn/ui, or trying to theme Radix primitives with your own tokens. It walks through a six-axis crosswalk (color roles, type scale, spacing, radius, elevation, motion) using curated mappings for the major systems or deriving one on the fly for others. The three directions are useful: map an external system into your tokens to adopt their look, theme their components with your primitives, or build a bridge layer for a full migration. The contrast verification step against all eight states plus dark mode is the kind of detail that saves you from shipping inaccessible color pairs. Outputs a crosswalk table and verified token overrides ready to wire up.

skills.sh installs: 531
GitHub stars: 3.1K
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add plugin87/ux-ui-agent-skills --skill migrate-design-system --agent claude-code

Installs into .claude/skills of the current project.

Files

Skill: Migrate / Interop Design System

Requirements

This skill needs the full UX/UI Agent Skills kit: the gates, the references and the design-system library. Install it with npx ux-ui-agent-skills@3.1.0 init or as the Claude Code plugin. npx skills@1.7.6 add copies the skill folder and nothing else. Installed that way, this skill runs in guidance-only mode: no gate runs, so it gives no verdict.

Step 0: is the kit here? Check once: ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING On KIT_MISSING, open your reply with: "Guidance-only mode: the UX/UI Agent Skills kit is not installed here, so no gate ran and nothing below is measured." Then work from this file and general practice, under three rules. Do not guess or cite the contents of a kit file you could not open. State no measured number (no contrast ratio, no N/N, no "passes WCAG"): write "not verified" where one would go. End with a line Skipped (kit not installed): that names every gate script this file tells you to run, then the install command above.

Bridge to or from external design systems via a role-based crosswalk.

SKILL.md on GitHub