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

formkit-core-skilld — скилл для Claude Code: работа с @formkit/core

Скилл formkit-core-skilld для Claude Code помогает писать, отлаживать и проверять код для @formkit/core: узлов, значений, событий и хуков.

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

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

Что делает formkit-core-skilld

FormKit состоит из адаптеров (Vue, React) и типов ввода, но суть — в @formkit/core: каждый инпут, группа, список и форма это FormKitNode в дереве. Скилл предоставляет сигнатуры API версии 2.1.2, примеры создания узлов, прослушивания событий, регистрации middleware, работы со сторой и реестром. Показывает, когда нужны другие пакеты (@formkit/vue для компонентов, @formkit/validation для правил).

В скилле описаны ключевые правила: как безопасно устанавливать значения через input(), почему нельзя мутировать сообщения, когда избегать горячих путей, как синхронизировать узлы с одинаковыми именами. Все примеры кода работают для версии @formkit/[email protected], с ESM модулями и fallback для CJS.

Единая зависимость — @formkit/utils@^2.1.2, что упрощает интеграцию в проект.

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

  • Создать дерево узлов формы программно и отследить изменения значений
  • Написать middleware для преобразования данных при коммите или валидации
  • Достичь узла по ID и подписаться на его события в реестре
  • Избежать ошибок типа 107/108 при работе с группами и списками
  • Скомпилировать условие схемы с переменными и операторами

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

  • Помоги мне создать форму из трёх полей через createNode и синхронизировать их с помощью хуков
  • Какой правильный способ слушать события коммита и очищать подписки в @formkit/core
  • Напиши плагин, который добавляет цвет всем узлам в зависимости от их типа

Как установить formkit-core-skilld

1Через Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill formkit-core-skilld -a claude-code

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

~/.claude/skills/formkit-core-skilld/SKILL.md

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

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

Вопросы о formkit-core-skilld

Как установить formkit-core-skilld в Claude Code?

Выполни в терминале npx skills add skilld-dev/vue-ecosystem-skills --skill formkit-core-skilld -a claude-code, затем открой ~/.claude/skills/formkit-core-skilld/SKILL.md. Для других платформ команда меняется: например, для Cursor — npx skills add skilld-dev/vue-ecosystem-skills --skill formkit-core-skilld -a cursor и затем .cursor/skills/formkit-core-skilld/SKILL.md.

Что делает formkit-core-skilld?

Скилл содержит справку по API @formkit/core 2.1.2 (создание узлов, события, хуки, типы), примеры типичных задач и поведенческие правила, которые предотвращают ошибки. Используй его при работе с кодом, который импортирует @formkit/core.

Когда нужно использовать @formkit/vue или @formkit/react вместо core?

Используй @formkit/vue / @formkit/react, если нужны компоненты <FormKit> и defaultConfig, @formkit/validation для правил, @formkit/i18n для локализации. Для типов ввода (text, select) нужен @formkit/inputs. Скилл охватывает только @formkit/core.

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

SKILL.md · MIT
---
name: formkit-core-skilld
description: Use whenever writing, debugging, or reviewing code that imports @formkit/core — FormKit's framework-agnostic core (node trees, values, events, hooks, message stores, ledgers, config, schema types, expression compiler). Provides correct 2.1.x API signatures, common-task examples, behavioral rules, and version limits.
license: MIT
---

# @formkit/core 2.1.2

Framework-agnostic core of FormKit. Every input, group, list, and form is a
`FormKitNode` in a tree. Vue and React adapters (`@formkit/vue`,
`@formkit/react`) render these nodes; input types, validation, and i18n live in
sibling packages, not here. Scope this Skill to `@formkit/core` imports only.

- Package: `@formkit/[email protected]`, ESM (`"type": "module"`) with CJS fallback,
  plus a `development` condition build (`package.json:8-21`).
- Sole dependency: `@formkit/utils@^2.1.2` (`package.json:38-40`).
- Docs: https://formkit.com/essentials/architecture
- API reference: https://formkit.com/api-reference/core

## When to use another package

| Need | Package |
| --- | --- |
| `<FormKit>` components, `defaultConfig`, `createInput` | `@formkit/vue` / `@formkit/react` |
| Input type definitions (`text`, `select`…) | `@formkit/inputs` |
| Validation rules | `@formkit/validation` |
| Locale messages | `@formkit/i18n` |
| Schema *rendering* | `@formkit/vue` (types + compiler are here) |

## Public API

Runtime exports (`dist/index.mjs:1919`): `bfs`, `clearErrors`, `compile`,
`createClasses`, `createConfig`, `createMessage`, `createNode`,
`createPlaceholder`, `createValue`, `deregister`, `error`, `errorHandler`,
`generateClassList`, `getNode`, `isComponent`, `isConditional`, `isDOM`,
`isList`, `isNode`, `isPlaceholder`, `isSugar`, `names`, `register`, `reset`,
`resetCount`, `resetRegistry`, `setErrors`, `stopWatch`, `submitForm`,
`sugar`, `use`, `useIndex`, `valueInserted`, `valueMoved`, `valueRemoved`,
`warn`, `warningHandler`, `watchRegistry`, `FORMKIT_VERSION` — plus ~70 public
types (`dist/index.d.mts:2329`).

## Common tasks

### Create a node tree

```ts
import { createNode } from '@formkit/core'

const email = createNode({ name: 'email' })
const form = createNode({
  type: 'group',            // 'input' (default) | 'group' | 'list'
  children: [email, createNode({ name: 'password' })],
})
form.at('email')            // → the email node
```

Group values are objects keyed by child `name`; list values are arrays keyed
by child index (`dist/index.mjs:714-723`). Full option table:
[node API](./references/node-api.md).

### Set a value and await settlement

```ts
await email.input('[email protected]')  // debounced, async commit
email.value                            // committed value
```

Never assign `node.value = x` directly. `input()` debounces (default 20 ms on
input nodes, `dist/index.mjs:1255-1267`), then commits through the `commit`
hook (`dist/index.mjs:759-765`). `await node.settled` resolves when the whole
subtree finished committing (`dist/index.d.mts:1856-1860`).

### Listen to events (and clean up)

```ts
const receipt = form.on('commit.deep', ({ payload }) => { ... })
// later:
form.off(receipt)
```

`.deep` catches events bubbling from descendants (`dist/index.mjs:47-53`).
`on()` returns a receipt; always pass it to `off()`. Core event table:
[events and hooks](./references/events-hooks.md).

### Register hook middleware

```ts
node.hook.commit((value, next) => next(transform(value)))
```

Middleware signature is `(payload, next) => next(payload)`; hooks:
`classes`, `commit`, `error`, `setErrors`, `init`, `input`, `message`,
`prop`, `text`, `schema` (`dist/index.d.mts:579-600`). Register inside plugins
for reuse.

### Write a plugin

```ts
import { createNode } from '@formkit/core'
import type { FormKitPlugin } from '@formkit/core'

const colorize: FormKitPlugin = (node) => {
  node.props.color = node.type === 'group' ? 'yellow' : 'teal'
  // return false to stop inheritance by children
}
createNode({ type: 'group', plugins: [colorize], children: [createNode()] })
```

Plugins are inherited by descendants and run once per node. Attach
`plugin.library` to define custom input types via `node.define()`.

### Store a message; count with the ledger

```ts
import { createMessage, createNode } from '@formkit/core'

const node = createNode()
node.store.set(createMessage({ key: 'limit', value: 'Too many!' }))
node.store.limit.value                       // 'Too many!'
node.ledger.count('visible', (m) => m.visible)
node.on('count:visible', ({ payload }) => console.log(payload))
```

Details: [store and ledger](./references/store-ledger.md).

### Reach a node by id

```ts
import { createNode, getNode, watchRegistry, stopWatch } from '@formkit/core'

const node = createNode({ props: { id: 'manufacturer' } }) // root nodes register
getNode('manufacturer')                    // FormKitNode | undefined
const receipt = watchRegistry('manufacturer', (e) => { ... })
stopWatch(receipt)
```

Root nodes (or nodes with `props.alias`) register automatically
(`dist/index.d.mts:2220-2228`). Details:
[registry and helpers](./references/registry-helpers.md).

### Set errors, reset, submit

```ts
import { setErrors, clearErrors, reset, submitForm } from '@formkit/core'

setErrors('myForm', 'Server rejected', { email: ['Already taken'] })
reset('myForm', { email: '' })   // resetTo becomes the new initial value
clearErrors('myForm', true)      // true clears children too
submitForm('myForm')             // dispatches a submit DOM event
```

### Compile a schema expression

```ts
import { compile } from '@formkit/core'

const condition = compile("$name == 'bob'").provide((tokens) => {
  return { name: () => nameRef.value }   // each token must return a function
})
condition()  // false
```

Operators: `&& || == != === !== > < >= <= + - * / %` (`dist/index.mjs:1574-1598`).
Schema node types and guards: [schema and compiler](./references/schema-compiler.md).

## Behavioral rules that prevent bugs

- Read config through `node.props`, not `node.config`; explicit props and
  parent config are merged into props (`dist/index.d.mts:729-792`).
- Setting a root config property emits `config:{prop}` on the origin and
  `prop` / `prop:{prop}` on every inheriting node that does not override it
  (`dist/index.mjs:1283-1289`).
- `group` nodes require object values, `list` nodes require arrays; violations
  throw error 107 / 108 (`dist/index.mjs:745-757`).
