# openapi

Скилл подсказывает ИИ-агенту структуру документов OpenAPI 3.x: обязательные поля, операции, схемы, параметры и безопасность.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 125 установок · ★ 23 у репозитория
- Автор: itechmeat
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/itechmeat/llm-code/tree/HEAD/skills/openapi/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/itechmeat-openapi

## Что делает

Скилл даёт агенту опору по OpenAPI 3.x: обязательные поля документа, объекты `info`, `servers`, `paths`, `components`, описание операций, параметров и схем безопасности. Внутри — пять справочников в `references/`: структура документа, операции и пути, схемы и типы, параметры с сериализацией, безопасность.

Примеры рабочие: объект `User` с `format: uuid`, композиция через `allOf`, полиморфизм через `oneOf` с `discriminator`, nullable через массив типов из OAS 3.1+. Таблица разводит расположения параметров (`path`, `query`, `header`, `cookie`, `querystring`) и стили (`simple`, `form`, `matrix`, `label`, `deepObject`). Версия спецификации здесь 3.2.0, и на ней легко спутать два поля: `openapi` в шапке — это версия OAS, а версия самого API живёт в `info.version`. Второе поле обязательное.

Ставится одной командой `npx skills add`, внутри текстовые справочники рядом с `SKILL.md`. `operationId` у каждой операции свой: на нём держится генерация клиента или сервера из спеки, дубли её сбивают.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill openapi -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/openapi/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/openapi/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill openapi -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/openapi/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill openapi -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/openapi/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install itechmeat/llm-code skills/openapi
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/openapi/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill openapi -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/itechmeat/llm-code --path skills/openapi
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/openapi/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill openapi -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/itechmeat/llm-code/tree/HEAD/skills/openapi/SKILL.md

## Когда брать
- написать спеку с нуля по структуре OAS 3.x
- развести параметры по `path`, `query` и `header`
- описать OAuth2 или API-ключ в `securitySchemes`
- собрать модель ответа из `allOf` и `oneOf`
- проверить готовый документ перед генерацией клиента

## Примеры запросов агенту
- Опиши эндпоинт `GET /users/{id}` в спеке OpenAPI 3.2 и добавь ответ 404.
- Проверь мой `openapi.yaml`: обязательные поля на месте, схемы безопасности описаны?
- Сделай `Pet` через `oneOf` с `discriminator` по полю `petType`.

## Похожие
- [route-to-openapi](https://affpapa.org/nevibecode/skills/route-to-openapi.md) — скилл · ★ 4719 у репозитория
- [spring-boot-openapi-documentation](https://affpapa.org/nevibecode/skills/spring-boot-openapi-documentation.md) — скилл · 4200 установок
- [openapi-expert](https://affpapa.org/nevibecode/skills/openapi-expert.md) — скилл · 282 установки
- [openapi-spec-writer](https://affpapa.org/nevibecode/skills/openapi-spec-writer.md) — скилл · 175 установок
- [api-documenter](https://affpapa.org/nevibecode/skills/api-documenter.md) — скилл · 727 установок
- [api-reference-documentation](https://affpapa.org/nevibecode/skills/secondsky-api-reference-documentation.md) — скилл · 472 установки

## Другие версии с тем же именем
- [openapi · codewithmukesh](https://affpapa.org/nevibecode/skills/openapi.md) — 4000 установок
- [openapi · oakoss](https://affpapa.org/nevibecode/skills/oakoss-openapi.md) — 197 установок
- [openapi · finom](https://affpapa.org/nevibecode/skills/finom-openapi.md) — ★ 57 у репозитория

Из того же набора: [itechmeat/llm-code](https://affpapa.org/nevibecode/by/itechmeat/llm-code.md) — 16 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
