Claude-skill-registry component-transformer
Orchestrates the migration of legacy MUI or generic components to the Northcote Curio design system. Specializes in "Refactor-on-Port" logic, ensuring visual transformation while preserving business state and behavioral integrity.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/component-transformer" ~/.claude/skills/majiayu000-claude-skill-registry-component-transformer && rm -rf "$T"
manifest:
skills/data/component-transformer/SKILL.mdsource content
Component Transformer Skill
Migration Steps
1. The Audit (Discovery)
Use the
token-orchestrator principles to scan the file for:
- ❌ Hardcoded colors (hex, rgb, rgba)
- ❌ Hardcoded spacing (padding, margin, gap in px)
- ❌ Hardcoded radii (4px, 8px, etc.)
- ❌ Generic fonts (Inter, Arial, System)
- ❌ Standard easing (ease-in-out)
2. The Context Selection
Determine if the component belongs in:
- Mode A (Gallery): For "Wonder" (Marketing, Profile Hero, Landing).
- Mode B (Laboratory): For "Rigor" (Parsing, Data, Settings, Editor).
3. The Transformation (Mapping)
Replace generic values with the Northcote Token Set:
- Colors: Map to
,primary-wattle
,tertiary-waratah
, etc.parchment - Typography: Inject the Federation Stack.
- Wrap primary headers in
.banksia-composition - Apply
for parametric weight (XTRA: 468).font-variation-settings
- Wrap primary headers in
- Physics: Replace linear transitions with
orease-viscous
.ease-settle - Morphology: Apply asymmetric border-radii (
, etc.).radius-pebble
4. Behavioral Preservation
Ensure no business logic, event handlers, or state management is lost or altered during the visual upgrade.
5. Verification
- Generate unit tests using
.jest-test-scaffolder - Create a Storybook story using
.storybook-scaffolder
Implementation Principles
- Anti-Slop: Reject any transformation that results in a "generic SaaS" look.
- Parametric: Engage variable font axes for interactive elements (e.g., GRAD hover).
- Layout-Safe: Prefer
overGRAD
for hover animations to prevent reflow.wght
Usage Example
"Transform Header.tsx to the Northcote Curio system. It should be in Gallery mode."