How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/plugin87/ux-ui-agent-skills --skill migrate-design-systemBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Skill: Migrate / Interop Design System
Step 0 — is the kit here? This skill reads files from the kit. Check once:ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSINGOnKIT_MISSINGonly the skill folders were installed, which is whatnpx skills adddoes. Say so plainly, point the user atnpx ux-ui-agent-skills initor the plugin install, and stop. Do not guess the contents of a file you could not open.
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.
- 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.
