name: shadcn-management description: | Manage shadcn/ui components using MCP tools. Use when user needs to: (1) Add new shadcn components to a project (2) Build complex UI features requiring multiple components (3) Research component implementations and examples (4) Get component installation commands Triggers: "add shadcn", "shadcn component", "build UI with shadcn", "install component", "create form", "create dialog"

Shadcn Component Management

Prerequisites

Verify project setup:

shadcn___get_project_registries

If no components.json exists, instruct user: npx shadcn@latest init

Quick Add Workflow

For simple component additions (e.g., "add a date picker"):

1. Search - Find component in registry:

   shadcn___search_items_in_registries(registries, query)
   

2. View - Get implementation details:

   shadcn___view_items_in_registries(items: ["@shadcn/component-name"])
   

3. Examples - Get usage demo:

   shadcn___get_item_examples_from_registries(registries, query: "component-demo")
   

4. Install - Get add command:

   shadcn___get_add_command_for_items(items: ["@shadcn/component-name"])
   

5. Output - Provide installation command and example code

Complex Build Workflow

For multi-component features (e.g., "build a login form"), see references/workflows.md.

When to use Complex Build:

• Feature requires 3+ components
• Need component hierarchy planning
• Building complete sections (forms, dashboards, modals)

Component Naming Patterns

Common search queries:

• Forms: form, input, select, checkbox, radio-group
• Layout: card, dialog, sheet, drawer, tabs
• Feedback: alert, toast, skeleton, progress
• Navigation: button, dropdown-menu, navigation-menu

Example queries for demos: form-demo, card-with-form, dialog-demo

After Implementation

Always run audit:

shadcn___get_audit_checklist

Custom Styling & Theming

Shadcn provides structural foundation with default styling. For custom aesthetics:

Invoke frontend-design skill when:

• User wants unique/distinctive visual style beyond default shadcn theme
• Need custom typography, color schemes, or motion effects
• Building landing pages or marketing sites requiring creative design
• User mentions "custom styling", "unique design", "not generic"

Workflow:

1. Use shadcn-management for component structure and composition
2. Invoke frontend-design for visual customization:
   • Custom CSS variables in globals.css
   • Tailwind theme extensions in tailwind.config.js
   • Animation and micro-interaction enhancements
   • Typography and color refinements

Customization targets:

• @/app/globals.css - CSS variables, custom fonts
• tailwind.config.js - theme colors, fonts, animations
• Component-level className overrides