Generate Swagger/OpenAPI specs from swaggo/swag annotations in Go source.
npx skills add https://github.com/hellopoisonx/aim --skill golang-swagger-hellopoisonx
Please help me install this Agent Skill. Skill: golang-swagger Source: https://github.com/hellopoisonx/aim/tree/main/skills/golang-swagger Command: npx skills add https://github.com/hellopoisonx/aim --skill golang-swagger-hellopoisonx
golang-swagger reduces the gap between Go API implementations and published OpenAPI/Swagger documentation by ensuring handlers, models, and security requirements are consistently described through annotation-driven generation.
Use the golang-swagger skill to annotate your Gin handlers with @Summary, @Param, @Success, and @Router, then run swag init to generate the docs package and mount the Swagger UI at /swagger/index.html.
High-intent search queries and answers about installing and using this skill.
To generate Swagger documentation from Go code, annotate handlers with swaggo/swag comments like @Summary, @Param, @Success, and @Router, then run swag init to produce the docs package. Struct tags on models control schema fidelity for request and response payloads.
Yes, swaggo/swag supports documenting REST APIs across multiple Go HTTP frameworks including gin, echo, fiber, chi, and net/http. You mount the generated Swagger UI endpoint, commonly at /swagger/index.html, by registering the docs package through framework-specific routing.
Define security requirements in Swagger annotations by using the @Security comment on handlers and configuring security definitions such as Bearer/JWT, OAuth2, or API key in the generated spec, ensuring the UI accurately reflects client authentication needs.
Control schema types and ignore fields in swaggo/swag generated docs by applying struct tags like swaggertype for custom type mapping, enums for enumerated values, example for sample data, and swaggerignore to exclude fields from the Swagger spec entirely.
Swagger UI may show the wrong host or base path because swag init generates static values. You must apply runtime SwaggerInfo overrides in your Go application initialization to dynamically set the correct host and base path before serving the UI.
vanstinatorGenerate Swagger/OpenAPI documentation from swaggo/swag annotations in Go HTTP APIs.
ehtbantonGenerate a TypeScript file configuring Swagger UI and OpenAPI 3.x for Express.js.
dmwin72015Generates Swagger/OpenAPI documentation from Go code annotations for HTTP APIs.
wfukatsuGenerate REST, GraphQL, gRPC, and AsyncAPI specifications for microservices.
