Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

nestjs/agent-skills

Developer Tools

Official Agent Skills that teach coding agents current NestJS APIs, conventions and production pitfalls.

This repo is an agent skill pack · 6 skillsSkill list and install →
117
3
JavaScript
MIT
1 day old

What this is

This repository packages six official Agent Skills for building and extending NestJS applications with coding agents. Each skill is a folder containing a SKILL.md with rules and pitfalls plus a references/ directory with longer recipes. The material focuses on current APIs, Nest first-party packages, and mistakes that still pass tests, such as enumeration-prone sign-in, @IsOptional() accepting null, and rate limiting that does not count the user.

The six skills cover:

  • nestjs: project setup, layout and the module system
  • nestjs-feature: endpoints, validation, status codes, errors and Server-Sent Events
  • nestjs-auth: authentication and authorization policies
  • nestjs-data: Drizzle and TypeORM persistence, migrations, paging and transactions
  • nestjs-testing: unit, service and end-to-end tests
  • nestjs-production: configuration, logging, observability, health checks, rate limiting, OpenAPI and shutdown

Agents load a skill when its description matches the task, so there is no manual invocation step. The files follow the Agent Skills specification, so the same skills work in Claude Code, Codex, Cursor and other compatible agents.

Install and use

For most agents, run the npm installer in the project root:

npx @nestjs/skills add

By default this copies all skills into .agents/skills/, which Codex and Cursor read. Use --agent to choose another target: claude writes to .claude/skills/, cursor to .cursor/skills/, and all writes both .agents/skills/ and .claude/skills/. Several targets can be combined. Add --global to install for every project on the machine. To install only some skills, pass their names, for example npx @nestjs/skills add nestjs nestjs-auth. The list and remove subcommands inspect and clean up the installed copies.

The installed folders carry a .nestjs-skills marker; the installer only replaces or removes folders it installed, unless --force is given. For a version pinned with the team, install the package as a dev dependency and run npx nestjs-skills add.

Claude Code users can install from the repository marketplace instead:

claude plugin marketplace add nestjs/agent-skills
claude plugin install nestjs@nestjs

Skills installed through the plugin are namespaced, for example nestjs:nestjs-auth. Without the plugin, npx @nestjs/skills add --agent claude achieves the same result.

To install by hand, clone the repository and copy the skill folders to the directory your agent reads, such as .agents/skills/ or ~/.agents/skills/. Keep each folder whole because SKILL.md links to references/ by relative path and the skills reference each other by name. A symlink keeps a copy current with git pull.

After installing, ask the agent to work on a NestJS task, such as adding an endpoint or writing an end-to-end test; it should pick the matching skill from its description.

Constraints

The skills are written for NestJS 12 (@nestjs/core 12.x) on Node.js 20 or later. The recipes were run against Nest 12.5.1 and specific versions of the first-party packages, including @nestjs/authentication 0.1.6, @nestjs/authorization 0.1.4, @nestjs/drizzle 0.0.2 with Drizzle 1.0 rc, @nestjs/typeorm 12.0.3 with TypeORM 1.1, and several @nestjs/* tooling packages. Projects on older Nest versions may need to adapt the guidance, and the skills instruct agents to check installed versions and the NestJS documentation before relying on model memory.

Folder names matter to the plugin and installer. Updating through npm by rerunning the installer replaces only the copies it installed; hand-copied folders need a new git pull and copy, while symlinked folders update with the pull. For Claude Code, marketplace and plugin updates are separate commands. The repository is MIT licensed.

HotRepo's take

This is a short-lived but fast-starting repository: in the single new-list window that began on 2026-11-20 and ended on 2026-11-21, it recorded 100 stars and 3 forks, with the star count still at 100 at the end of that window. That is early traction rather than a long track record, and there is no recorded position on the all-language daily GitHub ranking. What the material does establish is the distribution setup: the repository doubles as a Claude Code plugin and its own marketplace and ships the @nestjs/skills npm package with an installer, so it can be adopted through several agent ecosystems without a custom integration. The value of the skills will still depend on how closely the reader's Nest version matches the tested 12.x stack.

Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.

You might also like

  1. nestjs/nestA TypeScript backend framework for Node.js with modules, dependency injection and built-in packages.TypeScript77,128
  2. addyosmani/agent-skillsA set of Markdown workflow skills that make AI coding agents follow spec, test, review and ship discipline.JavaScript116,771
  3. vercel-labs/agent-skillsPackaged skill instructions that teach AI coding agents Vercel's React, Next.js and deployment conventions.JavaScript32,947
  4. wshobson/agentsA cross-harness catalog of coding agents, skills and commands so one set of prompts works across Claude Code, Codex, Cursor and others.Python41,629
  5. android/skillsOfficial Android skill files that teach coding agents how to handle Android tasks LLMs usually get wrong.Kotlin9,568