Guide · shadcn-vue

shadcn-vue Skills for Claude Code: Official Skill, Reka UI and Nuxt

The official shadcn-vue skill from the unovue/shadcn-vue repo is the first one to install for shadcn-vue work in Claude Code. It has 6,381 installs, runs the shadcn-vue CLI with your project's own config and enforces 31 component rules. Add reka-ui (7,577 installs) for the headless primitives underneath.

By Skillselion, an Ellelion LLC publication · Updated November 12, 2026 · 4 min read · Stats verified against the live catalog

A coding agent that learned shadcn/ui from React examples can carry React habits into a Vue project. The official shadcn-vue skill (6,381 installs, 10,840 GitHub stars) gives Claude Code, Codex and Cursor the real shadcn-vue CLI and your project's own config before it writes a single component.

Key takeaways

  • The official shadcn-vue skill has 6,381 installs and its repo has 10,840 stars (skills.sh registry, GitHub). It injects the output of npx shadcn-vue@latest info --json so the agent sees your framework, Tailwind version and aliases.
  • It enforces 31 critical rules in 6 groups: 7 for styling, 7 for forms, 6 for component structure, 7 for using components over custom markup, 3 for icons and 1 for the CLI.
  • The CLI ships an MCP server with 7 tools, and mcp init --client claude writes the .mcp.json entry for Claude Code.
  • shadcn-vue has one base, Reka UI. The reka-ui skill (7,577 installs) documents those primitives.
  • React projects need a different skill. The best shadcn/ui skills guide covers the React side.

What is the best shadcn-vue skill for Claude Code?

The official shadcn-vue skill from unovue/shadcn-vue is the best starting point, with 6,381 installs and 10,840 GitHub stars (skills.sh registry, GitHub). It is maintained in the same repo as the component library, so its rules track the current CLI. Install it with one command:

npx skills add https://github.com/unovue/shadcn-vue --skill shadcn-vue

unovue organization avatar on GitHub
unovue organization avatar on GitHub

Community options exist too. A shadcn-vue skill by noartem has 909 installs, and the reka-ui skill from onmax/nuxt-skills has 7,577 installs. For the wider Vue stack, see the best Vue 3 and Nuxt skills and the best frontend design skills page.

What rules does the shadcn-vue skill enforce?

It enforces 31 critical rules, each linked to a file of incorrect and correct code pairs. The 7 styling rules tell the agent to use semantic tokens such as bg-primary, to space items with flex and gap-*, and to leave z-index alone on overlay components. The 7 form rules require FieldGroup and Field for layout, ToggleGroup for option sets of 2 to 7 choices, and a form library such as vee-validate or TanStack Form for state. The skill also marks the old Form and FormField components as legacy. Structure rules cover accessibility: every Dialog, Sheet and Drawer needs a title, and every Avatar needs an AvatarFallback. The skill has 6,381 installs (skills.sh registry).

How does the skill use the shadcn-vue CLI and MCP server?

It runs the CLI through your project's package runner and follows a 9-step workflow. The CLI reference lists 10 commands: init, apply, add, search, view, docs, diff, info, migrate and build. Before it writes or fixes a component, the agent runs npx shadcn-vue@latest docs <component> and fetches the documentation URL it returns. Updates go through diff, and the skill forbids --overwrite without your explicit approval. The MCP server adds 7 tools for registry search, item views, examples and an audit checklist. In Claude Code the tools appear under the mcp__shadcnVue__ prefix. The shadcn-vue documentation covers each command in full, and the skill itself counts 6,381 installs (skills.sh registry).

Which skills cover Reka UI and Nuxt UI?

The reka-ui skill covers the primitives and the nuxt-ui skill covers the Nuxt component library. Reka UI was formerly Radix Vue, and its skill (7,577 installs) explains component APIs, asChild composition and controlled state. The official Nuxt UI skill has 20,581 installs and 7,097 stars, and describes 125 accessible Vue components with Tailwind theming. Nuxt UI and shadcn-vue both build on Reka UI, so the reka-ui skill helps with either one. Reka UI's own docs are the primary source for primitive behaviour. The vue-best-practices skill (46,325 installs) handles general Vue 3 patterns.

How is shadcn-vue different from the React shadcn skill?

The two skills share a design but target different frameworks and CLIs. The React shadcn skill has 271,099 installs and drives npx shadcn@latest. The Vue skill has 6,381 installs and drives npx shadcn-vue@latest. Vue-specific details differ: toasts come from vue-sonner, charts wrap Unovis, icons import from packages such as @lucide/vue, and templates exist for Nuxt, Vite, Astro and Laravel. The Vue skill names 7 presets: nova, vega, maia, lyra, mira, luma and sera. The shadcn/ui hub lists skills for both frameworks.

A complete starter stack

  • shadcn-vue (6,381 installs): CLI workflow, project context and the 31 rules.
  • reka-ui (7,577 installs): the headless primitives every shadcn-vue component wraps.
  • vue-best-practices (46,325 installs): Vue 3 patterns outside the component layer.
  • nuxt-ui (20,581 installs): add it only when the project uses Nuxt UI.

Common pitfalls

  • Installing the React shadcn skill in a Vue repo. Its commands call npx shadcn@latest, which targets React projects.
  • Asking the agent to "add a login block" with no registry named. The skill tells the agent to ask which registry to use and never to guess.
  • Passing --dry-run, --diff or --view to add. The skill states these flags are unsupported in shadcn-vue and exit with code 1, so use the diff command.

Start with the official skill, then browse the full frontend design category for the rest of your UI stack.

FAQ

Common questions

What is the shadcn-vue skill for Claude Code?

It is the official agent skill from the unovue/shadcn-vue repo, with 6,381 installs. It runs the shadcn-vue CLI with your project context and enforces 31 component rules. See the shadcn-vue skill.

How do I install the shadcn-vue skill?

Run npx skills add https://github.com/unovue/shadcn-vue --skill shadcn-vue in your project. The skill has 6,381 installs and its repo has 10,840 GitHub stars. Compare options on the best frontend design skills page.

Does shadcn-vue have an MCP server?

Yes. The shadcn-vue CLI includes an MCP server with 7 tools, and npx shadcn-vue@latest mcp init --client claude writes the Claude Code config. The skill that documents it has 6,381 installs. See the shadcn/ui hub.

Do I need a Reka UI skill with shadcn-vue?

It helps, because Reka UI is the only base shadcn-vue supports. The reka-ui skill has 7,577 installs and covers the primitive APIs. See the reka-ui skill.

Can I use the React shadcn skill in a Vue project?

No. The React shadcn skill (271,099 installs) drives a different CLI. Use the shadcn-vue skill (6,381 installs) for Vue and Nuxt. See the best Vue 3 and Nuxt skills.

Ranked by Skillselion - an independent directory of AI-coding tools, not affiliated with Anthropic, OpenAI or Cursor. Tool rankings reflect real adoption (installs, then GitHub stars) from the skills.sh registry and GitHub, last updated November 12, 2026.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.