vee-validate-skilld — скилл для Claude Code: форма валидация Vue 3
Скилл vee-validate-skilld помогает писать, проверять и отлаживать формы Vue 3 с vee-validate 4.15.x. Даёт актуальные примеры Composition API, паттерны схем валидации, интеграцию typed-schema и решение типичных ошибок.
MIT 188 установок ★ 186 обновлён 2026-10-10
npx skills add skilld-dev/vue-ecosystem-skills --skill vee-validate-skilld -a claude-codeЧто делает vee-validate-skilld
vee-validate-skilld содержит знания о двух стилях работы с формами: Composition API через useForm и defineField (рекомендуется для новых проектов) и декларативные компоненты Form + Field с функциями-валидаторами. Скилл покрывает корректное связывание полей с помощью defineField, которая возвращает пару [model, props] для v-model и v-bind, правильную работу с вложенными объектами и массивами через точечную нотацию и индексы, типизированные схемы через toTypedSchema из @vee-validate/yup, @vee-validate/zod или @vee-validate/valibot, режимы валидации (по умолчанию проверка срабатывает на blur и change) и когда отображать ошибки только после взаимодействия.
В скилле перечислены версионные изменения, которые касаются пользователей vee-validate 4.9+: например, useField внутри пользовательских компонентов не синхронизирует v-model по умолчанию (начиная с 4.10.0), а useFieldModel и defineComponentBinds помечены как устарелые. Скилл помогает избежать ошибок вроде отсутствия toTypedSchema при использовании yup/zod-схем или неправильного обращения к объекту errors, который всегда плоский — даже для вложенных полей нужно использовать точный путь с кавычками.
Какие задачи решает
- Связать поле Vue с валидацией Composition API правильно
- Настроить вложенные объекты и массивы в форме
- Типизировать схему валидации через yup, zod или valibot
- Понять, когда и как выводить ошибки валидации
- Обновить форму с новой версией vee-validate без багов
Примеры запросов агенту
- Напиши форму с
useFormиdefineFieldдля регистрации: имя, почта, пароль - Помоги отладить ошибку «No such validator 'VVTypedSchema' exists» в схеме валидации
- Покажи, как итерировать динамический массив полей через
useFieldArrayиFieldArray
Как установить vee-validate-skilld
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill vee-validate-skilld -a claude-code2Вручную: положить файлы
~/.claude/skills/vee-validate-skilld/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vee-validate-skilld/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill vee-validate-skilld -a codex2Вручную: положить файлы
.agents/skills/vee-validate-skilld/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill vee-validate-skilld -a cursor2Вручную: положить файлы
.cursor/skills/vee-validate-skilld/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install skilld-dev/vue-ecosystem-skills skills/vee-validate-skilld2Вручную: положить файлы
.github/skills/vee-validate-skilld/SKILL.md1Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill vee-validate-skilld -a gemini-cli2Командой платформы
gemini skills install https://github.com/skilld-dev/vue-ecosystem-skills --path skills/vee-validate-skilldВручную: положить файлы
.devin/skills/vee-validate-skilld/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add skilld-dev/vue-ecosystem-skills --skill vee-validate-skilld -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vee-validate-skilld
Как установить vee-validate-skilld в Claude Code?
Выполни команду npx skills add skilld-dev/vue-ecosystem-skills --skill vee-validate-skilld -a claude-code, затем открой ~/.claude/skills/vee-validate-skilld/SKILL.md для проверки.
Что делает vee-validate-skilld?
Предоставляет примеры и лучшие практики vee-validate 4.15.x для Vue 3: как использовать Composition API и компоненты, работать с типизированными схемами, избежать ошибок с вложенными полями и динамическими массивами.
Почему появляется ошибка «No such validator 'VVTypedSchema' exists»?
Это значит, что ты передал сырую схему yup, zod или valibot напрямую, без обёртки toTypedSchema. Импортируй toTypedSchema из подходящего пакета (@vee-validate/yup, @vee-validate/zod или @vee-validate/valibot) и оберни ей схему перед передачей в useForm.
Исходный текст
SKILL.md · MIT
--- name: vee-validate-skilld description: Use when writing, reviewing, or debugging Vue.js forms that import vee-validate (useForm, defineField, useField, useFieldArray, Form, Field, FieldArray, ErrorMessage). Provides correct v4.15.x Composition API and component usage, validation schema patterns, typed-schema integration, version-specific API changes since 4.9, deprecations, and known pitfalls. license: MIT --- # vee-validate 4.15.1 Form validation for Vue 3. Facts below come from the prepared source (`dist/vee-validate.d.ts`, `dist/vee-validate.mjs`, `package.json`) and official docs at https://vee-validate.logaretm.com/v4/. ## Environment - Package `[email protected]` (`package.json:3`). Requires `vue ^3.4.26` as peer (`package.json:42`). - ESM + CJS, `sideEffects: false`, single entry `vee-validate` (`package.json:11-26`). - v4 supports Vue 3 only. Vue 2 needs vee-validate 2.x/3.x (README:69-72). - Schema adapters live in separate packages: `@vee-validate/yup`, `@vee-validate/zod`, `@vee-validate/valibot`; global rules in `@vee-validate/rules`; messages in `@vee-validate/i18n`. ## Two API styles **Composition API (preferred for new code).** `useForm` + `defineField` + `handleSubmit`: ```vue <script setup> import { useForm } from 'vee-validate'; function required(value) { return value ? true : 'This field is required'; } const { defineField, handleSubmit, errors } = useForm({ validationSchema: { field: required }, }); const [field, fieldProps] = defineField('field'); const onSubmit = handleSubmit(values => { console.log(values); }); </script> <template> <form @submit="onSubmit"> <input v-model="field" v-bind="fieldProps" /> <span>{{ errors.field }}</span> <button>Submit</button> </form> </template> ``` Source: README:84-118, https://vee-validate.logaretm.com/v4/guide/composition-api/getting-started/ **Declarative components.** `Form` + `Field` with scoped slots: ```vue <script setup> import { Field, Form } from 'vee-validate'; function required(value) { return value ? true : 'This field is required'; } function onSubmit(values) { console.log(values); } </script> <template> <Form v-slot="{ errors }" @submit="onSubmit"> <Field name="field" :rules="required" /> <span>{{ errors.field }}</span> <button>Submit</button> </Form> </template> ``` Source: README:122-153, https://vee-validate.logaretm.com/v4/guide/components/handling-forms/ ## Core rules - Bind fields with `defineField(path, config?)`. It returns `[model, props]`; spread the props with `v-bind` and the model with `v-model` (`dist/vee-validate.d.ts:443`, https://vee-validate.logaretm.com/v4/api/use-form/#definefield). - Never write directly to `values.field`; use the `defineField` model, `setFieldValue`, or `useSetFieldValue`. - `useFieldModel`, `defineComponentBinds`, and `defineInputBinds` are deprecated in favor of `defineField` (`dist/vee-validate.d.ts:444-459`). - Show errors only after interaction, e.g. `v-if="errorMessage && meta.touched"`, to avoid aggressive validation UX (https://vee-validate.logaretm.com/v4/guide/best-practices/#avoiding-aggressive-validation). - For TypeScript, wrap yup/zod/valibot schemas with `toTypedSchema` from the matching `@vee-validate/*` package. Passing a raw schema without it fails with "No such validator 'VVTypedSchema' exists" (https://vee-validate.logaretm.com/v4/guide/composition-api/typed-schema/, https://github.com/logaretm/vee-validate/discussions/4819). - `useField` inside a custom component must not sync its v-model by default (`syncVModel` defaults to `false`, breaking change in 4.10.0). Opt in per field with `syncVModel: true` or a model prop name string (`dist/vee-validate.mjs:1862`). - Field names are paths. Dots nest objects, `[0]` indexes arrays; wrap the name in brackets, e.g. `[user.name]`, to treat dots as literal (https://vee-validate.logaretm.com/v4/guide/composition-api/nested-objects-and-arrays/). - The `errors` object is always flat: reference the exact path string used as the field name, brackets included (https://vee-validate.logaretm.com/v4/guide/composition-api/nested-objects-and-arrays/). - Iterate array fields with `fields` from `useFieldArray` and key `v-for` by `entry.key` (a stable id, never the index) (https://vee-validate.logaretm.com/v4/guide/composition-api/nested-objects-and-arrays/). - Pass reactive field names as getters (`useField(() => props.name)`) so vee-validate tracks name changes (https://vee-validate.logaretm.com/v4/guide/composition-api/caveats/). - Keep schemas non-reactive: declare them outside `ref`/`reactive` or wrap with `markRaw` to avoid deep reactivity overhead (https://vee-validate.logaretm.com/v4/guide/best-practices/#reactive-schemas). - `handleSubmit.withControlled(cb)` submits only fields registered with `useField`/`defineField` (`dist/vee-validate.d.ts:430-432`); note typed schemas can still surface all initial values (open issue: https://github.com/logaretm/vee-validate/issues/4960). ## Validation modes Global defaults: `validateOnBlur: true`, `validateOnChange: true`, `validateOnInput: false`, `validateOnModelUpdate: true`, `bails: true`. Change globally with `configure()`; note these four trigger flags only apply to the `<Field>` component, not `useField` (https://vee-validate.logaretm.com/v4/api/configuration/). To validate only on submit, disable input/change/blur triggers per field in `defineField` config or globally (https://github.com/logaretm/vee-validate/discussions/4903). ## References - [Composition API](./references/composition-api.md): `useForm`, `defineField`, `useField`, `useFieldArray`, state and setter composables, form context. - [Components](./references/components.md): `Form`, `Field`, `FieldArray`, `ErrorMessage` props, slots, rendering, v-model rules. - [Validation](./references/validation.md): validator functions, object schemas, typed schemas, global rules, i18n, standalone `validate` utils. - [API surface](./references/api-surface.md): every runtime export and notable type, cited to `dist/vee-validate.d.ts`. - [Version changes](./references/version-changes.md): API additions, breaking changes, and deprecations from 4.9.0 to 4.15.1. - [Pitfalls](./references/pitfalls.md): composition caveats, nested path rules, array fields, known open issues.
© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills