SkillFoxx
Telegram

NestJS Best Practices — скилл

40 правил по NestJS в десяти разделах по важности: агент пишет модули, DI и защиту без типовых ошибок.

  • 298 ★ репозитория
  • Последний коммит
Скилл

Минимальный доступ

Почему такой уровень

  • Скилл состоит из текстовых правил и примеров кода, сам ничего не запускает и не обращается к сети.
Все причины и проверки

kadajett/agent-nestjs-skillsАвтор:Kadajett

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/nestjs-best-practices

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скилл состоит из текстовых правил и примеров кода, сам ничего не запускает и не обращается к сети.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл `nestjs-best-practices` собирает 40 правил по NestJS, каждое в отдельном файле с примером плохого и хорошего кода. Правила сгруппированы по десяти разделам с пометкой влияния: архитектура и внедрение зависимостей отнесены к критическим, обработка ошибок, безопасность и производительность к высоким, тесты и база данных к средне-высоким, дизайн API и микросервисы к средним, эксплуатация к средне-низким. Агент подгружает скилл, когда пишет или проверяет код на NestJS: модули, контроллеры, сервисы, аутентификацию, запросы к базе. Примеры правил: `arch-avoid-circular-deps` против циклических зависимостей модулей, `security-use-guards` для защиты маршрутов, `db-avoid-n-plus-one` против лишних запросов, `test-use-testing-module` для изоляции тестов. Установочная копия лежит в каталоге `skills/nestjs-best-practices`.

Для кого. Бэкенд-разработчикам на NestJS, чей агент пишет модули и сервисы, но нарушает принятые приемы архитектуры и безопасности.

Подходит, если

  • Новый модуль NestJS пишут с нуля, и агент должен держаться принятой структуры по функциям.
  • Код-ревью выявляет циклические зависимости между модулями и сервисы на сотни строк.
  • Маршруты закрывают гардами, а входные данные валидируют через DTO и пайпы.
  • Список из сотни записей грузится дольше секунды из-за запросов по одному.
  • Тесты поднимают приложение целиком, хотя хватило бы тестового модуля.

Не подходит, если

  • Проект написан на Express или Fastify без NestJS.
  • Ищут готовые конфигурации деплоя: в правилах только принципы и примеры кода.
  • Команда уже закрепила собственный свод правил, и они расходятся с этими.

Пример запроса к агенту

Проверь модуль заказов по правилам NestJS: найди циклические зависимости, незащищенные маршруты и запросы к базе по одному.

Ограничения

Правила опираются на общие практики и документацию NestJS без привязки к версии фреймворка, поэтому версию и стек проекта агент сверяет сам. В репозитории нет скриптов, которые проверяют код автоматически, скилл только подсказывает агенту. Лицензия в файле репозитория не указана, в заголовке скилла значится MIT. Последний коммит — июль 2026. В README автор рекламирует свой отдельный продукт Semfora, к установке скилла он отношения не имеет.

Как отключить. Удалите каталог `nestjs-best-practices` из каталога скиллов агента, например из `.claude/skills`. Глобальную установку убирают в домашнем каталоге агента.

Частые вопросы

Как поставить NestJS Best Practices в Claude Code?

Выполните `npx skills add Kadajett/agent-nestjs-skills` в каталоге проекта. Флаг `--global` делает скилл доступным во всех проектах, а `-a claude-code -a cursor` выбирает агентов.

Сколько правил в скилле и как они устроены?

Сорок правил, по одному файлу на правило, с блоками «Incorrect» и «Correct», пояснением и ссылкой на документацию NestJS. Имя файла начинается с префикса раздела: `arch-`, `di-`, `error-`, `security-`, `perf-`, `test-`, `db-`, `api-`, `micro-`, `devops-`.

Какие правила в приоритете?

Критические: архитектура и внедрение зависимостей. Следом идут обработка ошибок, безопасность и производительность. Тесты и база данных получили уровень средне-высокий.

Как добавить собственное правило?

Скопируйте `rules/_template.md` в файл `area-description.md` с нужным префиксом, заполните описание и примеры, затем выполните `npm run build` в каталоге `scripts`. Скрипт пересоберет `AGENTS.md`.

С какими агентами работает скилл?

README называет Claude Code, OpenCode, Codex, Cursor, Antigravity и Roo Code. Скилл устанавливается стандартным пакетом `skills`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Набор из 14 скиллов для Java Spring Boot: от анализа требований и генерации кода до тестов, ревью и Docker-развертывания.

СкиллРасширенный доступ104

Набор скиллов для Claude Code и Codex, которые учат агента писать Spring Boot по вашим конвенциям и шаблонам

СкиллМинимальный доступ357

Скиллы для Node.js от одного из авторов Fastify: практики Node и Fastify, TypeScript, OAuth, линтинг и документация

СкиллМинимальный доступ2 тыс.
Официальный

Три скилла по логированию в TypeScript: разбор логов кода и переход на события с полным контекстом, журнал аудита и анализ локальных логов

СкиллРасширенный доступ1,9 тыс.
Официальный

Четыре скилла со стандартами Spatie для Laravel, PHP, JavaScript, git и безопасности, ставятся через Laravel Boost или skills.sh

СкиллМинимальный доступ100

Шесть скиллов для разработки на Java: Spring Boot 4, проверка Spring Modulith, jSpecify, ревью кода и генератор проектов Progen.

СкиллРасширенный доступ194

Коротко о README

Установка идет через пакет `skills` для нескольких агентов. Остальная часть README учит сопровождать набор: структура каталога, шаблон правила, префиксы разделов и сборка сводного файла `AGENTS.md`.

Бейдж для README

Исходный SKILL.md

---
name: nestjs-best-practices
description: NestJS best practices and architecture patterns for building production-ready applications. This skill should be used when writing, reviewing, or refactoring NestJS code to ensure proper patterns for modules, dependency injection, security, and performance.
license: MIT
metadata:
  author: Kadajett
  version: "1.2.0"
---

# NestJS Best Practices

Comprehensive best practices guide for NestJS applications. Contains 40 rules across 10 categories, prioritized by impact to guide automated refactoring and code generation.

## When to Apply

Reference these guidelines when:

- Writing new NestJS modules, controllers, or services
- Implementing authentication and authorization
- Reviewing code for architecture and security issues
- Refactoring existing NestJS codebases
- Optimizing performance or database queries
- Building microservices architectures

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Architecture | CRITICAL | `arch-` |
| 2 | Dependency Injection | CRITICAL | `di-` |
| 3 | Error Handling | HIGH | `error-` |
| 4 | Security | HIGH | `security-` |
| 5 | Performance | HIGH | `perf-` |
| 6 | Testing | MEDIUM-HIGH | `test-` |
| 7 | Database & ORM | MEDIUM-HIGH | `db-` |
| 8 | API Design | MEDIUM | `api-` |
| 9 | Microservices | MEDIUM | `micro-` |
| 10 | DevOps & Deployment | LOW-MEDIUM | `devops-` |

## Quick Reference

### 1. Architecture (CRITICAL)

- `arch-avoid-circular-deps` - Avoid circular module dependencies
- `arch-feature-modules` - Organize by feature, not technical layer
- `arch-module-sharing` - Proper module exports/imports, avoid duplicate providers
- `arch-single-responsibility` - Focused services over "god services"
- `arch-use-repository-pattern` - Abstract database logic for testability
- `arch-use-events` - Event-driven architecture for decoupling

Сообщить о проблеме