- Messages are immutable (`Readonly<FormKitMessageProps>`,
  `dist/index.d.mts:70-75`); replace via `store.set()`, never mutate.
- `node.walk()` traverses the subtree without the node itself and is expensive;
  reserve it for rare lifecycle moments (`dist/index.d.mts:1885-1890`).
- Avoid two same-`name` siblings under one parent; if unavoidable, sync them
  with `config.mergeStrategy = { fieldName: 'synced' }`
  (`dist/index.d.mts:721-725`).
- `node.root` traverses on every read; do not call it in hot paths
  (`dist/index.d.mts:1840-1843`).
- Replace core error handling by registering middleware on the exported
  `errorHandler` / `warningHandler` dispatchers (`dist/index.d.mts:2151-2157`).

## Version limits

- Written against `@formkit/[email protected]` (published 2026-07-24).
- 2.x changes since 2.0.0 are bug fixes in reset, registry cleanup, and the
  compiler; no core API breaks. See
  [API changes](./references/api-changes.md).
- `FORMKIT_VERSION` is a build-time placeholder (`"__FKV__"`) in the prepared
  source; do not branch on it (`dist/index.d.mts:2321-2327`).

## References

- [Node API](./references/node-api.md) — creation, types, traps, value flow, settlement, traversal
- [Events and hooks](./references/events-hooks.md) — emitter, receipts, `.deep`, event table, hook middleware
- [Store and ledger](./references/store-ledger.md) — messages, `createMessage`, counters
- [Config, props, plugins](./references/config-props-plugins.md) — inheritance, `createConfig`, `mergeStrategy`, libraries
- [Schema and compiler](./references/schema-compiler.md) — schema node types, guards, `sugar()`, `compile()`
- [Registry and helpers](./references/registry-helpers.md) — `getNode`, `setErrors`, `reset`, `submitForm`, error codes
- [API changes](./references/api-changes.md) — 2.0.0 → 2.1.2

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

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

Все скиллы по теме «Фронтенд и UI» →
nuxt-core Claude Skills Maintainers Скилл nuxt-core для ИИ-агента: подсказывает, как устроен Nuxt 4 — структура каталогов, конфиг, роутинг, SEO и обработка ошибок. CX Codex +1 408установок rollup-bundler Mindrally Скилл rollup-bundler задаёт агенту правила конфигурации Rollup.js: форматы вывода, внешние зависимости, tree-shaking и плагины для сборки библиотек. CX Codex +1 696установок migrate-js-to-modern-typescript pproenca Скилл migrate-js-to-modern-typescript пошагово переводит проект с JavaScript на строгий TypeScript, настраивает tsconfig и помогает отказаться от any без поломки сборки. CX Codex +1 145установок maplibre-v6-migration maplibre Скилл maplibre-v6-migration для Claude Code разбирает семь поломок при переходе с MapLibre GL JS v5 на v6: ESM-сборку, импорты, резолвер иконок, map.transform и типы событий. Выявляет причины пустой карты после обновления. CX Codex +1 286установок tanstack-cli oakoss Скилл tanstack-cli настраивает сборку библиотек через TanStack Config и Vite с генерацией типов и релизом через conventional commits. CX Codex +1 115установок vue-best-practices github.com/vuejs-ai Скилл vue-best-practices задаёт стандарты разработки на Vue 3 с Composition API и TypeScript. Пригодится при написании SFC-компонентов, composables и настройке реактивности. CX Codex +1 45 800установок

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

Весь набор →
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установок vitepress-skilld Скилл vitepress-skilld даёт агенту справочник по API, настройкам и CLI VitePress 1.6.4 при сборке сайтов документации. CX Codex +1 110установок tanstack-ai-vue-skilld Скилл tanstack-ai-vue-skilld помогает писать и отлаживать Vue 3-код с @tanstack/ai-vue: чат, генерация медиа и типизированные инструменты. CX Codex +1 110установок unhead-vue-skilld Скилл unhead-vue-skilld помогает ИИ-агенту настраивать теги head, метаданные SEO и скрипты в проектах на Vue 3 через библиотеку @unhead/vue. CX Codex +1 105установок tanstack-vue-router-skilld Скилл tanstack-vue-router-skilld для работы с @tanstack/vue-router — типобезопасным роутером Vue. Учит агента правилам настройки, file-based маршрутов, композаблов с Ref, линков и лоадеров. CX Codex +1 101установок tanstack-vue-store-skilld Скилл tanstack-vue-store-skilld для Claude Code направляет агента при разработке стейт-менеджмента на @tanstack/vue-store в проектах на Vue. Подключается при импорте библиотеки и настройке хранилищ. CX Codex +1 100установок

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

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