What problem does it solve? Go developers must manually write and maintain Swagger/OpenAPI annotations that stay in sync with their handlers and models; stale or incorrect annotations produce wrong API contracts and broken Swagger UIs. This Skill provides the annotation patterns, CLI workflows, and framework integrations needed to keep generated docs accurate. ## Core Features & Use Cases - Annotation authoring: Write @Summary, @Param, @Success, @Router, and @Security comments correctly, including generics, nested composition, and collection formats. - Framework integration: Wire the Swagger UI endpoint for Gin, Echo, Fiber, Chi, and net/http, including dynamic host/basepath overrides via docs.SwaggerInfo. - Struct tag enrichment: Use swaggertype, enums, example, and swaggerignore tags to control generated schemas without changing Go types. - Use Case: A team adds JWT-protected endpoints to a Gin service; the Skill annotates each handler with @Security Bearer, regenerates docs with swag init, and the Swagger UI shows the lock icon and correct schemas. ## Quick Start Ask the AI to add Swagger annotations to your Go handlers and wire up the Swagger UI endpoint for your framework.
