golang-swagger

Generate Swagger/OpenAPI documentation for Go projects from code annotations.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/constzz/dates-app --skill golang-swagger-constzz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: golang-swagger
Source: https://github.com/constzz/dates-app/tree/main/.agents/skills/golang-swagger
Command: npx skills add https://github.com/constzz/dates-app --skill golang-swagger-constzz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires swaggo/swag, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the generation of Swagger/OpenAPI documentation for Go projects, saving developers time and ensuring documentation stays up-to-date with code changes.

Core Features & Use Cases

  • Documentation Generation: Automatically generate Swagger/OpenAPI documentation from code annotations.
  • Framework Integration: Supports Gin, Echo, Fiber, Chi, and net/http frameworks.
  • Security and Annotations: Handles security definitions and annotations for Bearer tokens, API keys, and OAuth2.
  • Use Case: Use this Skill to maintain comprehensive and accurate API documentation for your Go projects, ensuring a seamless developer experience.

Quick Start

Run swag init to generate Swagger documentation for your Go project.

Frequently Asked Questions about golang-swagger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Swagger documentation from Go code annotations?

Generate Swagger documentation from Go code annotations by running the `swag init` command to parse annotations and produce OpenAPI specification files for your API project.

Can I use swaggo/swag to generate OpenAPI docs for the Fiber framework?

Yes, swaggo/swag supports generating OpenAPI docs for the Fiber framework, alongside Gin, Echo, Chi, and standard net/http Go frameworks.

How do I define Bearer token and OAuth2 security annotations in Go Swagger?

Define Bearer token and OAuth2 security annotations in Go Swagger by adding specific security definition comments to your API handler functions to document authentication requirements.

Do I need the Go CLI and swaggo/swag installed to automate OpenAPI documentation?

Yes, you need the Go CLI and the swaggo/swag dependency installed in your environment to automate OpenAPI documentation generation from your Go source code.

What is the best way to keep Go API documentation up-to-date with code changes?

The best way to keep Go API documentation up-to-date is to generate Swagger docs directly from code annotations, ensuring your OpenAPI specifications accurately reflect code changes.