skilly.
All skills
Documentation / AGENT SKILL

swagger-cover

Vitammiin/agent-vorcl-flow
0 installs 2 GitHub stars
0

Покрыть роут/модуль OpenAPI/Swagger — параметры, ответы, описания, security + проверка. Use when роут/модуль надо задокументировать (править код/спеку); найти дыры без правок — /s…
Покрыть роут/модуль OpenAPI/Swagger — параметры, ответы, описания, security + проверка. Use when роут/модуль надо задокументировать (править код/спеку); найти дыры без правок — /swagger:audit (swagger)

Low community score

swagger-cover: This skill has a community score below −5, meaning it has received more downvotes than upvotes. Review its source and assessment before installing. Community votes are not a security review.
BEFORE YOU INSTALL

Understand the trade-offs.

SECURITY REVIEW

Not yet assessed

Review the original instructions and requested permissions before installing.

No security review is available for this catalog entry yet.

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: **запрос пользователя**.

Сначала определи стек и механизм документации (не предполагай Fastify): `schema` у Fastify, `@ApiOperation/@ApiResponse/@ApiTags` у NestJS, JSDoc `@openapi` (swagger-jsdoc) или декораторы у tsoa, `options.validate/response/tags` у Hapi, `.meta.openapi` у tRPC, либо правки прямо в статической `openapi.{yaml,json}`. По скиллу `swagger-coverage`:
1. Опиши вход (`params`/`query`/`headers`/`body`) и **все** ответы (успех + ошибки), заведи/переиспользуй общий Error-компонент. Для Fastify+zod — схемы в `schemas.ts` + `z.globalRegistry` для `$ref`.
2. Проставь `summary`/`description`/`tags`/`operationId`; для защищённых роутов — `$security`.
3. Сверь хендлер/controller: он возвращает РОВНО то, что в схеме ответа, с верными статусами. При расхождении правь хендлер или схему, но НЕ ослабляй валидацию.
4. Запрещено: прятать роут из спеки (`hide`/exclude) и ставить `any`/пустые схемы ради «покрытия».
5. **Валидация спеки — обязательный шаг готовности.** Получи итоговую спеку (рантайм-эндпоинт стека / статический файл / генератор; для рантайм-спеки запусти приложение и убедись, что она отдаётся) и прогони `npx swagger-cli validate <spec>` или `npx @redocly/cli lint <spec>` + `npx openapi-typescript <spec>` без ошибок; прогони тесты. **Только валидная спека = готово** — при ошибках валидации чини и перегоняй, невалидную спеку не сдавай.

Опирайся на навыки `swagger-coverage`, `backend-architecture`, `typescript`. Делегируй субагенту `$swagger`.