Generate Swagger and OpenAPI documentation for Go HTTP APIs from annotations.
npx skills add https://github.com/muratmirgun/gophers --skill go-swagger-muratmirgun
Please help me install this Agent Skill. Skill: go-swagger Source: https://github.com/muratmirgun/gophers/tree/main/skills/go-swagger Command: npx skills add https://github.com/muratmirgun/gophers --skill go-swagger-muratmirgun
This Skill helps Go developers keep OpenAPI and Swagger documentation accurate, consistent, and in sync with HTTP handlers so API clients and UI docs do not drift from the code.
Use the go-swagger skill to document my Go API handler, generate Swagger output with swag, and tell me exactly which annotations, struct tags, and CI checks I need to keep the spec current.
High-intent search queries and answers about installing and using this skill.
Generate Swagger documentation for Go HTTP APIs by writing inline annotations like @Summary, @Param, and @Router beside handlers, then running swag init to produce the spec. Struct tags model request and response schemas.
Yes, you can mount Swagger UI for Gin, Echo, Fiber, Chi, and net/http by importing the generated docs package and wiring the framework-specific UI handler, keeping specs aligned without manual edits.
Keep OpenAPI specs in sync by running swag init and swag fmt in Makefile or CI pipelines to regenerate and format annotations, preventing stale specs from drifting from handler implementations.
Document bearer auth for protected endpoints by adding @Security annotations to Go handlers and defining security schemes, modeling protected endpoint request validation and response schemas accurately.
Use struct tags like example, enums, swaggertype, and swaggerignore to model real request and response shapes for swaggo, enriching generated schemas to accurately reflect API data structures.
Swaggo works with net/http alongside Gin, Echo, Fiber, and Chi by correctly importing the generated docs package and applying framework-specific mounting to serve Swagger UI.
dmwin72015Generates Swagger/OpenAPI documentation from Go code annotations for HTTP APIs.
haipham22Generate Swagger and OpenAPI documentation for Go APIs with swag init.
hellopoisonxGenerate Swagger/OpenAPI specs from swaggo/swag annotations in Go source.
penghang1223Extract code comments and annotations into Markdown, JSON, or OpenAPI YAML documentation.
