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

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

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

Что делает 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-code

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

~/.claude/skills/vee-validate-skilld/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Фронтенд и UI» →
regle Victor Garcia Скилл regle для Claude Code помогает добавлять и менять формы с валидацией Regle в Vue 3. Он подсказывает, как связать поля с r$ и показывать ошибки. CX Codex +1 269установок form-validation aj-geddes Скилл form-validation для Claude Code помогает настроить валидацию форм в React и Vue с проверкой типов в TypeScript. Валидирует пошаговые формы и сразу показывает ошибки. CX Codex +1 507установок form-validate Nikolay Shirokov Скилл form-validate запускает валидацию управляемой формы 1С после создания или изменения, чтобы найти ошибки в структуре. CX Codex +1 49установок safe-action-validation-errors next-safe-action Скилл safe-action-validation-errors для Claude Code помогает разбирать ошибки валидации next-safe-action. Он включается при настройке returnValidationErrors, форм ошибок и их отображения. CX Codex +1 1 200установок react-hook-form-zod ovachiever Скилл react-hook-form-zod учит агента собирать формы на React Hook Form с валидацией через Zod. Одна схема работает и на клиенте, и на сервере. CX Codex +1 725установок angular-forms gentleman-programming Скилл angular-forms для работы с формами Angular: покрывает Signal Forms (экспериментальные, на Angular 21+) и Reactive Forms для продакшена. Триггер срабатывает при работе с валидацией, состоянием формы или её созданием. CX Codex +1 150установок

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

Весь набор →
vue-router-skilld Скилл vue-router-skilld для Claude Code содержит правила настройки [email protected]: типизированная маршрутизация, data loaders и файловые роуты без устаревшего API. CX Codex +1 324установок pinia-colada-skilld Скилл pinia-colada-skilld добавляет в Claude Code шаблоны и правила работы с @pinia/colada. Помогает настраивать выборку данных, мутации, сброс кэша и работу с SSR во Vue. CX Codex +1 240установок 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установок primevue-skilld Скилл primevue-skilld помогает писать и обновлять код для PrimeVue v5: настраивать библиотеку, заменять устаревшие API и собирать компоненты из частей. Пригодится в проекте на Vue 3. CX Codex +1 187установок shadcn-vue-skilld Скилл shadcn-vue-skilld для Claude Code, Codex, Cursor и других агентов, покрывающий CLI shadcn-vue 2.8.2 для Vue и Nuxt. Знает точные флаги всех команд — от init до mcp, конфигурацию components.json и правила разрешения имён компонентов. CX Codex +1 174установок 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установок

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

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