What problem does it solve? Go APIs lack built-in OpenAPI documentation, forcing developers to hand-write specs that drift out of sync with handlers. This Skill guides the annotation, generation, and serving of Swagger docs directly from Go source code using swaggo/swag. ## Core Features & Use Cases - Annotation Authoring: Write @Summary, @Param, @Success, @Router, and @Security comments on handlers, plus struct tags like swaggertype, enums, example, and swaggerignore. - Code Generation & Serving: Run swag init and swag fmt, then wire the Swagger UI endpoint for Gin, Echo, Fiber, Chi, or net/http with the correct swaggo integration package. - Security & Multi-Environment Setup: Define Bearer/JWT, OAuth2, API key, and Basic auth schemes, and override docs.SwaggerInfo host/basepath at runtime for staging and production deployments. - Use Case: You add a new GET /accounts/{id} endpoint in a Gin service. The Skill produces the full annotation block, regenerates docs/ with swag init, and confirms the endpoint appears with a lock icon in Swagger UI. ## Quick Start Add Swagger annotations to my Gin handlers and set up the Swagger UI endpoint so the generated docs are served at /swagger/index.html.
