primevue-skilld — скилл для Claude Code: настройка и установка
Скилл primevue-skilld помогает писать и обновлять код для PrimeVue v5: настраивать библиотеку, заменять устаревшие API и собирать компоненты из частей. Пригодится в проекте на Vue 3.
MIT 187 установок ★ 186 обновлён 2026-10-10
npx skills add skilld-dev/vue-ecosystem-skills --skill primevue-skilld -a claude-codeЧто делает primevue-skilld
Скилл подсказывает, как подключить PrimeVue через app.use, передать ключ лицензии PrimeUI и настроить тему. Для компонентов он описывает новые API v5: например, Select с множественным выбором вместо MultiSelect, а содержимое Button предлагает собирать в слоте. Ключ лицензии обязателен: без действительного ключа может появиться уведомление о лицензии.
В рекомендациях также есть составные компоненты для вкладок, аккордеона и боковой панели, работа оверлеев через Teleport и настройка темы дизайн-токенами. Для иконок скилл указывает @primeicons/vue; пакет @primevue/icons помечен как устаревший. При переходе с PrimeVue v4 учитывайте базовый размер шрифта: в v5 это 16px, а варианты пресетов -compat рассчитаны на макеты с 14px.
Какие задачи решает
- настроить PrimeVue v5 и передать ключ лицензии
- заменить устаревший
MultiSelectнаSelectс множественным выбором - собрать вкладки или аккордеон из составных компонентов
- перенести оформление с CSS-переопределений на дизайн-токены
- подключить уведомления через
ToastServiceиuseToast
Примеры запросов агенту
- Настрой PrimeVue v5 в
main.jsс темой Aura и ключом лицензии PrimeUI. - Замени
MultiSelectнаSelectс множественным выбором в этом компоненте. - Собери вкладки из составных компонентов PrimeVue и привяжи активное состояние через
v-model:value.
Как установить primevue-skilld
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill primevue-skilld -a claude-code2Вручную: положить файлы
~/.claude/skills/primevue-skilld/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/primevue-skilld/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill primevue-skilld -a codex2Вручную: положить файлы
.agents/skills/primevue-skilld/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill primevue-skilld -a cursor2Вручную: положить файлы
.cursor/skills/primevue-skilld/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install skilld-dev/vue-ecosystem-skills skills/primevue-skilld2Вручную: положить файлы
.github/skills/primevue-skilld/SKILL.md1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill primevue-skilld -a gemini-cli2Командой платформы
gemini skills install https://github.com/skilld-dev/vue-ecosystem-skills --path skills/primevue-skilldВручную: положить файлы
.devin/skills/primevue-skilld/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill primevue-skilld -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о primevue-skilld
Как установить primevue-skilld в Claude Code?
Выполните npx skills add skilld-dev/vue-ecosystem-skills --skill primevue-skilld -a claude-code. Файл скилла находится по пути ~/.claude/skills/primevue-skilld/SKILL.md.
Что делает primevue-skilld?
Помогает писать и обновлять код для PrimeVue v5: настраивать плагин и тему, применять актуальные API и составные компоненты.
На каких платформах работает primevue-skilld?
Скилл рассчитан на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.
Исходный текст
SKILL.md · MIT
--- name: primevue-skilld description: Use when writing, debugging, or updating code that imports primevue (PrimeVue v5, UI component library for Vue 3). Provides setup with the required PrimeUI license key, deprecated API replacements, compound component usage, and design token theming. license: MIT --- # PrimeVue (`[email protected]`) Version 5.0.1, prepared source `input/source/package.json`. UI component library for Vue 3. Docs: https://primevue.dev (component pages live at `https://primevue.dev/<name>`, e.g. `https://primevue.dev/inputtags/`). ## Critical v5 facts 1. **License key required.** v5 ships under the PrimeUI dual license (free Community or paid Commercial). Pass the key as a `license` string option when installing the plugin. Verification is offline; a missing, invalid, or expired key may display a license notice (`input/source/LICENSE.md`). 2. **No breaking public API changes from v4**, per the official migration guide (https://primevue.dev/migration/v5/). Deprecated v4 APIs still work in v5 and are removed in v6. Write new code against the replacements in [v5 changes](references/v5-changes.md). 3. **16px root font base.** v5 assumes a 16px document root; v4 assumed 14px. Every preset ships a `-compat` variant for 14px layouts, maintained until June 2027 (https://primevue.dev/theming/styled/). 4. **Config plugin.** Install once with `app.use`. The default export of `primevue/config` is also re-exported as `Config` from the package root (`input/source/index.mjs:139`). ## Setup ```js // main.js import { createApp } from 'vue'; import PrimeVue from 'primevue/config'; // or: import { Config } from 'primevue' import Aura from '@primeuix/themes/aura'; import App from './App.vue'; const app = createApp(App); app.use(PrimeVue, { license: '<your PrimeUI license key>', ripple: true, // optional, disabled by default theme: { preset: Aura, options: { darkModeSelector: '.app-dark' // default is 'system' } } }); ``` Details: theme options, locale, unstyled mode, Nuxt module, auto import in [setup](references/setup.md). ## Import patterns ```vue <script setup> // Tree-shakeable subpath imports (package.json exports map "./*") import Button from 'primevue/button'; import Select from 'primevue/select'; // Style classes for a component (design token CSS) import SelectStyle from 'primevue/select/style'; </script> ``` - Root import `from 'primevue'` also works and exports every component, style, service, and composable (`input/source/index.mjs`). - Icons: SVG icon components come from `@primeicons/vue` (dependency `^8.0.0` in `input/source/package.json`). The `@primevue/icons` package is deprecated in v5. ## Golden rules - **Never use a deprecated component in new code.** Deprecated in v5 (removal in v6): `MultiSelect`, `Galleria`, `Image`, `ColorPicker`, `ImageCompare`, `ScrollPanel`, `Password`, `InputMask` (component), `PanelMenu`, `Chart`, `Editor`, `AutoComplete` with `multiple`, `Carousel` driven by `value`, `Tabs` `scrollable`. Use the replacement table in [v5 changes](references/v5-changes.md). - **Buttons compose content in the default slot.** `label`, `icon`, `iconPos`, `iconClass`, `badge`, `badgeClass`, `badgeSeverity`, `loading`, `loadingIcon` props are all deprecated since v5.0.0 (`input/source/button/index.d.ts`). - **Compound components over prop-driven templates**: `Tabs`/`TabList`/`Tab`/`TabPanels`/`TabPanel`, `Accordion`/`AccordionPanel`/`AccordionHeader`/`AccordionContent`, `Stepper` family, `Sidebar` family, `Gallery` family, `Carousel` family. Active state binds with `v-model:value` (Accordion's `activeIndex` prop and events were removed in v5). - **Overlays are Teleport-based**: set `appendTo="body"` (default) or `"self"`; most overlay components accept `overlayStyle`/`overlayClass` (panel* props were removed in v5). - **Prefer design tokens over CSS overrides**: use `dt` prop for scoped tokens and preset customization via `definePreset` instead of `:deep()` or style classes (https://primevue.dev/theming/styled/). ## Common tasks ### Button (slot composition) ```vue <Button severity="contrast" size="small"> <i class="pi pi-check" /> <span>Confirm</span> <Badge value="2" /> </Button> ``` Icon order in the slot replaces `iconPos`; use `disabled` plus your own spinner instead of `loading`. ### Multiple selection (replaces MultiSelect) ```vue <Select v-model="selectedCities" multiple :options="cities" optionLabel="name" fluid /> ``` `multiple` on `Select` ("When specified, allows selecting multiple values", `input/source/select/index.d.ts`). ### Tags input (replaces AutoComplete multiple) ```vue <InputTags v-model="tags" typeahead :suggestions="suggestions" @complete="search" delimiter="," /> ``` Key props: `max`, `allowDuplicate`, `addOnBlur`, `addOnPaste`, `addOnTab`, `delimiter` (string or RegExp). Emits `add`, `remove`, `option-select`, `complete` (`input/source/inputtags/index.d.ts`). ### Toast service ```js // main.js: app.use(ToastService) import { useToast } from 'primevue/usetoast'; const toast = useToast(); toast.add({ severity: 'info', summary: 'Saved', life: 3000 }); ``` Service methods: `add`, `remove`, `removeGroup`, `removeAllGroups` (`input/source/toastservice/index.d.ts`). Same pattern for `ConfirmationService` + `useConfirm` and `DialogService` + `useDialog` (dynamic dialogs). ### Mask directive (replaces InputMask component) ```vue <InputText v-mask="{ mask: '99-9999', unmask: true }" v-model="value" /> ``` Options: `mask`, `slotChar` (default `_`), `autoClear` (default true), `unmask`, `onChange` receiving `{ value, rawValue }` (`input/source/mask/index.d.ts`). ### App sidebar (compound) ```vue <SidebarLayout> <SidebarAside> <SidebarHeader>…</SidebarHeader> <SidebarContent> <SidebarGroup> <SidebarGroupLabel>Admin</SidebarGroupLabel> <SidebarGroupContent> <SidebarMenu> <SidebarMenuItem><SidebarMenuButton>Users</SidebarMenuButton></SidebarMenuItem> </SidebarMenu> </SidebarGroupContent> </SidebarGroup> </SidebarContent> <SidebarFooter>…</SidebarFooter> </SidebarAside> <SidebarMain><RouterView /></SidebarMain> </SidebarLayout> ``` `Sidebar` inside a `SidebarLayout` requires a unique `id`; supports `side`, `variant` (`sidebar|floating|inset`), `collapsible` (`offcanvas|icon|none`), `v-model:open`, `openOnHover`, `overlay`, `width` (`input/source/sidebar/index.d.ts`). Full part list in [components](references/components.md). ### Form fields - `FloatLabel`, `IftaLabel` (in-field label), or plain `Label`. - Wrap a region in `<Fluid>` for full-width inputs instead of `fluid` on each field. - `invalid` prop on any input drives the error style; validation state via `@primevue/forms` (separate package, https://primevue.dev/forms/). ### DataTable performance With `dataKey` set, bind `expandedRows` to an object (`{ '1004': true }`) rather than an array of row objects for O(1) lookup on large data (official DataTable docs). Persist user preferences with `stateStorage` + `stateKey`. ## References - [Setup and configuration](references/setup.md): install, license, theme presets, dark mode, locale, unstyled mode, Nuxt. - [v5 changes and migration](references/v5-changes.md): deprecation and removal tables with replacements. - [Components and replacements](references/components.md): compound families, new v5 components, services, utilities.
© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills