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

tanstack-form · oakoss — скилл для Claude Code: формы и установка

Скилл для Claude Code помогает собирать формы на TanStack Form v1 в React и управлять их состоянием, валидацией и отправкой. Описывает работу со сложными и динамическими формами.

MIT 222 установок ★ 29 обновлён 2026-08-17

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

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

Скилл описывает работу с headless-менеджером состояния TanStack Form v1 для React. Он помогает агенту настраивать поля, синхронную и асинхронную валидацию с задержкой, отправку формы, массивы полей и связанные поля. UI-компоненты нужно писать самостоятельно: скилл управляет состоянием и логикой, но не рисует inputs.

Внутри есть паттерны для многошаговых форм, повторно используемых групп полей, подписок на состояние и интеграции со Standard Schema. Поддерживаются схемы Zod, Valibot, ArkType и Yup без адаптера. Для сложной межполеовой валидации можно передать задачу субагенту Task, а поиск готовых реализаций поручить Explore.

TanStack Form пока не совместим с React Compiler, поэтому его нужно отключить для файлов или компонентов, где используются API этого скилла.

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

  • собрать форму с синхронной и асинхронной валидацией
  • обработать динамический список полей
  • связать валидацию нескольких полей
  • разбить большую форму на переиспользуемые секции
  • подключить Zod, Valibot, ArkType или Yup

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

  • Собери React-форму с TanStack Form v1 и валидацией полей при изменении и отправке.
  • Добавь в форму динамический список hobbies с добавлением и удалением элементов.
  • Раздели большую форму на переиспользуемые группы полей и подключи схему Zod.

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

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill tanstack-form -a claude-code

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

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

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

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

Вопросы о tanstack-form

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

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

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

Скилл помогает агенту работать с состоянием, валидацией и отправкой форм на TanStack Form v1 для React. Он охватывает массивы полей, связанные поля, композицию форм и Standard Schema.

Совместим ли tanstack-form с React Compiler?

Нет. React Compiler нужно отключить для файлов или компонентов, использующих API TanStack Form.

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

SKILL.md · MIT
---
name: tanstack-form
description: |
  TanStack Form v1 headless form state management for React. Covers field validation (sync/async, debouncing), form submission, array fields, linked fields, form composition patterns, and Standard Schema integration (Zod, Valibot, ArkType, Yup).

  Use when building forms with complex validation, implementing reusable form components, handling dynamic field lists, managing form state, or integrating validation libraries.
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://tanstack.com/form/latest/docs'
user-invocable: false
---

# TanStack Form

## Overview

TanStack Form is a **headless form state manager**, not a UI component library. You provide your own inputs and handle their events; TanStack Form manages validation, state, and submission logic.

**When to use:** Complex multi-step forms, reusable form patterns, dynamic field arrays, cross-field validation, async server validation, forms requiring fine-grained performance optimization.

**When NOT to use:** Simple forms with native HTML validation (use plain form elements), server-only validation (use Server Actions), purely static forms with no validation.

**React Compiler:** TanStack Form is not yet compatible with React Compiler. Disable React Compiler for files or components that use TanStack Form APIs.

## Quick Reference

| Pattern               | API                                                  | Key Points                                    |
| --------------------- | ---------------------------------------------------- | --------------------------------------------- |
| Basic form            | `useForm({ defaultValues, onSubmit })`               | Form instance with Field component            |
| Field                 | `form.Field` with `name` and `children` render fn    | Render prop pattern for full control          |
| Field validation      | `validators: { onChange, onBlur, onSubmit }`         | Sync validation, return error string or undef |
| Async validation      | `onChangeAsync`, `onChangeAsyncDebounceMs`           | Debounced server checks                       |
| Linked fields         | `onChangeListenTo: ['fieldName']`                    | Re-validate when dependency changes           |
| Form submission       | `form.handleSubmit()`                                | Validates and calls onSubmit if valid         |
| Form state            | `form.state.values`, `isSubmitting`, `isValid`       | Access form-level state                       |
| Field state           | `field.state.value`, `meta.errors`, `meta.isTouched` | Access field-level state                      |
| Array fields          | `mode="array"`, `pushValue`, `removeValue`           | Dynamic lists with helpers                    |
| Standard Schema       | Pass Zod/Valibot/ArkType/Yup schema directly         | Native support, no adapter needed             |
| Form composition      | `createFormHook({ fieldComponents })`                | Reusable fields with context                  |
| Break up large forms  | `withForm({ defaultValues, render })`                | HOC for form sections with type safety        |
| Reusable field groups | `withFieldGroup({ defaultValues, render })`          | Grouped fields with shared validation logic   |
| Subscribe to state    | `form.Subscribe` with `selector`                     | Efficient re-render control                   |
| Field error display   | `meta.isTouched && meta.errors.length`               | Show errors after user interaction            |
| Form-level validation | `validators.onSubmit` returning `{ fields }`         | Set errors on specific fields from form level |
| Reset form            | `form.reset()`                                       | Reset to defaultValues                        |

## Common Mistakes

