Agent-skills-standard nestjs-api-standards

Create standardized API response envelopes, paginated endpoints, and error interceptors in NestJS. Use when implementing response wrappers, pagination DTOs, or global error formats. (triggers: **/*.controller.ts, **/*.dto.ts, ApiResponse, Pagination, TransformInterceptor)

install

source · Clone the upstream repo

git clone https://github.com/HoangNguyen0403/agent-skills-standard

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/HoangNguyen0403/agent-skills-standard "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/nestjs/nestjs-api-standards" ~/.claude/skills/hoangnguyen0403-agent-skills-standard-nestjs-api-standards && rm -rf "$T"

manifest: skills/nestjs/nestjs-api-standards/SKILL.md

source content

NestJS API Standards & Common Patterns

Priority: P1 (OPERATIONAL)

Workflow: Standardize API Endpoint

Create Response DTO — Define dedicated DTO for every endpoint return type.
Map entity to DTO — Use
```
plainToInstance(UserResponseDto, user)
```
in service or controller.
Apply TransformInterceptor — Bind globally to wrap all responses in
```
{ statusCode, data, meta }
```
.
Add nested validation — Decorate nested DTO properties with
```
@ValidateNested()
```
+
```
@Type()
```
.
Document with Swagger — Apply
```
@ApiResponse({ status, type })
```
with exact types per endpoint.

Response Wrapper Example

See implementation examples

Entity-to-DTO Mapping Example

See implementation examples

Deep Validation (Critical)

[Rule] Nested Validation: Object/array DTO properties require
```
@ValidateNested()
```
+
```
@Type(() => TargetDto)
```
from
```
class-transformer
```
.

Pagination Standards

DTOs: Use strict
```
PageOptionsDto
```
(page/take/order) and
```
PageDto<T>
```
(data/meta).
Swagger Logic: Generics require
```
ApiExtraModels
```
and schema path resolution.
Reference: See Pagination Wrapper Implementation for complete
```
ApiPaginatedResponse
```
decorator code.

Custom Error Response

Standard Error Object: Define
```
ApiErrorResponse
```
with
```
statusCode
```
,
```
message
```
,
```
error
```
,
```
timestamp
```
,
```
path
```
. See Error Response Class.

Docs: Apply

@ApiBadRequestResponse({ type: ApiErrorResponse })

globally or per controller.

Anti-Patterns

No raw entity returns: Always map to Response DTO; raw entities leak internal fields.
No unvalidated nested DTOs: Use
```
@ValidateNested()
```
+
```
@Type()
```
for all nested object properties.
No generic 200 docs: Apply
```
@ApiResponse({ status, type })
```
with exact types per endpoint.