shadcn

Enforces shadcn/ui composition, styling, and accessibility rules while managing component installs and updates.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/zooroy/appt-system --skill shadcn-zooroy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shadcn
Source: https://github.com/zooroy/appt-system/tree/main/.agents/skills/shadcn
Command: npx skills add https://github.com/zooroy/appt-system --skill shadcn-zooroy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

shadcn helps you reliably build, update, and compose shadcn/ui components without breaking the project’s established composition, styling, and accessibility conventions.

Core Features & Use Cases

  • Component discovery and docs: Search and open official component documentation and examples before implementing UI.
  • Safe installs, updates, and diffs: Add or update components using the shadcn CLI with dry-runs and file diffs to avoid unintended changes.
  • Correct usage guidance: Apply project-wide rules for form layout, spacing, semantic colors, icons, and composition patterns (e.g., FieldGroup/Field, ToggleGroup, Dialog titles, Badge/Skeleton/Separator).
  • Preset and theming workflows: Apply presets or switch themes while preserving or merging existing component customizations.
  • Project-context-aware advice: Uses injected components.json context (base vs radix, Tailwind version, icon library, aliases) to recommend correct APIs.

Quick Start

Use the shadcn skill to add or update a UI component by asking: "Install the shadcn/ui Button component and show me the exact file changes first."

Frequently Asked Questions about shadcn

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely install and update shadcn/ui components without breaking existing styling?

To safely install and update shadcn/ui components, use the shadcn CLI runner with dry-runs and file diffs to preview exact changes before applying them. This prevents unintended modifications to your project's established composition and styling conventions.

What is the best way to compose forms and UI elements using shadcn primitives in Next.js?

The best way to compose UI elements with shadcn primitives is by following project-wide rule files that enforce deterministic layout, semantic tokens, and correct structure for patterns like FieldGroup, ToggleGroup, and Dialog titles.

Can I apply theme presets to my shadcn components while keeping my current customizations?

Yes, you can apply theme presets to your shadcn components while preserving or merging existing customizations. The skill manages theming workflows that switch themes without overwriting your project's established component modifications.

Does the shadcn CLI work with different Tailwind versions and icon libraries?

The shadcn CLI works with different Tailwind versions, icon libraries, and base setups by reading your project's components.json context. It uses this injected configuration to recommend correct APIs and ensure compatibility.

How do I find official documentation and examples before adding a shadcn component?

To find official documentation and examples before adding a component, use the skill's component discovery feature to search and open official shadcn registry docs. This ensures you understand the target component's usage patterns before implementation.