laguagu/claude-code-nextjs-skills / skills/nextjs-shadcn
nextjs-shadcn
VerifiedBuilds distinctive Next.js interfaces with shadcn/ui, choosing typography, styling and purposeful visual effects for the product. Use when creating or polishing a Next.js + shadcn app, page or component, including themes, presets, backgrounds and design-system lint. Uses frontend-design for substantial visual direction, icons for asset sourcing and shadcn for component installation, registries and CLI details.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.9 KB |
| references/architecture.md | markdown | 3.3 KB |
| references/project-setup.md | markdown | 2.6 KB |
| references/shadcn-platform.md | markdown | 3.8 KB |
| references/sidebar.md | markdown | 2.2 KB |
| references/styling.md | markdown | 7.9 KB |
references/shadcn-platform.md
View on GitHub# shadcn utilities and design-system lint
Use the `shadcn` skill and [current CLI docs](https://ui.shadcn.com/docs/cli) for component management, presets and registries. This reference covers optional tools around the components.
## Project-aware APIs
Inspect the primitive base, aliases, theme and installed components through `components.json` and `shadcn info --json`. `shadcn docs <component>` resolves to the project's base.
`migrate radix` consolidates Radix package imports; it does not migrate components to Base UI.
Use the existing alias convention, including Node package imports when configured. Prefer logical spacing utilities for RTL-aware layouts.
To switch icon family across installed components, `shadcn migrate icons --from <id> --to <id>` takes the library ids `lucide`, `tabler`, `hugeicons`, `phosphor` and `remixicon`, plus the legacy `radix` (`@radix-ui/react-icons`), which works as a source or target but is not offered to new projects. Hugeicons now ships as `@hugeicons/react` with `@hugeicons/core-free-icons`; `hugeicons-react` is deprecated.
## Rendered markdown and loading
[Typeset](https://ui.shadcn.com/docs/typeset) provides owned CSS for rendered markdown, docs or streaming content. Generate `typeset.css` in its builder, import it after Tailwind and use the builder's `typeset`/preset wrapper classes; it is not installed by `init`. Use it when it fits the content rather than recreating a typography system for every message.
The `shimmer` and `scroll-fade` utilities come from `shadcn/tailwind.css` in projects that import it:
- `shimmer` can communicate an indeterminate text state.
- `scroll-fade` can soften a scroll container's content edges.
- `no-scrollbar` hides a scrollbar when that is appropriate for the interaction.
Check the actual stylesheet before using utilities in an older project. Keep loading feedback useful and scroll affordances discoverable.
## Design-system lint
[`@shadcn/lint`](https://github.com/shadcn-ui/lint) supports Tailwind v4 design systems through ESLint or Oxlint. It can find theme drift and suggest existing tokens, variants or sizes.
Use the existing UI linter. In a new project or one with recurring styling drift, consider adding the plugin; do not introduce it for every small UI edit.
For setup, read the current [SETUP.md](https://github.com/shadcn-ui/lint/blob/main/SETUP.md) and framework documentation. Register the plugin while preserving existing parsers, scripts, rules and ignores. Installing the plugin and enabling policies are separate choices; setup alone does not enforce a design system.
Choose policies for the actual project:
| Rule | Useful check |
|---|---|
| `no-restyle` | Component instances overriding the component's intended styling |
| `no-raw-colors` | Palette colors where semantic theme tokens should be used |
| `no-arbitrary-values` | Off-scale spacing or sizes |
| `no-inline-styles` | Styles outside the project's chosen styling conventions |
| `require-static-classes` | Dynamic classes the tooling cannot read |
| `no-unknown-classes` | Classes Tailwind cannot generate |
Use contracts and scoped exceptions where deliberate customization belongs: component source, custom patterns, dynamic geometry or media layers. A blanket ban on arbitrary values or inline styles can defeat a valid visual design. Resolve the intent before changing a policy.
Existing projects can adopt selected rules gradually instead of rewriting unrelated UI. Token suggestions are candidates, not semantic decisions: a nearby chart color may be wrong for muted body text.
Run the project's lint command and fix errors introduced by the change. Distinguish configuration errors, existing findings and new findings. Browser verification remains necessary; lint does not judge composition or whether a badge is useful.
Further configuration: [documentation](https://github.com/shadcn-ui/lint/tree/main/docs).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |