Can this skill improve my generated SDKs?

Yes, by enforcing the use of 'enumName' and explicit type definitions for arrays, it ensures that generated clients have accurate types and enums.

How does this skill handle validation decorators?

It automatically aligns class-validator decorators like @Min, @Max, and @IsOptional with their corresponding Swagger properties to ensure your documentation matches your code logic.

Does it support internationalization in documentation?

The skill specifically promotes a pattern of using descriptive text in your local language (e.g., Korean) while providing standard format values for examples.

Does it provide templates for both requests and responses?

Yes, it includes distinct templates for Request DTOs (validation focused) and Response DTOs (structure focused) to cover the full API lifecycle.

NestJS Swagger Documenter

Name: NestJS Swagger Documenter
Author: m16khb

bym16khb

API開発

Standardizes NestJS DTO and Controller documentation using Swagger decorators to ensure high-quality, client-ready API specifications.

概要

The NestJS Swagger Documenter skill provides a robust framework for implementing OpenAPI standards within NestJS applications. It enforces essential documentation practices, such as mandatory property descriptions, realistic examples, and the synchronization of class-validator decorators with Swagger attributes. By utilizing specialized templates for DTOs and Controllers, it ensures that API documentation is not only comprehensive but also optimized for client-side SDK generation through features like mandatory enum names and explicit type definitions. This skill is ideal for teams looking to improve API discoverability and provide frontend developers with clear, actionable documentation.

主な機能

0 GitHub stars
Automated DTO template generation for standardized requests and responses
Smart mapping between class-validator decorators and Swagger attributes
Enhanced readability using Markdown tables for complex status and option descriptions
SDK optimization through mandatory enumName and explicit type definitions
Standardized Controller documentation patterns with @ApiOperation and @ApiResponse

ユースケース

Generating production-grade OpenAPI (Swagger) documentation for NestJS backends
Enforcing documentation consistency across large-scale microservices
Optimizing API schemas for reliable frontend SDK and client generation

概要

主な機能

0 GitHub stars
Automated DTO template generation for standardized requests and responses
Smart mapping between class-validator decorators and Swagger attributes
Enhanced readability using Markdown tables for complex status and option descriptions
SDK optimization through mandatory enumName and explicit type definitions
Standardized Controller documentation patterns with @ApiOperation and @ApiResponse

ユースケース

Generating production-grade OpenAPI (Swagger) documentation for NestJS backends
Enforcing documentation consistency across large-scale microservices
Optimizing API schemas for reliable frontend SDK and client generation