SECURITY REVIEW
Not yet assessed
Review the original instructions and requested permissions before installing.
No security review is available for this catalog entry yet.
Community / AGENT SKILL
swagger-audit
0
Read-only аудит покрытия OpenAPI/Swagger — найти роуты, не полностью покрытые спекой, на любом стеке (роль swagger). Use when нужно только НАЙТИ дыры покрытия без правок; покрывать найденное — $swagger-cover.
Understand the trade-offs.
SKILL QUALITY
Not yet assessed
How clearly the skill guides your agent, how complete its workflow is, and how you can check the outcome.
No quality assessment is available for this catalog entry yet.
The full skill.
Original instructions from the publisher’s SKILL.md
# Задача: аудит покрытия OpenAPI/Swagger
Найди роуты/эндпоинты, НЕ полностью покрытые OpenAPI/Swagger (**read-only**).
Сначала **определи стек и источник спеки** (не предполагай Fastify) по `package.json`/импортам/файлам: Fastify (`@fastify/swagger`), Express (`swagger-jsdoc`/`tsoa`), NestJS (`@nestjs/swagger`), Koa, Hapi (`hapi-swagger`), tRPC (`trpc-openapi`), статическая `openapi.{yaml,json}` или не-JS (FastAPI/Spring/DRF). Спека нигде не отдаётся/не генерируется — это уже дыра.
Собери роуты способом под стек (эвристики — в `$swagger-coverage`) и получи фактическую спеку (эндпоинт `/documentation/json` · `/api-json` · `/openapi.json` · `/v3/api-docs`; статический файл; генератор). Сопоставь и применяй универсальный чек-лист: операции нет в спеке; нет `summary`/`description`/`tags`/`operationId`; `responses` без ошибок через общий Error-компонент; защищённый роут без `security`; роут скрыт из спеки; рассинхрон схемы ответа с хендлером.
Ничего не правь. Формат: `file:line`, роут (метод+путь), чего не хватает, severity `critical>high>medium>low`. По значимым — `add_task`. В конце — обнаруженный стек + сводка покрытия по модулям/тегам. Опирайся на `$swagger-coverage`.