shadcn

Manage shadcn/ui component integration via the shadcn CLI with registry and configuration rules.

Updated May 17, 2026
One-click install
npx skills add https://github.com/ohdaveed/director-hearing-manager --skill shadcn-ohdaveed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shadcn
Source: https://github.com/ohdaveed/director-hearing-manager/tree/main/.agents/skills/shadcn
Command: npx skills add https://github.com/ohdaveed/director-hearing-manager --skill shadcn-ohdaveed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you correctly add, compose, and style shadcn/ui components without violating required layout, accessibility, or semantic styling rules.

Core Features & Use Cases

  • Adds and manages components via the shadcn CLI using project-aware configuration, preset handling, and registry-safe workflows.
  • Enforces UI correctness guardrails for spacing (gap-*), semantic colors, form composition, icon usage, and overlay/accessibility patterns.
  • Supports debugging and maintenance by guiding you to search registries, fetch docs/examples, preview diffs, and apply updates safely.

Quick Start

Use the shadcn skill to add a Dialog with the correct Title, icon buttons with data-icon, and compliant form/layout structure for your current preset and Tailwind setup.

Frequently Asked Questions about shadcn

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

FAQPage Schema
How do I add and configure shadcn/ui components using the CLI?

To add shadcn/ui components, run the shadcn CLI with your project package runner. The workflow manages integration by reading your components.json configuration and applying registry-safe presets to ensure accurate component installation.

What's the best way to compose shadcn/ui forms and dialogs without breaking accessibility?

The best way to compose shadcn/ui forms and dialogs is to follow strict UI guardrails. Enforce correct semantic colors, spacing, and icon usage rules to ensure your overlays and form components remain fully accessible and visually compliant.

Why does my shadcn/ui styling break when using custom Tailwind tokens?

shadcn/ui styling breaks when custom Tailwind tokens bypass semantic color rules. Maintain UI correctness by strictly using semantic tokens for colors and gap-* utilities for spacing, ensuring your components map correctly to your preset's design system.

Can I use the shadcn CLI to search registries and preview diffs before updating?

Yes, you can use the shadcn CLI to search registries and fetch documentation. It supports debugging and maintenance by allowing you to preview diffs and apply component updates safely within your current project context.

Do I need a specific Tailwind setup to use shadcn/ui components correctly?

You need a Tailwind setup configured with semantic tokens and a valid components.json file. shadcn/ui requires this project-aware configuration to properly map styles, enforce layout rules, and manage component composition through the CLI.

What are the limitations when integrating shadcn/ui component registries?

Limitations arise when bypassing the shadcn CLI or ignoring semantic token rules. Overlay patterns, icon data attributes, and form composition require strict adherence to preset configurations, meaning manual component additions often break accessibility and styling guardrails.