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

tanstack-vue-form-skilld — скилл для Claude Code

Скилл tanstack-vue-form-skilld помогает писать, проверять и отлаживать формы Vue на @tanstack/vue-form с актуальным API TanStack Form.

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

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

Что делает tanstack-vue-form-skilld

Скилл объясняет агенту, как строить формы на Vue 3 с @tanstack/[email protected]: использовать useForm, form.Field, form.Subscribe, form.useSelector и управляемую привязку полей через handleChange и handleBlur. Он также учитывает вложенные ключи, группы форм и массивы с mode="array".

Для проверки данных описаны валидаторы onMount, onChange, onBlur, onSubmit и onDynamic, включая схемы Standard Schema. Агенту подсказывается применять revalidateLogic() для динамической валидации и не использовать устаревшие form.useStore и field.getValue(). В проекте нужна peer dependency vue ^3.4.0, поэтому без неё примеры скилла не совпадут с требованиями пакета.

Скилл предназначен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Он устанавливается из репозитория skilld-dev/vue-ecosystem-skills.

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

  • собрать форму Vue на useForm
  • связать поля с form.Field без v-model
  • добавить валидацию через Standard Schema
  • настроить массив полей с mode="array"
  • проверить код на устаревшие API TanStack Form

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

  • Создай форму Vue на @tanstack/vue-form с полем fullName и обработчиком отправки.
  • Проверь этот код формы и замени устаревший form.useStore на актуальный API.
  • Добавь массив people с mode="array", вложенными полями и методами изменения элементов.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/tanstack-vue-form-skilld/SKILL.md

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

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

Вопросы о tanstack-vue-form-skilld

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

Выполните npx skills add skilld-dev/vue-ecosystem-skills --skill tanstack-vue-form-skilld -a claude-code, затем проверьте файл ~/.claude/skills/tanstack-vue-form-skilld/SKILL.md.

Что делает tanstack-vue-form-skilld?

Скилл помогает писать, проверять и отлаживать формы Vue на @tanstack/vue-form. Он охватывает поля, реактивные селекторы, валидацию, группы форм и массивы.

Какая версия Vue нужна для этого скилла?

Пакет использует peer dependency vue ^3.4.0. Скилл ориентирован на API @tanstack/vue-form версии 1.33.x.

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

SKILL.md · MIT
---
name: tanstack-vue-form-skilld
description: Use when writing, reviewing, or debugging code that imports @tanstack/vue-form (TanStack Form for Vue). Covers the 1.33.x API, including useForm, form.Field, form.FormGroup, form.Subscribe, form.useSelector, validators with Standard Schema, onDynamic with revalidateLogic, and array fields with mode="array". Result, forms built on current, non-deprecated Vue APIs with correct reactivity.
license: MIT
---

# @tanstack/vue-form 1.33.5

Headless, type-safe form state for Vue 3. The package re-exports all of `@tanstack/form-core` and adds Vue components and hooks (src/index.ts:1-5).

## Environment

- Version studied: `@tanstack/[email protected]`, bundling `@tanstack/[email protected]` and `@tanstack/vue-store@^0.11.0` (package.json:39-42).
- Peer dependency: `vue ^3.4.0` (package.json:48-50). TypeScript 5.4 through 5.9 are in the test matrix (package.json:54-60).
- Import from the package root only. The sole subpath export is `./package.json` (package.json:21-33). Dual ESM/CJS, `sideEffects: false`.
- Official docs: https://tanstack.com/form/latest/docs/framework/vue/overview

## Minimal form

```vue
<script setup lang="ts">
import { useForm } from '@tanstack/vue-form'

const form = useForm({
  defaultValues: {
    fullName: '',
  },
  onSubmit: async ({ value }) => {
    console.log(value)
  },
})
</script>

<template>
  <form @submit.prevent.stop="form.handleSubmit">
    <form.Field name="fullName">
      <template v-slot="{ field }">
        <input
          :name="field.name"
          :value="field.state.value"
          @blur="field.handleBlur"
          @input="(e) => field.handleChange((e.target as HTMLInputElement).value)"
        />
      </template>
    </form.Field>
    <button type="submit">Submit</button>
  </form>
</template>
```

Source: official quick start, https://tanstack.com/form/latest/docs/framework/vue/quick-start

## Field binding rules

