AIKraft/AI/Войти
AIKraft/Skills/OpenAPI Specification v3.2

OpenAPI Specification v3.2

OpenAPI Specification 3.2 — write and interpret OpenAPI descriptions (OAD), paths, operations, parameters, request/response, schema (JSON Schema 2020-12), security, and extensions. Use when authoring or validating OpenAPI 3.2 documents.

hairyf official Документы

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

Написание, редактирование и валидация документов OpenAPI Description (OAD) версии 3.2.0, включая описание путей, операций, параметров, тел запросов и ответов. Поддержка работы с объектами Schema (на базе JSON Schema Draft 2020-12), компонентами, схемами безопасности и расширениями.

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

  • Создание или обновление спецификаций OpenAPI в форматах YAML или JSON.
  • Разрешение ссылок $ref, $self и относительных URI в многодокументных спецификациях.
  • Описание параметров запроса (path, query, header, cookie, querystring) и тел запросов с медиа-типами.
  • Настройка схем безопасности (apiKey, http, oauth2, openIdConnect) и требований к ним.
  • Валидация структуры документа на соответствие спецификации OpenAPI 3.2.0.

Как работает

  1. Определить корневой объект документа, установив поле openapi: 3.2.0 и убедившись в наличии хотя бы одного из компонентов: components, paths или webhooks.
  2. Описать пути (Paths Object) и операции (Operation Object), указав параметры, тела запросов и ответы с соответствующими HTTP статус-кодами.
  3. Использовать объекты Schema для определения структур данных, применяя ключи JSON Schema Draft 2020-12 и расширения OAS.
  4. Настроить схемы безопасности в корне документа (логическое ИЛИ) или на уровне операций, определяя типы (apiKey, http, oauth2 и др.).
  5. При необходимости использовать компоненты (Components) для переиспользования схем, параметров и ответов через ссылки $ref.
  6. Применить расширения (x-) для добавления нестандартных полей, если это требуется спецификацией.

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

Создай спецификацию OpenAPI 3.2.0 для REST API с путями /users и /orders, используя JSON Schema для описания моделей.
Проверь валидность предоставленного документа OpenAPI на соответствие версии 3.2.0 и наличие обязательных полей.
Настрой схему безопасности OAuth2 с потоком authorizationCode для операций создания и удаления ресурсов.

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

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

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

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