design-systems-slds2-migrate

What problem does it solve?

This Skill removes the manual burden of migrating Lightning Web Components from SLDS 1 styling patterns to SLDS 2, especially when a repository contains linter warnings, deprecated design tokens, hardcoded CSS values, or SLDS class overrides.

Core Features & Use Cases

• Linter-guided migration: Runs through SLDS violation types and applies the correct fix strategy for each one.
• Hook selection with context: Chooses the right surface, container, accent, feedback, or non-color hook based on component structure and markup semantics.
• Markup and CSS updates: Renames overridden SLDS classes in CSS and updates the corresponding HTML classes without removing the original SLDS classes.
• Fallback-preserving replacements: Replaces deprecated tokens and hardcoded values while preserving the original value as a fallback for compatibility.
• Use case: A team upgrading an Aura or LWC component library can use this Skill to systematically clear SLDS 2 violations and validate the result with repeatable lint checks.

Quick Start

Ask this skill to migrate the selected Lightning Web Components to SLDS 2 and return the updated CSS and markup with valid styling hook fallbacks.