К основному содержанию
скилл CX Codex

shadcn-vue-skilld — скилл для Claude Code и Cursor

Скилл shadcn-vue-skilld для Claude Code, Codex, Cursor и других агентов, покрывающий CLI shadcn-vue 2.8.2 для Vue и Nuxt. Знает точные флаги всех команд — от init до mcp, конфигурацию components.json и правила разрешения имён компонентов.

MIT 174 установок ★ 186 обновлён 2026-10-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a claude-code
Открыть на GitHub

Что делает shadcn-vue-skilld

Агент получает полную карту команд: init, add, apply, view, search, docs, info, diff, migrate, build, mcp init — с флагами и ключами конфигурации для версии 2.8.2.

Внутри — правила, которые предотвращают типичные ошибки: пресеты в 2.8.x называются без префикса (vega, а не reka-vega), toast и toaster устарели в пользу sonner, а текущий пакет иконок — @lucide/vue вместо lucide-vue-next. Скилл охватывает порядок разрешения имён (URL → файл → @namespace → owner/repo → plain), переменные окружения SHADCN_VUE_URL и REGISTRY_URL для локального реестра, схему components.json и программный API из семи точек входа.

Компоненты копируются в components/ui/** — вы владеете исходниками. Перед apply <preset> нужен коммит: CLI переписывает компоненты, шрифты и CSS-переменные без возможности отката средствами самого инструмента.

Какие задачи решает

  • добавить компоненты shadcn-vue в проект Vue или Nuxt без ручного поиска флагов
  • применить пресет (vega, nova, lyra и другие) к существующему проекту
  • перейти с устаревшего lucide-vue-next на @lucide/vue командой migrate icons
  • настроить сторонний реестр компонентов через components.json
  • запустить MCP-сервер shadcn-vue и подключить его к клиенту

Примеры запросов агенту

  • Инициализируй shadcn-vue в этом проекте с пресетом nova и шрифтом Inter
  • Добавь компоненты dialog, card и button — сначала покажи --dry-run
  • Мигрируй иконки с lucide-vue-next на @lucide/vue командой migrate icons

Как установить shadcn-vue-skilld

1Через Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a claude-code

2Вручную: положить файлы

~/.claude/skills/shadcn-vue-skilld/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/shadcn-vue-skilld/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о shadcn-vue-skilld

Как установить shadcn-vue-skilld в Claude Code?

Выполните команду npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a claude-code. Скилл появится по пути ~/.claude/skills/shadcn-vue-skilld/SKILL.md.

Что делает скилл shadcn-vue-skilld?

Передаёт агенту точные флаги CLI shadcn-vue 2.8.2, схему components.json, правила именования пресетов и компонентов, а также информацию о программном API — чтобы агент не путал устаревшие имена с актуальными.

Работает ли скилл с GitHub Copilot?

Да. Для GitHub Copilot установка: gh skill install skilld-dev/vue-ecosystem-skills shadcn-vue-skilld. Скилл сохраняется в .github/skills/shadcn-vue-skilld/SKILL.md.

Исходный текст

SKILL.md · MIT
---
name: shadcn-vue-skilld
description: Use when adding, configuring, or debugging shadcn-vue in a Vue or Nuxt project. Covers shadcn-vue CLI commands (init, add, apply, view, search, docs, info, diff, migrate, build, mcp), components.json, styles, presets, fonts, icon libraries, registries, the MCP server, and the programmatic API. Gives exact flags and config keys for shadcn-vue 2.8.2.
license: MIT
---

# shadcn-vue

Version: `[email protected]` (prepared source `package.json:4`; npm `latest` dist-tag, checked 2026-09-22).
Stack: Vue 3.5+, `reka-ui` ^2.10.1, Tailwind CSS ^4.3.2 (`package.json:68,88,91`). One base: `reka`.
Run the CLI with `pnpm dlx shadcn-vue@latest <command>` (or `npx`, `npm exec`, `bunx`).

## What it does

The CLI copies component source files into your project and installs their npm dependencies.
You own the copied code. Edit `components/ui/**` freely; re-running `add` with `-o, --overwrite` replaces your edits.

## Core workflow

```bash
# New or existing project: write components.json, install deps, set up CSS
pnpm dlx shadcn-vue@latest init

# Add components (also: URL, local file, @namespace/item, owner/repo/item)
pnpm dlx shadcn-vue@latest add button card dialog

# Preview without writing, then install
pnpm dlx shadcn-vue@latest add sidebar --dry-run
pnpm dlx shadcn-vue@latest add sidebar

# Usage docs and examples for a component
pnpm dlx shadcn-vue@latest docs button
```

## Rules that prevent bugs

- Item names resolve in this order: URL, local file, `@namespace/item`, `owner/repo/item[#ref]`, then plain name in the default registry (`dist/registry-hxzbzXMt.js:1870-1891`, https://www.shadcn-vue.com/docs/cli#add).
- Preset names have no prefix in 2.8.x: `vega`, `nova`, `maia`, `lyra`, `mira`, `luma`, `sera` (`dist/registry-hxzbzXMt.js:3141-3244`). Older docs and the 2.6.x baseline used `reka-vega` style names; those fail now. See [changes](./references/changes-2.7-2.8.md).
- `toast` and `toaster` are deprecated; use `sonner` (`dist/transform-menu-CLNZ5vUh.js:446-454`).
- `lucide-vue-next` is the legacy icon package; current lucide package is `@lucide/vue` (`dist/transform-menu-CLNZ5vUh.js:457`, `dist/icons/index.d.ts:3-10`). Run `migrate icons` to switch libraries.
- Registry style ids stay prefixed: the `vega` style fetches from `reka-vega` (`dist/registry-hxzbzXMt.js:492-496`). Fallback style id is `new-york-v4`.
- `apply <preset>` rewrites UI components, fonts, and CSS variables. Commit first; the CLI warns the same (`dist/index.js:2252-2254`).
- Registry env: `SHADCN_VUE_URL` and `REGISTRY_URL` override the default `https://shadcn-vue.com/r` (`dist/transform-menu-CLNZ5vUh.js:2-3`). Use for local registry testing.
- Builtin namespace is `@shadcn` (`dist/transform-menu-CLNZ5vUh.js:445`). Third-party namespaces must be configured in `components.json` under `registries`.

## Command map

| Command | Purpose | Key options |
| --- | --- | --- |
| `init` (alias `create`) | Set up project, write `components.json` | `-p <preset>`, `-t <template>`, `--style`, `--icon-library`, `--font`, `-b <base-color>`, `-d`, `--silent` |
| `add` | Install items | `-o`, `-a`, `-p <path>`, `--dry-run`, `--diff`, `--view` |
| `apply` | Apply a preset to an existing project | `-y` |
| `view` | Inspect items before install | `-c <cwd>` |
| `search` (alias `list`) | Fuzzy search registries (`@name` args) | `-q`, `-l`, `-o` |
| `docs` | Component docs and examples | `--json`, `-b <base>` |
| `info` | Project setup report | `--json` |
| `diff` | Compare installed item against registry | `-y` |
| `migrate` | `icons` or `rtl` migration | `-l`, `[path]` |
| `build` | Build `registry.json` into registry JSON | `-o <path>` |
| `mcp init` | Write MCP client config | `--client claude\|cursor\|vscode` |

Full flags: [cli reference](./references/cli.md).

## Configuration

`components.json` at project root drives everything. Key fields: `style`, `typescript`, `tailwind.css`, `tailwind.baseColor`, `aliases`, `iconLibrary`, `rtl`, `pointer`, `menuColor`, `menuAccent`, `registries`.
Full schema and examples: [components-json reference](./references/components-json.md).

## Styles and presets

Seven named presets (`vega` to `sera`), eight valid styles in encoded preset codes (adds `rhea`), five icon libraries, 24 fonts. Details and tables: [styles reference](./references/styles-and-presets.md).

## Programmatic API

Import from `shadcn-vue`, `shadcn-vue/registry`, `shadcn-vue/schema`, `shadcn-vue/utils`, `shadcn-vue/icons`, `shadcn-vue/preset`, `shadcn-vue/mcp`, `shadcn-vue/tailwind.css` (`package.json:27-59`).
Exports and error classes: [registries reference](./references/registries.md#programmatic-api).

## References

- [CLI reference](./references/cli.md)
- [components.json](./references/components-json.md)
- [Styles and presets](./references/styles-and-presets.md)
- [Registries and programmatic API](./references/registries.md)
- [MCP server](./references/mcp.md)
- [Changes in 2.7 and 2.8](./references/changes-2.7-2.8.md)

© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
shadcn-vue unovue Помогает добавлять, настраивать и стилизовать компоненты shadcn-vue в проекте по официальным правилам композиции. CX Codex +1 6 300установок shadcn-vue-inertia inertia-rails Скилл shadcn-vue-inertia обучает агента адаптировать shadcn-vue под Vue 3 и Inertia Rails без Nuxt. Помогает при вёрстке форм, таблиц, диалогов и системных тостов. CX Codex +1 122установок nuxt-ui nuxt Помогает агенту собирать интерфейсы на базе @nuxt/ui v4, настраивать темы Tailwind CSS и правильно выбирать компоненты библиотеки. CX Codex +1 20 500установок nuxtjs-vue-typescript Mindrally Скилл nuxtjs-vue-typescript для Claude Code задаёт правила разработки приложений на Nuxt 3 и Vue 3 с TypeScript и Tailwind CSS: архитектуру компонентов, типизацию и шаблоны выборки данных. CX Codex +1 880установок vue-3-nuxt-3-typescript-cursorrules-prompt-file PatrickJS Правило vue-3-nuxt-3-typescript-cursorrules-prompt-file для Cursor задаёт стиль кода на Vue 3 и Nuxt 3: Composition API, TypeScript-интерфейсы, конвенции Nuxt. Помогает агенту писать код, согласованный с архитектурой проекта. CX Codex +1 ★ 41 178звёзд репо nuxtjs-vue-typescript-development-rules qdleader Правило nuxtjs-vue-typescript-development-rules задаёт стандарты фронтенд-разработки на Nuxt 3, Vue 3 и TypeScript: от структуры папок и компонентов с Tailwind до типизации без enum. CX Codex +1 ★ 571звёзд репо

Из того же набора32

Весь набор →
tanstack-vue-query-skilld Скилл tanstack-vue-query-skilld для Claude Code задаёт правила работы с @tanstack/vue-query v5. Помогает писать запросы и мутации в Vue 3 или Vue 2 без типичных ошибок с реактивностью. CX Codex +1 223установок vueuse-core-skilld Скилл vueuse-core-skilld с полным API @vueuse/core 15.0.0: новые composables, правила миграции с v14, устаревшие функции и требования окружения. CX Codex +1 219установок vee-validate-skilld Скилл vee-validate-skilld помогает писать, проверять и отлаживать формы Vue 3 с vee-validate 4.15.x. Даёт актуальные примеры Composition API, паттерны схем валидации, интеграцию typed-schema и решение типичных ошибок. CX Codex +1 188установок primevue-skilld Скилл primevue-skilld помогает писать и обновлять код для PrimeVue v5: настраивать библиотеку, заменять устаревшие API и собирать компоненты из частей. Пригодится в проекте на Vue 3. CX Codex +1 187установок vue-test-utils-skilld Скилл vue-test-utils-skilld помогает писать, отлаживать и проверять тесты Vue 3 с @vue/test-utils 2.5.1. CX Codex +1 168установок vueuse-components-skilld Скилл vueuse-components-skilld помогает писать и отлаживать Vue 3-шаблоны с компонентами и директивами @vueuse/components. Пригодится и при переходе от composable к компонентной или директивной форме. CX Codex +1 168установок motion-v-skilld Скилл motion-v-skilld для анимаций через motion-v (Motion для Vue) — компонент motion, жесты, варианты, директива v-motion, Nuxt-модуль. CX Codex +1 146установок reka-ui-skilld Скилл reka-ui-skilld для Claude Code помогает собирать доступные интерфейсы на Reka UI 2.10.5 во Vue 3, писать чистую композицию и не путать пропсы. CX Codex +1 146установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой