migrate-design-system
Map this token system to or from any external design system (Material Design 3, Apple HIG, Fluent, Carbon, Ant, shadcn/ui, Radix, Chakra, Mantine, Bootstrap…). Adopt their look, build on their stack, or migrate between systems. Use when the user mentions interop, migration, or a specific design-system/component-library bridge.
How do I install this agent skill?
npx skills add https://github.com/plugin87/ux-ui-agent-skills --skill migrate-design-systemIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates design system migration by mapping tokens between different component libraries. It uses standard environment checks and package management for initialization, and local Python scripts for accessibility validation. All operations are consistent with its stated purpose.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
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.1 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_MISSINGOnKIT_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 lineSkipped (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.
Steps
- Read
${CLAUDE_SKILL_DIR}/../../../design-systems/interop-protocol.md(Crosswalk Method, the three directions, headless-vs-styled guidance, verification). - Use the curated tables in
${CLAUDE_SKILL_DIR}/../../../design-systems/crosswalk.mdfor Material 3 / Apple HIG / Fluent 2 / Carbon / shadcn/ui / Radix. For others, derive a mapping with the Crosswalk Method (map by role/intent across 6 axes: color roles, type scale, spacing unit, radius, elevation, motion). - Choose the direction:
- FROM external → our tokens (adopt their look): re-point
semantic.*. - TO external stack (our components on their foundation): theme their primitives with our tokens.
- Migrate: Audit → Map → Bridge (alias layer) → Verify, screen by screen.
- FROM external → our tokens (adopt their look): re-point
- Verify every mapped color pair for contrast (
${CLAUDE_SKILL_DIR}/../../../scripts/contrast.py/a11y-audit); confirm all 8 states + dark mode survive the mapping.
Output
A crosswalk table (our token → their token → value note), a bridge plan if migrating, and verified token overrides. Render via design-code.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/plugin87/ux-ui-agent-skills/migrate-design-system">View migrate-design-system on skillZs</a>