- Fields are created with the `form.Field` component. The `name` prop must be a deep key of `defaultValues`, for example `'details.email'` or `` `people[${i}].name` ``.
- The scoped slot receives `{ field, state }` (src/useField.tsx:543-547). `field` is a `FieldApi`, `state` mirrors `field.state`.
- Inputs are controlled: bind `:value="field.state.value"`, push updates through `field.handleChange`, and wire `@blur="field.handleBlur"`.
- For number inputs, use `(e.target as HTMLInputElement).valueAsNumber`.
- Do not write `v-model` on the slot input; state flows through `handleChange`.
- `form.Field` merges its props with fallthrough attrs before creating the field (src/useField.tsx:541), so validators and listeners can be passed as props or attrs.

## Reactivity

- In `<script setup>`, use `form.useSelector((state) => state.values.firstName)`. It returns a `Readonly<Ref<T>>` (src/useForm.tsx:155-189).
- `form.useStore` is deprecated; it is the same function as `useSelector`. Prefer `form.useSelector` (src/useForm.tsx:190-227, 336-337).
- In the template, use `<form.Subscribe>` with an optional `selector` prop. Without `selector`, the slot receives the whole form state (src/useForm.tsx:338-349).
- Do not call the `useField` hook directly for reactivity. It is designed for use inside `form.Field`; use `form.useSelector` instead (official basic-concepts note, https://tanstack.com/form/latest/docs/framework/vue/guides/basic-concepts).
- `useSelector` and `useStore` are re-exported from `@tanstack/vue-store` for raw store access (src/index.ts:2).

Details: [references/reactivity.md](./references/reactivity.md)

## Validation essentials

- Pass validators via the `validators` prop on `form.Field`, or `validators` in `useForm` options. Hooks: `onMount`, `onChange`, `onBlur`, `onSubmit`, `onDynamic`, each with an `Async` variant.
- A validator returns `undefined` when valid, or an error of any type (usually a string). Errors land in `field.state.meta.errors` and `field.state.meta.errorMap`.
- Standard Schema libraries work directly as validators: Zod v3.24.0 or higher, Valibot v1.0.0 or higher, ArkType v2.1.20 or higher, Yup v1.7.0 or higher (official basic-concepts guide).
- Debounce async validators with the `async-debounce-ms` prop or per-validator `onChangeAsyncDebounceMs`.
- `onDynamic` validators only run when `validationLogic: revalidateLogic()` is set in `useForm` options.

```vue
<form.Field
  name="age"
  :validators="{
    onChange: z.number().gte(13, 'You must be 13 to make an account'),
  }"
>
```

Details: [references/validation.md](./references/validation.md)

## Array fields

- Give the wrapping field `mode="array"`. In array mode the component tracks `state.meta._arrayVersion` instead of the value, so child edits do not re-render the whole list (src/useField.tsx:258-267, src/types.ts:12-15).
- Render sub-fields with `v-for` over `field.state.value` and deep names such as `` `people[${i}].name` ``.
- Mutate through the array methods: `pushValue`, `removeValue`, `swapValues`, `moveValue`, `insertValue`, `replaceValue`, `clearValues`.

Details: [references/array-fields.md](./references/array-fields.md)

## Form groups

- `<form.FormGroup name="step1" v-slot="{ group }">` builds a sub-form for one key of the form data. The slot receives `{ group, state }` (src/useFormGroup.tsx:525-529).
- `group.handleSubmit()` submits and validates only the group; `form.handleSubmit()` submits the whole form.
- Group validators can return `{ group, fields }`, where `fields` keys are relative to the group, and Standard Schemas can be composed per step.

Details: [references/form-groups.md](./references/form-groups.md)

## Version-specific rules

- BREAKING since v1.28.0: `field.state.meta.errors` is flattened by default, so `['err']` not `[['err']]`. Restore the old nesting per field with `disableErrorFlat: true` in field options. Release: https://github.com/TanStack/form/releases/tag/%40tanstack%2Fvue-form%401.28.0
- DEPRECATED: `form.useStore`, use `form.useSelector` (src/useForm.tsx:190-192, 336-337).
- DEPRECATED: `field.getValue()`, read `field.state.value` instead (official FieldApi reference, https://tanstack.com/form/latest/docs/reference/classes/FieldApi).
- `Field` accepts `mode: 'value' | 'array'`. Array mode exists to avoid list re-renders; see https://github.com/TanStack/form/issues/1925 (src/useField.tsx:258-259).
- `useForm` generates an SSR-safe form id from Vue's `useId` when available, falling back to a uuid, so server markup and client hydration agree (src/useForm.tsx:272, src/useFormId.ts:18-24). `useFormId` itself is internal and not exported (dist/esm/index.js).
- Reusable option sets: `formOptions({ defaultValues })` from form-core, spread into `useForm`.

## Pitfalls

- Standard Schema transforms are not preserved. `onSubmit` always receives the input data; call `schema.parse(value)` inside `onSubmit` for transformed output (official submission guide, https://tanstack.com/form/latest/docs/framework/vue/guides/submission-handling).
- A form-level validator error on a field can be overwritten by that field's own validator; field validation runs after form-level field errors are set (official validation guide).
- Sync validators run first; the matching `Async` validator is skipped when sync fails, unless `asyncAlways: true`.
- `canSubmit` is true until the form is touched. Combine `!canSubmit || isPristine` to gate a submit button before any interaction. Prefer `aria-disabled` over `disabled` for accessibility (official validation guide).
- The `Field` and `FormGroup` components pass the parent form automatically. Only the standalone `Field` and `FormGroup` exports require an explicit `form` option.
- Async default values: wrap them in `reactive` and `computed` refs (TanStack Query pattern, https://tanstack.com/form/latest/docs/framework/vue/guides/async-initial-values).

## References

- [references/api-surface.md](./references/api-surface.md): exports, hooks, components, and core class methods with source citations.
- [references/reactivity.md](./references/reactivity.md): selectors, Subscribe, listeners, and reactive meta tracking.
- [references/validation.md](./references/validation.md): validators, schemas, dynamic validation, linked fields, and submission handling.
- [references/array-fields.md](./references/array-fields.md): array fields and array mutation methods.
- [references/form-groups.md](./references/form-groups.md): sub-forms, group validation, and group state.

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

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

Все скиллы по теме «Фронтенд и UI» →
tanstack-form oakoss Помогает собирать формы на TanStack Form v1 в React и управлять их состоянием, валидацией и отправкой. Описывает работу со сложными и динамическими формами. CX Codex +1 222установок react-hook-form-zod ovachiever Скилл react-hook-form-zod учит агента собирать формы на React Hook Form с валидацией через Zod. Одна схема работает и на клиенте, и на сервере. CX Codex +1 725установок regle Victor Garcia Скилл regle для Claude Code помогает добавлять и менять формы с валидацией Regle в Vue 3. Он подсказывает, как связать поля с r$ и показывать ошибки. CX Codex +1 269установок tanstack-store oakoss Объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов. CX Codex +1 113установок mantine-form mantinedev Сборка форм на @mantine/form с валидацией, схемами zod и valibot, вложенными полями и массивами. CX Codex +1 2 900установок form-design Owl-Listener Скилл form-design проектирует веб-формы от порядка полей и группировки до валидации и доступности. Пригодится при сборке ввода данных любого масштаба — от одиночных полей до многошаговых сценариев. CX Codex +1 2 400установок

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

Весь набор →
tanstack-vue-table-skilld Скилл tanstack-vue-table-skilld обучает агента правилам @tanstack/vue-table v9: явной регистрации фич в tableFeatures, атомарному состоянию и миграции с v8. Пригодится при сборке headless-таблиц на Vue 3. CX Codex +1 144установок vueuse-motion-skilld Скилл vueuse-motion-skilld помогает ИИ писать и отлаживать декларативные анимации через @vueuse/motion в Vue 3 и Nuxt 3 без ошибок в таймингах и SSR. CX Codex +1 141установок vueuse-shared-skilld Скилл vueuse-shared-skilld добавляет в Claude Code, Cursor и другие редакторы знание API @vueuse/shared v15.0.0 — фреймворк-агностичных реактивных утилит для Vue. CX Codex +1 137установок tanstack-vue-virtual-skilld Скилл tanstack-vue-virtual-skilld помогает писать, проверять и отлаживать виртуализированные списки и сетки во Vue с @tanstack/vue-virtual. Пригодится и для лент чата с прокруткой к концу. CX Codex +1 129установок vueuse-math-skilld Скилл vueuse-math-skilld для работы с композаблами @vueuse/math в Vue 3: клампинг, проекция, округление, агрегация реактивных чисел. CX Codex +1 119установок floating-ui-vue-skilld Скилл floating-ui-vue-skilld помогает писать позиционирование всплывающих окон, тултипов и меню через @floating-ui/vue 2.0.1 во Vue 3.3+. CX Codex +1 119установок vue-data-ui-skilld Скилл vue-data-ui-skilld помогает агенту работать с библиотекой графиков vue-data-ui для Vue 3: выбирать компоненты, настраивать темы и разбирать ошибки. CX Codex +1 118установок unovis-vue-skilld Скилл unovis-vue-skilld для Claude Code помогает писать и отлаживать код на Vue 3 с компонентами @unovis/vue. Используется для построения графиков и обновления интеграции с Unovis 1.7.0. CX Codex +1 112установок

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

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