How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does shadcn support?

shadcn works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is shadcn free to use?

Yes. shadcn is free to install and use. It is available from the open explainx.ai skill registry published by pproenca.

Where can I read ratings and reviews for shadcn?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

How do I install shadcn?

Run `npx skills add https://github.com/pproenca/dot-skills --skill shadcn` in your terminal. You need to have run `npx skills init` once in your project first.

Productivity

shadcn▌

pproenca/dot-skills · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/pproenca/dot-skills --skill shadcn

0 commentsdiscussion

summary

58 community-maintained best practices for shadcn/ui component development, organized by priority and impact.

›Covers 10 rule categories spanning CLI setup, component architecture, accessibility, styling, forms, data display, layout, composition, performance, and state management
›Each rule includes specific guidance on Radix primitives, Tailwind styling, React Hook Form integration, and accessibility compliance
›Prioritized by impact: CRITICAL rules for setup and architecture, HIGH for

skill.md

shadcn/ui Community Best Practices

Comprehensive best practices guide for shadcn/ui applications, maintained by the shadcn/ui community. Contains 58 rules across 10 categories, prioritized by impact to guide automated refactoring and code generation.

When to Apply

Reference these guidelines when:

Installing and configuring shadcn/ui in a project
Writing new shadcn/ui components or composing primitives
Implementing forms with React Hook Form and Zod validation
Building data tables or handling large dataset displays
Customizing themes or adding dark mode support
Reviewing code for accessibility compliance

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	CLI & Project Setup	CRITICAL	`setup-`
2	Component Architecture	CRITICAL	`arch-`
3	Accessibility Preservation	CRITICAL	`ally-`
4	Styling & Theming	HIGH	`style-`
5	Form Patterns	HIGH	`form-`
6	Data Display	MEDIUM-HIGH	`data-`
7	Layout & Navigation	MEDIUM	`layout-`
8	Component Composition	MEDIUM	`comp-`
9	Performance Optimization	MEDIUM	`perf-`
10	State Management	LOW-MEDIUM	`state-`

Quick Reference

1. CLI & Project Setup (CRITICAL)

setup-components-json - Configure components.json before adding components
setup-path-aliases - Configure TypeScript path aliases to match components.json
setup-cn-utility - Create the cn utility before using components
setup-use-cli-not-copy - Use CLI to add components instead of copy-paste
setup-css-variables-theme - Enable CSS variables for consistent theming
setup-rsc-configuration - Set RSC flag based on framework support

2. Component Architecture (CRITICAL)

arch-use-asChild-for-custom-triggers - Use asChild prop for custom trigger elements
arch-preserve-radix-primitive-structure - Maintain Radix compound component hierarchy
arch-extend-variants-with-cva - Use Class Variance Authority for type-safe variants
arch-use-cn-for-class-merging - Use cn() utility for safe Tailwind class merging
arch-forward-refs-for-composable-components - Forward refs for form and focus integration
arch-isolate-component-variants - Separate base styles from variant-specific styles

3. Accessibility Preservation (CRITICAL)

ally-preserve-aria-attributes - Keep Radix ARIA attributes intact
ally-provide-sr-only-labels - Add screen reader labels for icon buttons
ally-maintain-focus-management - Preserve focus trapping in modals
ally-preserve-keyboard-navigation - Keep WAI-ARIA keyboard patterns
ally-ensure-color-contrast - Maintain WCAG color contrast ratios
ally-dialog-title-required - Always include DialogTitle for screen readers
ally-form-field-labels - Associate labels with form controls
ally-aria-invalid-errors - Use aria-invalid for form error states
ally-checkbox-label-association - Wrap Checkbox with Label for click target
ally-focus-visible-styles - Preserve focus visible styles for keyboard navigation

4. Styling & Theming (HIGH)

style-use-css-variables-for-theming - Use CSS variables for theme colors
style-avoid-important-overrides - Never use !important for style overrides
style-use-tailwind-theme-extend - Extend Tailwind theme for design tokens
style-consistent-spacing-scale - Use consistent Tailwind spacing scale
style-responsive-design-patterns - Apply mobile-first responsive design
style-dark-mode-support - Support dark mode with CSS variables

5. Form Patterns (HIGH)

form-use-react-hook-form-integration - Integrate with React Hook Form
form-use-zod-for-schema-validation - Use Zod for type-safe validation
form-show-validation-errors-correctly - Show errors at appropriate times
form-handle-async-validation - Debounce async validation calls
form-reset-form-state-correctly - Reset form state after submission

6. Data Display (MEDIUM-HIGH)

data-use-tanstack-table-for-complex-tables - Use TanStack Table for sorting/filtering
data-virtualize-large-lists - Virtualize lists with 100+ items
data-use-skeleton-loading-states - Use Skeleton for loading states
data-paginate-server-side - Paginate large datasets server-side
data-empty-states-with-guidance - Provide actionable empty states

7. Layout & Navigation (MEDIUM)

layout-sidebar-provider - Wrap layout with SidebarProvider
layout-sidebar-collapsible - Configure sidebar collapsible behavior
layout-sidebar-groups - Organize sidebar navigation with groups
layout-sheet-mobile-nav - Use Sheet for mobile navigation overlay
layout-breadcrumb-navigation - Implement breadcrumbs for deep navigation

8. Component Composition (MEDIUM)

