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

arktype-validation — скилл для Claude Code

Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv.

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

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

Что делает arktype-validation

Скилл учит агента писать схемы ArkType строками, похожими на типы TypeScript: type({ id: "number", email: "string.email" }). Схема остаётся строкой, поэтому редактор подсказывает и подсвечивает её как обычный тип. Внутри три справочных файла: типы схем, морфы вместе со scope(), частые паттерны. Последний разбирает парсинг JSON, валидацию форм и ответов API, а ещё переменные окружения через ArkEnv с автоприведением типов и Vite-плагином.

Отдельная таблица собрана из ошибок, при которых схема молча не срабатывает: скобки в string.email(), проверка через === null вместо instanceof type.errors, необязательное поле, записанное как "key": "string?" вместо "key?": "string".

Скилл написан под ArkType и Zod не заменяет. Проекту, которому нужна совместимость с экосистемой Zod или вывод в JSON Schema, ArkType не подойдёт — это сказано прямым текстом.

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

  • описать схему объекта строками в синтаксисе TypeScript
  • проверить JSON-пейлоад до того, как он дойдёт до обработчика
  • привести переменные окружения к нужным типам на старте
  • связать несколько типов через scope() с перекрёстными ссылками
  • обрезать пробелы или распарсить JSON до самой валидации

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

  • Опиши схему ArkType для объекта user, поле email необязательное и с проверкой формата.
  • Провалидируй process.env через arkenv(), чтобы PORT получился числом.
  • Почему type("string.email()") не работает? Покажи вариант, который проходит.

Как установить arktype-validation

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill arktype-validation -a claude-code

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

~/.claude/skills/arktype-validation/SKILL.md

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

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

Вопросы об arktype-validation

Как установить arktype-validation в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill arktype-validation -a claude-code. Файл скилла окажется по пути ~/.claude/skills/arktype-validation/SKILL.md.

Что делает arktype-validation?

Даёт агенту справочник по ArkType: строковые схемы, морфы и трансформации, scope() для перекрёстных ссылок, дженерики, обработка ошибок. Плюс ArkEnv для проверки переменных окружения и Vite-плагин к нему.

Этот скилл заменяет Zod?

Нет. Для Zod-схем в наборе есть отдельный скилл, а ArkType не рассчитан на совместимость с экосистемой Zod и на вывод JSON Schema.

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

SKILL.md · MIT
---
name: arktype-validation
description: 'ArkType runtime validation with TypeScript-native syntax. Type-safe schemas using string expressions, morphs, scopes, and generics. Includes ArkEnv for typesafe environment variable validation with auto-coercion and Vite plugin. Use when defining schemas, validating data, transforming input, building type-safe APIs with ArkType, or validating environment variables with ArkEnv.'
license: MIT
metadata:
  author: oakoss
  version: '1.2'
user-invocable: false
---

# ArkType Validation

## Overview

ArkType is a TypeScript-native runtime validation library that defines schemas using string expressions mirroring TypeScript syntax, providing editor autocomplete, syntax highlighting, and optimized validators. Use when building type-safe APIs, validating JSON payloads, or replacing Zod with a more TypeScript-idiomatic approach. Not suitable for projects that need Zod ecosystem compatibility or JSON Schema output.

**Package:** `arktype`

## Quick Reference

| Pattern                           | Usage                                           |
| --------------------------------- | ----------------------------------------------- |
| `type({ key: "string" })`         | Define object schema                            |
| `type("string")`                  | Primitive type                                  |
| `"string.email"`, `"string.url"`  | Built-in string validators                      |
| `"string.trim"`, `"string.lower"` | Built-in string morphs (transforms)             |
| `"string.json.parse"`             | Parse JSON string to validated object           |
| `"number > 0"`, `"string >= 1"`   | Inline constraints                              |
| `"string \| number"`              | Union types                                     |
| `"'a' \| 'b' \| 'c'"`             | String literal unions                           |
| `"string[]"`                      | Array types                                     |
| `"key?": "string"`                | Optional properties                             |
| `"key = 'default'"`               | Default values                                  |
| `.pipe()`, `.to()`                | Transform output (morphs)                       |
| `.narrow()`                       | Custom validation (like Zod refine)             |
| `.pick()`, `.omit()`              | Object property selection                       |
| `.merge()`                        | Combine object types                            |
| `scope({...}).export()`           | Named type scopes with cross-references         |
| `type("<t>", { box: "t" })`       | Generic type definitions                        |
| `type.errors`                     | Error handling (check `instanceof type.errors`) |
| `.assert(data)`                   | Throws on invalid input instead of returning    |
| `"(number % 2)#even"`             | Branding — type-only validated marker           |
| `"0 <= number <= 100"`            | Compact range constraints                       |
| `configure()`                     | Global defaults (from `arktype/config`)         |
| `match()`                         | Type-safe pattern matching (2.1)                |
| `"+" : "reject"`                  | Inline undeclared key handling                  |
| `arkenv({ PORT: "number" })`      | Typesafe env var validation (ArkEnv)            |
| `arkenvVitePlugin(Env)`           | Build-time env validation for Vite              |

