Справочное руководство по лучшим практикам спецификации OpenAPI, соглашениям об именах и выражению сложных шаблонов REST API, таких как полиморфизм, перечисления, загрузка файлов и события, отправляемые сервером. Используйте при написании или улучшении спецификаций OpenAPI, чтобы гарантировать, что они соответствуют установленным соглашениям и создают качественные SDK.
Быстро установите AI-навык writing-openapi-specs в вашу среду разработки через командную строку
Источник: speakeasy-api/agent-skills.
Reference for OpenAPI best practices and conventions. This skill provides guidance on taste, conventions, and grey areas not covered by the OpenAPI specification itself.
Operation IDs: Use lowercase with underscores, following resourceaction pattern:
Component Names: Use PascalCase for schemas, parameters, and other reusable components:
Справочное руководство по лучшим практикам спецификации OpenAPI, соглашениям об именах и выражению сложных шаблонов REST API, таких как полиморфизм, перечисления, загрузка файлов и события, отправляемые сервером. Используйте при написании или улучшении спецификаций OpenAPI, чтобы гарантировать, что они соответствуют установленным соглашениям и создают качественные SDK. Источник: speakeasy-api/agent-skills.
Стабильные поля и команды для ссылок в AI/поиске.
npx skills add https://github.com/speakeasy-api/agent-skills --skill writing-openapi-specsСправочное руководство по лучшим практикам спецификации OpenAPI, соглашениям об именах и выражению сложных шаблонов REST API, таких как полиморфизм, перечисления, загрузка файлов и события, отправляемые сервером. Используйте при написании или улучшении спецификаций OpenAPI, чтобы гарантировать, что они соответствуют установленным соглашениям и создают качественные SDK. Источник: speakeasy-api/agent-skills.
Откройте терминал или инструмент командной строки (Terminal, iTerm, Windows Terminal и т.д.) Скопируйте и выполните эту команду: npx skills add https://github.com/speakeasy-api/agent-skills --skill writing-openapi-specs После установки навык будет автоматически настроен в вашей AI-среде разработки и готов к использованию в Claude Code, Cursor или OpenClaw
https://github.com/speakeasy-api/agent-skills