What problem does it solve?
This Skill centralizes the workflows and best practices for adding, updating, fixing, and composing shadcn/ui components so developers avoid broken imports, styling regressions, and unsafe overwrites when integrating community components or changing presets.
Core Features & Use Cases
- Project-aware CLI guidance: Uses project context (package manager, aliases, base, tailwind version, isRSC) to select the correct package runner and file targets.
- Safe install and update workflows: Emphasizes dry-run, diff, and smart merge steps to preview changes, preserve local edits, and avoid manual fetches of raw upstream files.
- Composition and styling rules: Provides enforceable rules and examples for form composition, spacing, semantic tokens, icon usage, overlays, and accessibility (FieldGroup, no space-y-*, use cn(), data-invalid/aria-invalid, DialogTitle, AvatarFallback).
- Registry and preset management: Helps search registries, add items, resolve registry commands, and switch/merge presets with clear reinstall/merge/skip strategies.
- Use case: Add a component from a community registry, preview file diffs, correct aliased imports to match the project's resolvedPaths, and merge upstream changes while preserving local customizations.
Quick Start
Add a button component from the @shadcn registry and preview the exact file and CSS changes using the project's package runner with --dry-run and --diff.