shadcn-turbo

Drop-in replacement for the official shadcn/ui skill.

Teaches your AI assistant the stuff the official skill doesn't cover: what actually breaks in production, and how to fix it. Installs in ~4 seconds (the official skill clones the entire shadcn/ui monorepo, which takes ~18s).

Install

npx skills add devinscodebase/shadcn-turbo --yes

What's in it

22 bug workarounds - Combobox-in-Dialog pointer events, toast z-index layering, Dialog-from-ContextMenu page freeze, Select breaking on numbers, Calendar timezone offset, Tabs losing state on switch, ThemeProvider hydration errors, nested anchor hydration, TooltipProvider silent failures, body scroll lock layout shift, and more. Every one fact-checked against the actual Radix/shadcn source and open GitHub issues.

6 mobile patterns - Dialog-to-Drawer responsive swap, Tabs horizontal scroll, DropdownMenu submenu flattening, Sidebar breakpoint override, DropdownMenu not closing after Link tap, Sidebar not closing after navigation.

5 Tailwind v4 fixes - border color default flip, OKLCH color migration, @layer base dark mode breakage, tailwindcss-animate to tw-animate-css swap, cn() stripping CSS variable classes.

Form and composition rules - everything from the official skill, plus corrections for FieldError vs FieldDescription, InputGroupAddon alignment, buttonVariants for links, and accurate Base vs Radix API differences.

Compatibility

Works with Claude Code, GitHub Copilot, Cursor, Windsurf, Gemini, OpenAI, and Factory. Multi-file platforms get SKILL.md + rule files. Single-file platforms get AGENTS.md with everything inline.

Files

skills/shadcn-turbo/
├── SKILL.md             # main skill (273 lines, loads fast)
├── AGENTS.md            # single-file version (everything inline)
├── rules/
│   ├── gotchas.md       # the 22 bugs
│   ├── mobile.md        # the 6 mobile patterns
│   ├── styling.md       # styling + tailwind v4 fixes
│   ├── forms.md         # form layout, validation
│   ├── composition.md   # component composition
│   ├── icons.md         # icon usage
│   └── base-vs-radix.md # API differences
├── cli.md               # shadcn CLI reference
├── customization.md     # theming guide
└── evals/evals.json     # 10 eval cases

License

MIT. Based on shadcn/ui by shadcn.