comp-compose-with-compound-components - Use compound component patterns
comp-use-drawer-for-mobile-modals - Use Drawer on mobile devices
comp-combine-command-with-popover - Create searchable selects with Command
comp-nest-dialogs-correctly - Manage nested dialog focus correctly
comp-create-reusable-form-fields - Extract reusable form field components
comp-use-slot-pattern-for-flexibility - Use slot pattern for flexible content

9. Performance Optimization (MEDIUM)

perf-lazy-load-heavy-components - Lazy load components over 50KB
perf-memoize-expensive-renders - Memoize list items and expensive components
perf-optimize-icon-imports - Use direct imports for Lucide icons
perf-avoid-unnecessary-rerenders-in-forms - Isolate form field watching
perf-debounce-search-inputs - Debounce search and filter inputs

10. State Management (LOW-MEDIUM)

state-prefer-uncontrolled-for-simple-inputs - Use uncontrolled for simple forms
state-lift-state-to-appropriate-level - Lift state to lowest common ancestor
state-use-controlled-dialog-state - Control dialogs for programmatic access
state-colocate-state-with-components - Keep state close to where it's used

How to Use

Read individual reference files for detailed explanations and code examples:

Section definitions - Category structure and impact levels
Rule template - Template for adding new rules

Full Compiled Document

For a single-file reference containing all rules, see AGENTS.md.

Reference Files

File	Description
AGENTS.md	Complete compiled guide with all rules
references/_sections.md	Category definitions and ordering
assets/templates/_template.md	Template for new rules
metadata.json	Version and reference information

how to use shadcn

How to use shadcn on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your development machine
›Node.js version 16.0+ with npm package manager (verify with node --version)
›Active project directory or workspace where you want to add shadcn

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/pproenca/dot-skills --skill shadcn

The skills CLI fetches shadcn from GitHub repository pproenca/dot-skills and configures it for Cursor.

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ── always included ────

│ • Amp

│ • Antigravity

│ • Cline

│ • Codex

│ ●Cursor(selected)

│ • Cursor

│ • Windsurf

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/shadcn

Reload or restart Cursor to activate shadcn. Access the skill through slash commands (e.g., /shadcn) or your agent's skill management interface.

⚠

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

Additional Resources

›View source code on GitHub ›Skills CLI documentation ›Learn more about Cursor ›What are agent skills?

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases▌

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

✓

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

✓

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

✓

Make data-driven prioritization decisions faster

Stakeholder Communication

Draft PRDs, status updates, and stakeholder presentations

Example

Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement

✓

Save 3-5 hours/week on communication overhead

Implementation Guide▌

Prerequisites

›Claude Desktop or compatible AI client
›Access to product documentation and roadmap tools (Jira, Notion, etc.)
›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
›Stakeholder contact information and communication channels

Time Estimate

30-60 minutes to see productivity improvements

Installation Steps

1.Install product management skill
2.Start with user story generation for known feature
3.Progress to competitive analysis: research 2-3 competitors
4.Use for roadmap prioritization: apply RICE/ICE scoring
5.Draft stakeholder communications and refine based on feedback
6.Build template library for recurring PM tasks
7.Share effective prompts with product team

Common Pitfalls

⚠Not validating competitive research—verify facts before sharing
⚠Accepting user stories without involving engineering team
⚠Over-relying on frameworks without qualitative judgment
⚠Not customizing outputs to company culture and communication style
⚠Skipping stakeholder validation of generated requirements

Best Practices▌

✓ Do

+Validate research and competitive analysis with real data
+Collaborate with engineering when generating technical requirements
+Customize frameworks and templates to your company context
+Use skill for first drafts, refine with stakeholder input
+Document successful prompt patterns for PM tasks
+Combine AI efficiency with human judgment and intuition

✗ Don't

−Don't publish competitive analysis without fact-checking
−Don't finalize user stories without engineering review
−Don't make prioritization decisions solely on AI scoring
−Don't skip customer validation of generated requirements
−Don't ignore company-specific context and culture

💡 Pro Tips

★Provide context: company goals, constraints, customer feedback
★Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
★Use skill for 70% generation + 30% customization to company needs

When to Use This▌

✓ Use When

Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.

✗ Avoid When

Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.

Learning Path▌

1Basic: user stories, feature specs, status updates
2Intermediate: competitive analysis, prioritization frameworks, PRDs
3Advanced: product strategy, go-to-market planning, OKR setting
4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)

No comments yet — start the thread.

general reviews

Ratings

4.5★★★★★41 reviews

★★★★★Ganesh Mohane· Dec 20, 2024
shadcn fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
★★★★★Lucas Taylor· Dec 20, 2024
Registry listing for shadcn matched our evaluation — installs cleanly and behaves as described in the markdown.
★★★★★Omar Jackson· Dec 12, 2024
shadcn has been reliable in day-to-day use. Documentation quality is above average for community skills.
★★★★★Rahul Santra· Nov 11, 2024
shadcn is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
★★★★★Min Zhang· Nov 3, 2024
Useful defaults in shadcn — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
★★★★★Jin Gonzalez· Oct 22, 2024
I recommend shadcn for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
★★★★★Pratham Ware· Oct 2, 2024
Keeps context tight: shadcn is the kind of skill you can hand to a new teammate without a long onboarding doc.
★★★★★Xiao Patel· Sep 13, 2024
Keeps context tight: shadcn is the kind of skill you can hand to a new teammate without a long onboarding doc.
★★★★★Olivia Garcia· Sep 5, 2024
I recommend shadcn for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
★★★★★Diego Khanna· Sep 1, 2024
shadcn fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

showing 1-10 of 41

1 / 5