openapi-to-typescript — скилл для Claude Code: генерация типов
Скилл преобразует спецификацию OpenAPI 3.0 в TypeScript-интерфейсы, типы запросов и ответов и проверки типов. Пригодится, когда API-описание нужно перенести в код.
npx claude-code-templates@latest --skill development/openapi-to-typescriptЧто делает openapi-to-typescript
Скилл читает JSON- или YAML-файл OpenAPI 3.0, проверяет структуру и берёт схемы из components/schemas, а параметры и ответы — из paths. По ним он создаёт TypeScript-интерфейсы и type guards. Обязательные поля становятся обязательными в интерфейсе, необязательные получают ?; также учитываются перечисления и ссылки $ref.
Перед генерацией в спецификации должны быть поле openapi с версией 3.0, paths и, если описаны типы, components.schemas. При ошибке проверки скилл останавливается, поэтому спецификация другой версии не пройдёт. Скилл также добавляет тип ApiError и соответствующую проверку. Он уточняет, куда сохранить файл; предложенный путь — types/api.ts в текущем каталоге.
Какие задачи решает
- сгенерировать интерфейсы TypeScript по схемам OpenAPI
- описать типы параметров и ответов API
- создать проверки данных по обязательным полям
- перенести перечисления и ссылки
$refв типы
Примеры запросов агенту
- Создай TypeScript-типы по спецификации
api.yaml. - Преобразуй
openapi.jsonв интерфейсы и проверки для запросов и ответов. - Проверь спецификацию OpenAPI 3.0 и сохрани результат в
types/api.ts.
Как установить openapi-to-typescript
1Через claude-code-templates
npx claude-code-templates@latest --skill development/openapi-to-typescript2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill openapi-to-typescript -a claude-code3Вручную: положить файлы
~/.claude/skills/openapi-to-typescript/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/openapi-to-typescript/
Вручную: положить файлы
.agents/skills/openapi-to-typescript/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/openapi-to-typescript/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates openapi-to-typescript2Вручную: положить файлы
.github/skills/openapi-to-typescript/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/openapi-to-typescriptВручную: положить файлы
.devin/skills/openapi-to-typescript/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о openapi-to-typescript
Как установить openapi-to-typescript в Claude Code?
Выполните npx claude-code-templates@latest --skill development/openapi-to-typescript. Затем укажите агенту путь к файлу OpenAPI.
Что делает openapi-to-typescript?
Скилл читает спецификацию OpenAPI 3.0 и генерирует TypeScript-интерфейсы для схем, запросов и ответов, а также type guards.
Какие спецификации принимает openapi-to-typescript?
Файл должен быть в JSON или YAML и описывать OpenAPI 3.0.x. Проверяются поля openapi и paths; components.schemas требуется, если в спецификации есть типы.