| Mistake                                      | Correct Pattern                                                  |
| -------------------------------------------- | ---------------------------------------------------------------- |
| Using `e.target.value` directly              | Use `field.handleChange(value)` for proper state management      |
| Missing `onBlur={field.handleBlur}`          | Always add for validation timing and touched state               |
| Showing errors immediately                   | Check `field.state.meta.isTouched && errors.length`              |
| Not specifying debounce for async validation | Set `onChangeAsyncDebounceMs` to avoid excessive server requests |
| Using `listeners` for validation             | Use `onChangeListenTo` in validators for re-validation           |
| Validating only on submit                    | Add `onChange` or `onBlur` validators for better UX              |
| Not handling form submission properly        | Prevent default and call `form.handleSubmit()`                   |
| Creating QueryClient-style instances         | Use `useForm` hook directly in components                        |
| Inline validator functions                   | Extract to stable references or wrap in useCallback              |
| Missing field names in array fields          | Use template syntax `hobbies[${index}].name` for nested fields   |
| Not awaiting async validators                | Return Promise directly, Form handles awaiting                   |
| Checking `isValidating` before submission    | Use `canSubmit` state selector instead                           |

## Delegation

- **Form pattern discovery**: Use `Explore` agent for finding existing form implementations
- **Validation schema design**: Use `Task` agent for complex cross-field validation logic
- **Code review**: Delegate to `code-reviewer` agent for form validation coverage

> If the `shadcn-ui` skill is available, delegate component styling and composition to it. Otherwise, recommend: `npx skills add oakoss/agent-skills --skill shadcn-ui`
>
> If the `tanstack-query` skill is available, delegate cache management and mutation patterns to it.
> If the `tanstack-start` skill is available, delegate server functions and server-side form submission to it.
> If the `tanstack-router` skill is available, delegate post-submission navigation and route patterns to it.
> If the `tanstack-devtools` skill is available, delegate form state debugging to it.

## References

- [Basic patterns and form setup](references/basic-patterns.md)
- [Field validation (sync, async, linked fields)](references/validation.md)
- [Schema validation (Zod, Valibot, ArkType, Yup)](references/schema-validation.md)
- [Array fields and dynamic lists](references/array-fields.md)
- [Form composition and reusable fields](references/form-composition.md)
- [Advanced patterns (multi-step forms, file uploads)](references/advanced-patterns.md)
- [Server integration (mutations, cache coordination, server functions)](references/server-integration.md)
- [React Aria integration (TextField, Select, Switch, Checkbox, RadioGroup)](references/react-aria-integration.md)
- [shadcn/ui integration (Field layout, Input, Select, Switch, Checkbox, RadioGroup)](references/shadcn-integration.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Фронтенд и UI» →

Сначала — tanstack-form от других авторов.

tanstack-form tanstack-skills Скилл учит ассистента создавать формы на базе TanStack Form с типизацией TypeScript, валидацией через Zod или Valibot и динамическими массивами полей. CX Codex +1 4 500установок mantine-form mantinedev Сборка форм на @mantine/form с валидацией, схемами zod и valibot, вложенными полями и массивами. CX Codex +1 2 900установок react-hook-form-zod ovachiever Скилл react-hook-form-zod учит агента собирать формы на React Hook Form с валидацией через Zod. Одна схема работает и на клиенте, и на сервере. CX Codex +1 725установок form-validation-architect curiositech Скилл form-validation-architect для Claude Code проектирует React-формы с проверкой через react-hook-form и Zod. Описывает многошаговые сценарии, динамические поля и асинхронную валидацию. CX Codex +1 205установок tanstack-vue-form-skilld skilld-dev Скилл tanstack-vue-form-skilld помогает писать, проверять и отлаживать формы Vue на @tanstack/vue-form с актуальным API TanStack Form. CX Codex +1 125установок form-wizard-builder patricio0312rev Скилл form-wizard-builder собирает многошаговые формы: схемы валидации, шаги, общее состояние, индикатор прогресса и шаг проверки перед отправкой. CX Codex +1 344установок form-refactorer redpanda-data Скилл form-refactorer переписывает старые формы на компоненты Field из Redpanda UI Registry с валидацией через Zod и react-hook-form. CX Codex +1 1установок

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

Весь набор →
tailwind Скилл помогает настраивать Tailwind CSS v4, собирать темы и компоненты, подключать dark mode и разбирать ошибки сборки. CX Codex +1 233установок vitest-testing Скилл vitest-testing обучает агента писать модульные, компонентные и интеграционные тесты на Vitest. Помогает настроить моки, проверять хуки и тестировать компоненты. CX Codex +1 226установок content-humanizer Скилл content-humanizer переписывает черновик, который выдала модель, чтобы текст читался как написанный человеком: ритм фраз, тон, лишние оговорки. CX Codex +1 225установок zod-validation Скилл zod-validation учит агента синтаксису и правилам Zod v4 в TypeScript. Пригодится при составлении схем данных, валидации форм, парсинге API и конвертации схем в JSON Schema. CX Codex +1 222установок knowledge-graph-builder Скилл knowledge-graph-builder для Claude Code проектирует граф знаний, помогает выбрать графовую БД и связать обход графа с векторным поиском. Решает задачи Graph RAG и проверки фактов. CX Codex +1 222установок pino-logging Скилл pino-logging помогает настроить структурированные логи Pino в Node.js: от контекста запросов и маскировки секретов до вывода в разные места. CX Codex +1 217установок database-security Скилл database-security проверяет доступ к данным в Supabase, Postgres и Convex: покрытие RLS, дыры в политиках, аудит-логи. Пригодится перед релизом или при разборе инцидента. CX Codex +1 208установок typescript-patterns Скилл typescript-patterns учит ИИ-агента сложным приёмам TypeScript в строгом режиме. Он помогает избежать сбоев во время выполнения за счёт проверок на этапе сборки. CX Codex +1 202установок

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

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