golang-gin-swagger

Installation
SKILL.md

golang-gin-swagger — Swagger/OpenAPI Documentation

Generate and serve Swagger/OpenAPI documentation for Gin APIs using swaggo/swag. This skill covers the 80% you need daily: setup, handler annotations, model tags, Swagger UI, and doc generation.

When to Use

  • Adding Swagger/OpenAPI documentation to a Gin API
  • Documenting endpoints with request/response schemas
  • Serving Swagger UI for interactive API exploration
  • Generating swagger.json/swagger.yaml from Go annotations
  • Documenting JWT Bearer auth in OpenAPI spec
  • Setting up CI/CD to validate docs are up to date

Dependencies

# CLI tool (generates docs from annotations)
go install github.com/swaggo/swag/cmd/swag@latest
Related skills

More from cylixlee/cortex

Installs
2
Repository
cylixlee/cortex
First Seen
Apr 16, 2026