arktype-validation — скилл для Claude Code
Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv.
MIT 153 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill arktype-validation -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/arktype-validation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/arktype-validation/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill arktype-validation -a codex2Вручную: положить файлы
.agents/skills/arktype-validation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill arktype-validation -a cursor2Вручную: положить файлы
.cursor/skills/arktype-validation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/arktype-validation2Вручную: положить файлы
.github/skills/arktype-validation/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill arktype-validation -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/arktype-validationВручную: положить файлы
.devin/skills/arktype-validation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill arktype-validation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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