regle — скилл для Claude Code: формы Vue 3 и установка
Скилл regle для Claude Code помогает добавлять и менять формы с валидацией Regle в Vue 3. Он подсказывает, как связать поля с r$ и показывать ошибки.
MIT 269 установок ★ 730 обновлён 2026-11-10
npx skills add onmax/nuxt-skills --skill regle -a claude-codeЧто делает regle
regle объясняет, как настроить useRegle, описать состояние формы и правила для её полей. Возвращаемый реактивный объект r$ хранит значения и ошибки, а также предоставляет методы валидации и сброса.
Скилл охватывает $error, $errors, $invalid, $validate и $reset, вывод ошибок и модификаторы. Он подключается при работе над формой Regle, в том числе когда нужно привязать v-model к r$.$value. Для проекта требуются Vue 3.3+ и TypeScript 5.1+.
Какие задачи решает
- настроить
useRegleдля состояния формы и её правил - связать поле формы через
v-modelиr$.$value - показать ошибки через
$errorsи управлять валидацией - сбросить состояние формы с помощью
$reset
Примеры запросов агенту
- Добавь в форму Vue валидацию Regle через
useRegle. - Свяжи поля формы с
r$.$valueи покажи ошибки. - Объясни, как проверить форму через
$validateи сбросить её через$reset.
Как установить regle
1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill regle -a claude-code2Вручную: положить файлы
~/.claude/skills/regle/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/regle/
1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill regle -a codex2Вручную: положить файлы
.agents/skills/regle/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill regle -a cursor2Вручную: положить файлы
.cursor/skills/regle/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install onmax/nuxt-skills skills/regle2Вручную: положить файлы
.github/skills/regle/SKILL.md1Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill regle -a gemini-cli2Командой платформы
gemini skills install https://github.com/onmax/nuxt-skills --path skills/regleВручную: положить файлы
.devin/skills/regle/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add onmax/nuxt-skills --skill regle -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о regle
Как установить regle в Claude Code?
Выполни npx skills add onmax/nuxt-skills --skill regle -a claude-code. Файл скилла находится по пути ~/.claude/skills/regle/SKILL.md.
Что делает скилл regle?
Он помогает настраивать валидацию форм Regle в Vue 3: состояние и правила полей, реактивный объект r$, вывод ошибок и методы валидации.
Что нужно для работы regle?
Для проекта нужны Vue 3.3+ и TypeScript 5.1+. Для базовой валидации используются пакеты @regle/core и @regle/rules; поддержка схем подключается отдельно через @regle/schemas.
Исходный текст
SKILL.md · MIT
---
name: regle
description: Core Regle form validation in Vue 3 — setup with `useRegle`, the reactive `r$` object, validation properties, displaying errors, and modifiers. Use when adding or editing Regle forms, binding `v-model` to `r$.$value`, or reading `$error`/`$errors`/`$invalid`/`$validate`/`$reset`. For validation rules see regle-rules; for advanced patterns see regle-advanced.
license: MIT
compatibility: Requires Vue 3.3+ and TypeScript 5.1+. Works with any agent supporting the Agent Skills spec.
metadata:
author: Victor Garcia
version: "1.27.0"
source: https://reglejs.dev
---
# Regle
Regle is a type-safe, model-based, headless form validation library for Vue 3. It provides full TypeScript inference, reactive validation, and works with any UI framework or design system.
## MCP Server
Regle provides an MCP server that can be used to get documentation and autocomplete for Regle. If it's available, use it to get up-to-date information on the API.
```json
{
"mcpServers": {
"regle": {
"command": "npx",
"args": ["@regle/mcp-server"]
}
}
}
## Installation
```sh
# Core + built-in rules
pnpm add @regle/core @regle/rules
# Optional: schema support (Zod, Valibot, ArkType)
pnpm add @regle/schemas
```
Requires Vue 3.3+ and TypeScript 5.1+.
## Quick Start
```ts
import { useRegle } from '@regle/core';
import { required, email, minLength } from '@regle/rules';
const { r$ } = useRegle(
{ name: '', email: '' },
{
name: { required, minLength: minLength(3) },
email: { required, email },
}
);
```
```vue
<template>
<input v-model="r$.$value.name" placeholder="Name" />
<ul v-if="r$.$errors.name.length">
<li v-for="error of r$.$errors.name" :key="error">{{ error }}</li>
</ul>
<button @click="r$.$validate()">Submit</button>
</template>
```
## Key Concepts
- **State**: first argument -- raw object, `reactive`, `ref`, or single value
- **Rules**: second argument -- mirrors the data structure, each field gets a rules object
- **`r$`**: returned reactive object with values, errors, dirty state, and validation methods
- All rules are optional by default; add `required` to enforce a field
## Core
| Topic | Description | Reference |
|-------|-------------|-----------|
| useRegle | State definition, rules declaration, dynamic rules, `r$` object | [core-use-regle](references/core-use-regle.md) |
| Validation Properties | `$invalid`, `$dirty`, `$error`, `$errors`, `$pending`, `$validate`, `$touch`, `$reset` | [core-validation-properties](references/core-validation-properties.md) |
| Displaying Errors | Showing errors, custom messages, `getErrors`, `flatErrors` | [core-displaying-errors](references/core-displaying-errors.md) |
| Modifiers | `autoDirty`, `lazy`, `silent`, `rewardEarly`, `disabled`, `validationGroups`, per-field modifiers | [core-modifiers](references/core-modifiers.md) |
## Related skills
- **regle-rules** — built-in rules, custom rules (`createRule`), rule wrappers (`withMessage`, `withParams`, `withAsync`), and rule operators (`and`, `or`, `applyIf`, `assignIf`).
- **regle-advanced** — collections, async, server errors, reset, scoped validation, variants, global config.
- **regle-schemas** — Zod, Valibot, ArkType, and Standard Schema integration.
- **regle-typescript** — type-safe output, typing rules schemas and component props.
© Victor Garcia · MIT · onmax/nuxt-skills