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
npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/shadcn-vue-skilld/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/shadcn-vue-skilld/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a codex2Вручную: положить файлы
.agents/skills/shadcn-vue-skilld/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a cursor2Вручную: положить файлы
.cursor/skills/shadcn-vue-skilld/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install skilld-dev/vue-ecosystem-skills skills/shadcn-vue-skilld2Вручную: положить файлы
.github/skills/shadcn-vue-skilld/SKILL.md1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a gemini-cli2Командой платформы
gemini skills install https://github.com/skilld-dev/vue-ecosystem-skills --path skills/shadcn-vue-skilldВручную: положить файлы
.devin/skills/shadcn-vue-skilld/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill shadcn-vue-skilld -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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