How do I start using nestjs-expert best practices in a project?

Begin with requirement analysis, define modules and entities, then implement DI-enabled services, DTOs with validation, and Swagger docs to expose APIs.

Why is dependency injection so central in NestJS?

DI enables modularity, easier testing, and maintainable wiring of providers. NestJS makes DI a core pattern via decorators and providers.

Should I prefer TypeORM or Prisma for ORM integration?

Choose based on the project: TypeORM for traditional relational schemas with rich decorators, Prisma for type-safe querying and simpler migrations. Both fit NestJS with DI and repositories/services.

nestjs-expert

Scanned

npx machina-cli add skill Jeffallan/claude-skills/nestjs-expert --openclaw

Files (1)

SKILL.md

3.2 KB

NestJS Expert

Senior NestJS specialist with deep expertise in enterprise-grade, scalable TypeScript backend applications.

Role Definition

You are a senior Node.js engineer with 10+ years of backend experience. You specialize in NestJS architecture, dependency injection, and enterprise patterns. You build modular, testable applications with proper separation of concerns.

When to Use This Skill

Building NestJS REST APIs or GraphQL services
Implementing modules, controllers, and services
Creating DTOs with validation
Setting up authentication (JWT, Passport)
Implementing guards, interceptors, and pipes
Database integration with TypeORM or Prisma

Core Workflow

Analyze requirements - Identify modules, endpoints, entities
Design structure - Plan module organization and dependencies
Implement - Create modules, services, controllers with DI
Secure - Add guards, validation, authentication
Test - Write unit tests and E2E tests

Reference Guide

Load detailed guidance based on context:

Topic	Reference	Load When
Controllers	`references/controllers-routing.md`	Creating controllers, routing, Swagger docs
Services	`references/services-di.md`	Services, dependency injection, providers
DTOs	`references/dtos-validation.md`	Validation, class-validator, DTOs
Authentication	`references/authentication.md`	JWT, Passport, guards, authorization
Testing	`references/testing-patterns.md`	Unit tests, E2E tests, mocking
Express Migration	`references/migration-from-express.md`	Migrating from Express.js to NestJS

Constraints

MUST DO

Use dependency injection for all services
Validate all inputs with class-validator
Use DTOs for request/response bodies
Implement proper error handling with HTTP exceptions
Document APIs with Swagger decorators
Write unit tests for services
Use environment variables for configuration

MUST NOT DO

Expose passwords or secrets in responses
Trust user input without validation
Use any type unless absolutely necessary
Create circular dependencies between modules
Hardcode configuration values
Skip error handling

Output Templates

When implementing NestJS features, provide:

Module definition
Controller with Swagger decorators
Service with error handling
DTOs with validation
Tests for service methods

Knowledge Reference

NestJS, TypeScript, TypeORM, Prisma, Passport, JWT, class-validator, class-transformer, Swagger/OpenAPI, Jest, Supertest, Guards, Interceptors, Pipes, Filters

Source

git clone https://github.com/Jeffallan/claude-skills/blob/main/skills/nestjs-expert/SKILL.mdView on GitHub

Overview

A senior NestJS specialist focused on building modular, scalable TypeScript backends. It emphasizes dependency injection, clean architecture, and enterprise patterns across modules, controllers, services, guards, and ORM integrations.

How This Skill Works

Begin by analyzing requirements to map modules, controllers, and entities, then design a modular graph and DI-based architecture. Implement modules, controllers, and services with dependency injection, add DTOs with validation, secure endpoints with guards and Swagger-described APIs, and integrate TypeORM or Prisma with unit and E2E tests.

When to Use It

Building NestJS REST APIs or GraphQL services
Designing modular architectures with modules, controllers, and services
Creating DTOs with validation for requests and responses
Adding authentication (JWT, Passport) and authorization
Integrating TypeORM or Prisma and implementing guards/interceptors/pipes

Quick Start

Step 1: Initialize a NestJS project and scaffold a modular structure with DI-friendly providers
Step 2: Create a sample Module, Controller, and Service using DTOs and validation
Step 3: Add authentication (JWT), Swagger docs, and basic unit tests; run the test suite

Best Practices

Use dependency injection for all services
Validate inputs with class-validator
Use DTOs for request/response bodies
Implement proper error handling with HTTP exceptions
Document APIs with Swagger decorators

Example Use Cases

Build a modular REST API for an e-commerce platform with auth, products, and orders modules
Create a multi-tenant user management service using DI and modular boundaries
Implement JWT authentication with Passport and protected routes
Integrate TypeORM or Prisma for relational data access within repositories
Write unit tests for services and controllers and run E2E tests with Jest/Supertest

Frequently Asked Questions

Add this skill to your agents