What problem does it solve? NestJS endpoints without proper Swagger annotations produce an empty or misleading /api/docs page and cause the contract probe to silently skip branches, so 401/403/409/422 paths ship untested. This Skill provides the complete annotation ruleset that makes every endpoint self-documenting and probe-coverable. ## Core Features & Use Cases - Mandatory per-handler checklist: Enforces @ApiTags, @ApiOperation, @ApiBearerAuth, @ApiBody with zodToOpenApi refs, @ApiParam/@ApiQuery, and an explicit @ApiResponse for every status a handler can return. - Zod-to-OpenAPI integration: Requires .openapi({ example, description }) on every Zod field plus examples blocks on @ApiBody so Swagger UI never degrades to "Unknown Type: object". - Auth flow detection: Defines canonical operationIds (authLogin, authRegister, authLogout, authRefresh, authMe) so the probe can generate the auth-bootstrap chain without path or shape heuristics. - Use Case: After pnpm probe:smoke reports CONTRACT_STATUS_UNREACHABLE_UNGENERATABLE or a 401 on a protected route, apply the status-audit procedure to declare every reachable status and re-run the probe until all flows generate. ## Quick Start Annotate my NestJS auth controller with the full Swagger decorator set including canonical operationIds and per-status @ApiResponse declarations.