## Common Mistakes

| Mistake                               | Fix                                             |
| ------------------------------------- | ----------------------------------------------- |
| `type("string.email()")` with parens  | `type("string.email")` (no parens)              |
| Checking errors with `=== null`       | Use `instanceof type.errors`                    |
| `{ key: "string?" }` for optional     | `{ "key?": "string" }` (question mark on key)   |
| Importing from `arktype/types`        | Import `type` and `scope` from `"arktype"`      |
| Nested `type()` in string expressions | Use `scope()` for cross-referencing types       |
| Raw `.pipe()` without error handling  | Use `.pipe.try()` for operations that can throw |
| `"string.lowercase"` for case morph   | `"string.lower"` (also `"string.upper"`)        |
| Configuring after importing `arktype` | Import `arktype/config` before `arktype`        |
| Manual `process.env` parsing          | Use `arkenv()` for auto-coercion and validation |

## Delegation

Use this skill for ArkType schema definitions, runtime validation, morphs/transforms, scopes, and type inference. For Zod-based validation, delegate to the zod-validation skill.

## References

- [Schema Types](references/schema-types.md) — primitives, string keywords, number constraints, objects, arrays, tuples, unions, optional, defaults
- [Morphs and Scopes](references/morphs-and-scopes.md) — pipe, morph transforms, narrow validation, scopes, recursive types, generics, global configuration, pattern matching
- [Common Patterns](references/common-patterns.md) — JSON parsing, form validation, API responses, error handling, ArkEnv environment variables, Vite plugin, comparison with Zod

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Бэкенд и API» →
zod-validation-utilities giuseppe-trisciuoglio Скилл zod-validation-utilities для Claude Code и Codex: создание переиспользуемых схем Zod v4 с полной типизацией TypeScript для валидации API-запросов, форм и конфигураций. CX Codex +1 4 100установок zod-schema-validation Mindrally Скилл zod-schema-validation задаёт правила валидации данных через Zod и вывода типов TypeScript на границах системы: в API, формах и внешних ответах. Помогает писать схемы без лишнего дублирования. CX Codex +1 1 200установок hono-validation bobmatnyc Скилл hono-validation для Claude Code и Cursor: валидирует JSON, формы, query-параметры, заголовки и cookie в Hono. Типы из схемы доступны прямо в обработчике. CX Codex +1 427установок zod-validation-expert davila7 Скилл zod-validation-expert настраивает Claude Code на генерацию схем валидации Zod, вывод типов через z.infer и связку с формами React Hook Form или экшенами Next.js. CX Codex +1 238установок valibot open-circle Скилл учит агента Claude Code работать с Valibot: создавать схемы, парсить ввод и не путать синтаксис с Zod. В проекте, где уже установлена эта библиотека, агент сможет писать валидацию без ошибок. CX Codex +1 2 200установок zod bobmatnyc Скилл по библиотеке zod: схемы один раз, а на выходе проверка данных в рантайме и типы TypeScript. Пригодится на формах и API. CX Codex +1 907установок

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

Весь набор →
pglite Скилл по PGlite: подсказывает агенту, как поднять сборку PostgreSQL 17.4 на WASM в браузере или Node.js, выбрать хранилище и настроить live-запросы. CX Codex +1 156установок tanstack-table Настраивает headless-таблицы TanStack Table v8 в React: серверная пагинация, фильтры и сортировка без циклических ререндеров. CX Codex +1 155установок changesets Скилл changesets помогает вести версии и changelog пакетов в монорепозитории. Он пригодится для согласованных релизов и публикации пакетов в npm. CX Codex +1 154установок opentofu Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок tanstack-router Скилл tanstack-router настраивает типобезопасную файловую маршрутизацию в React через @tanstack/react-router. Помогает с лоадерами данных, валидацией параметров поиска и разделением кода. CX Codex +1 150установок api-testing Скилл api-testing для Claude Code помогает писать интеграционные тесты REST API и проверять ответы эндпоинтов. Включается при настройке HTTP-моков или тестировании ошибок. CX Codex +1 149установок github-actions Помогает создавать и настраивать GitHub Actions workflows: от триггеров и матриц сборки до кеширования и аутентификации. Автоматизирует тесты, релизы и развёртывание. CX Codex +1 149установок git-workflow Скилл git-workflow помогает агенту выстраивать trunk-based разработку, оформлять conventional commits, настраивать пайплайны GitHub Actions и чистить историю Git. CX Codex +1 149установок

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

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