AIKraft/AI/Войти
AIKraft/Skills/orval

orval

Генерирует типобезопасные API-клиенты, хуки, схемы Zod и моки из OpenAPI-спецификаций. Поддерживает React, Vue, Svelte, Angular, Fetch, Axios и другие. Пригодится для автоматизации интеграции с бэкендом.

OLorval-labs official Разработка ★ 6.5k

Что делает навык

Orval — это генератор кода на TypeScript, который создает типобезопасные API-клиенты, хуки, схемы Zod, моки и серверные обработчики на основе спецификаций OpenAPI v3 или Swagger v2. Он решает задачу автоматизации интеграции с бэкендом, исключая необходимость ручного написания типов и запросов.

Когда применять

  • Автоматическая генерация клиентских библиотек для взаимодействия с REST API на основе готовой OpenAPI-спецификации.
  • Создание типобезопасных хуков для фронтенд-фреймворков (React, Vue, Svelte, Angular) для упрощения работы с данными.
  • Генерация валидаторов и схем Zod для обеспечения целостности данных на основе контрактов API.
  • Создание моков и серверных обработчиков для изолированной разработки фронтенда без запущенного бэкенда.

Как работает

  1. Установить пакет orval в проект как зависимость для разработки (devDependency) с помощью npm, yarn, pnpm или bun.
  2. Создать конфигурационный файл (например, orval.config.ts), импортировав функцию defineConfig из пакета orval.
  3. Настроить путь к OpenAPI-спецификации (файлу .yaml или .json) в параметре input конфигурации.
  4. Настроить параметры вывода (output), указав директорию для сгенерированных файлов и предпочтительный клиент (например, axios или fetch).
  5. Запустить команду генерации кода, которая прочитает спецификацию и создаст типобезопасные модули, хуки и схемы.

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

Сгенерируй типобезопасные хуки и клиент axios для моего API, используя спецификацию из файла openapi.yaml.
Настрой Orval для создания схем Zod и моков на основе текущей OpenAPI-спецификации проекта.
Инициализируй Orval в проекте и создай минимальную конфигурацию для генерации кода из Swagger v2 документа.

Что понадобится

  • Node.js окружение
  • Менеджер пакетов (npm, yarn, pnpm или bun)
  • OpenAPI v3 или Swagger v2 спецификация (файл .yaml или .json)

Описание составлено по SKILL.md навыка, сверено 09.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «orval» из репозитория: # https://github.com/orval-labs/orval
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r orval/ ~/.claude/skills/orval/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.