API Documentation

Generate Swagger/OpenAPI documentation for NestJS APIs with DTO coverage.

1|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/daithang-organization/SE104_VLEAGUE --skill api-documentation-daithang-organization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: API Documentation
Source: https://github.com/daithang-organization/SE104_VLEAGUE/tree/main/.agent/skills/api-documentation
Command: npx skills add https://github.com/daithang-organization/SE104_VLEAGUE --skill api-documentation-daithang-organization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

API teams struggle with inconsistent documentation, scattered specifications, and versioning challenges across a NestJS project, making it hard to onboard developers and maintain accurate APIs.

Core Features & Use Cases

  • Swagger/OpenAPI integration: Centralized, interactive API docs for NestJS apps.
  • DTO & endpoint documentation: Auto-documentation of controllers, DTOs, tags, and request/response schemas.
  • Versioning support: Clear API versioning and separate Swagger docs per version for multi-release projects.
  • Use Case: A new developer can explore all endpoints, models, and authentication flows in one place before coding.

Quick Start

Configure your NestJS app to load Swagger, then run the API server and view the docs at the /api endpoint.

Frequently Asked Questions about API Documentation

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

FAQPage Schema
How do I generate Swagger API documentation for a NestJS project?

To generate Swagger API documentation for a NestJS project, configure your application to load the @nestjs/swagger module, run the API server, and access the interactive OpenAPI specifications at the /api endpoint.

What is the best way to maintain consistent API documentation across multiple releases?

The best way to maintain consistent API documentation across multiple releases is by implementing versioned endpoints and serving separate Swagger OpenAPI specifications for each version within your NestJS project.

Can I auto-document DTOs and controllers in a NestJS TypeScript environment?

Yes, you can auto-document DTOs and controllers in a NestJS TypeScript environment by integrating @nestjs/swagger, which automatically generates request and response schemas for your endpoints.

Does setting up OpenAPI specifications require any specific dependencies for NestJS?

Setting up OpenAPI specifications requires a TypeScript environment alongside the NestJS framework and the @nestjs/swagger package to properly generate and serve the interactive documentation.

Why do I need versioned endpoints for my API documentation?

You need versioned endpoints for your API documentation to manage breaking changes across multi-release projects, allowing developers to access separate Swagger docs tailored to specific API versions.

How does centralized API documentation help onboard new developers?

Centralized API documentation helps onboard new developers by providing a single interactive Swagger interface to explore all endpoints, DTOs, models, and authentication flows before writing any code.