NestJS 11+ best practices for enterprise Node.js applications with TypeScript. Use when writing, reviewing, or refactoring NestJS controllers, services, modules, or APIs. Triggers on: NestJS modules, controllers, providers, dependency injection, @Injectable, @Controller, @Module, middleware, guards, interceptors, pipes, exception filters, ValidationPipe, class-validator, class-transformer, DTOs, JWT authentication, Passport strategies, @nestjs/passport, TypeORM entities, Prisma client, Drizzle ORM, repository pattern, circular dependencies, forwardRef, @nestjs/swagger, OpenAPI decorators, GraphQL resolvers, @nestjs/graphql, microservices, TCP transport, Redis transport, NATS, Kafka, NestJS 11 breaking changes, Express v5 migration, custom decorators, ConfigService, @nestjs/config, health checks, or NestJS testing patterns.
npx claudepluginhub ejirocodes/agent-skills --plugin nestjs-best-practicesThis skill uses the workspace's default tool permissions.
| Topic | When to Use | Reference |
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
| Topic | When to Use | Reference |
|---|---|---|
| Core Architecture | Modules, Providers, DI, forwardRef, custom decorators | core-architecture.md |
| Request Lifecycle | Middleware, Guards, Interceptors, Pipes, Filters | request-lifecycle.md |
| Validation & Pipes | DTOs, class-validator, ValidationPipe, transforms | validation-pipes.md |
| Authentication | JWT, Passport, Guards, Local/OAuth strategies, RBAC | authentication.md |
| Database | TypeORM, Prisma, Drizzle ORM, repository patterns | database-integration.md |
| Testing | Unit tests, E2E tests, mocking providers | testing.md |
| OpenAPI & GraphQL | Swagger decorators, resolvers, subscriptions | openapi-graphql.md |
| Microservices | TCP, Redis, NATS, Kafka patterns | microservices.md |
@Module({
imports: [DatabaseModule],
controllers: [UsersController],
providers: [UsersService],
exports: [UsersService], // Export for other modules
})
export class UsersModule {}
@Controller('users')
export class UsersController {
constructor(private readonly usersService: UsersService) {}
@Post()
create(@Body() createUserDto: CreateUserDto) {
return this.usersService.create(createUserDto);
}
@Get(':id')
findOne(@Param('id', ParseIntPipe) id: number) {
return this.usersService.findOne(id);
}
}
import { IsEmail, IsString, MinLength, IsOptional } from 'class-validator';
export class CreateUserDto {
@IsEmail()
email: string;
@IsString()
@MinLength(8)
password: string;
@IsOptional()
@IsString()
name?: string;
}
@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {
catch(exception: HttpException, host: ArgumentsHost) {
const ctx = host.switchToHttp();
const response = ctx.getResponse<Response>();
const status = exception.getStatus();
response.status(status).json({
statusCode: status,
message: exception.message,
timestamp: new Date().toISOString(),
});
}
}
@Injectable()
export class JwtAuthGuard extends AuthGuard('jwt') {
canActivate(context: ExecutionContext) {
return super.canActivate(context);
}
}
*splat), optional params use braces /:file{.:ext}forwardRef() for circular deps - Causes "cannot resolve dependency" errors; wrap in forwardRef(() => ModuleName)throw new BadRequestException('message')@Injectable() decorator - Provider won't be injectable; always decorate serviceswhitelist: true - Allows unexpected properties; set whitelist: true, forbidNonWhitelisted: trueexports array to share providers across modulesConfigModule.forRoot() - ConfigService undefined; import ConfigModule in AppModuleoverrideProvider() - Uses real services in unit tests; mock dependencies with overrideProvider(Service).useValue(mock)