SECURITY REVIEW
Not yet assessed
Review the original instructions and requested permissions before installing.
No security review is available for this catalog entry yet.
Documentation / AGENT SKILL
swagger-audit
0
Read-only аудит покрытия OpenAPI/Swagger — найти роуты, не полностью покрытые спекой. Use when нужно только НАЙТИ дыры покрытия без правок; покрывать найденное — /swagger:cover (s…
Read-only аудит покрытия OpenAPI/Swagger — найти роуты, не полностью покрытые спекой. Use when нужно только НАЙТИ дыры покрытия без правок; покрывать найденное — /swagger:cover (swagger)
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
<!-- generated by scripts/generate-codex-skills.mjs; edit canonical agents/, commands/ or skills/ -->
Найди роуты/эндпоинты, НЕ полностью покрытые OpenAPI/Swagger (**read-only**): **запрос пользователя**.
Сначала **определи стек и источник спеки** (не предполагай Fastify) по `package.json`, импортам и файлам: Fastify (`@fastify/swagger`), Express (`swagger-jsdoc`/`tsoa`/`swagger-ui-express`), NestJS (`@nestjs/swagger`), Koa, Hapi (`hapi-swagger`), tRPC (`trpc-openapi`), статическая `openapi.{yaml,json}`, либо не-JS (FastAPI/Spring/DRF/swaggo). Если спека нигде не отдаётся/не генерируется — это уже дыра (API не документирован).
Собери все объявления роутов способом под стек (эвристики — в навыке `swagger-coverage`: роутеры `.get/.post/.route`, декораторы Nest/tsoa, `server.route` Hapi, tRPC `.meta.openapi`) и получи фактическую спеку (рантайм-эндпоинт `/documentation/json` · `/api-json` · `/openapi.json` · `/v3/api-docs`; статический файл; или генератор). Сопоставь роуты со спекой и применяй **универсальный чек-лист операции**: операции нет в спеке; нет `summary`/`description`/`tags`/`operationId`; `responses` только для успеха, без ошибок (`4xx/5xx`) через общий Error-компонент; защищённый роут (`requireAuth`/`verifyJwt`/`@Security`/`UseGuards`) без `$security`; публичный роут скрыт/исключён из спеки; рассинхрон схемы ответа с тем, что реально отдаёт хендлер. (Fastify+zod — частый дефолт, но лишь один из стеков.)
Ничего не правь. Формат находки: `file:line`, роут (метод+путь), чего не хватает, severity (`critical > high > medium > low`). По значимым находкам — remediation recommendations в отчёте. В конце — сводка покрытия по модулям/тегам (полностью/частично/не покрыто) с указанием обнаруженного стека. Опирайся на навык `swagger-coverage`. Делегируй субагенту `$swagger` (только чтение).