This is the most comprehensive shadcn/ui reference I've seen, with 58 community-maintained rules organized by actual priority impact. It covers everything from CLI setup gotchas to accessibility preservation to form patterns with React Hook Form and Zod. What makes it useful is the structure: rules are prefixed by category (setup-, arch-, ally-) and prioritized from critical to low-medium, so you know what matters when reviewing code or scaffolding new components. The accessibility section alone is worth it, calling out things like required DialogTitles and proper aria-invalid usage. If you're building anything non-trivial with shadcn/ui, especially data tables or complex forms, this beats hunting through GitHub issues.

skills.sh installs
732
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill shadcn --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
Frontend Development, Documentation, Code Review & Quality, Debugging, Design & UI/UX
First seen
May 16, 2026

More from pproenca/dot-skills

All 100
1bbeierle12 avatargsap-reactbbeierle12/skill-mcp-claudeGSAP integration with React including useGSAP hook, ref handling, cleanup patterns, and context management. Use when implementing GSAP animations in React compo727skills.sh installs
2storybookjs avatarwriting-react-native-storybook-storiesstorybookjs/react-nativeCreate and edit React Native Storybook stories using Component Story Format (CSF). Use when writing .stories.tsx files, adding stories to React Native component715skills.sh installs
3binjuhor avatarfrontend-design-probinjuhor/shadcn-larCreates jaw-dropping, production-ready frontend interfaces AND delivers perfectly matched real photos (Unsplash/Pexels direct links) OR flawless custom image-ge708skills.sh installs
4syncfusion avatarsyncfusion-react-data-managersyncfusion/react-ui-components-skillsImplements Syncfusion DataManager for local/remote binding, CRUD, querying, caching, and middleware. Supports JsonAdaptor, ODataAdaptor, ODataV4Adaptor, UrlAdap702skills.sh installs
5syncfusion avatarsyncfusion-react-buttonssyncfusion/react-ui-components-skillsComprehensive guide for implementing Syncfusion React button components including Button, ButtonGroup, DropDownButton, Floating Action Button, ProgressButton, S701skills.sh installs
6syncfusion avatarsyncfusion-react-inputssyncfusion/react-ui-components-skillsComprehensive guide for implementing Syncfusion React input components including Uploader, NumericTextBox, TextBox, TextArea, CheckBox, OTP Input, Signature, Ra697skills.sh installs