# nodejs

Скилл заставляет агента писать бэкенд на Node.js или Bun по правилам конкретного проекта, а не по усреднённым шаблонам из интернета.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 163 установки · ★ 5 у репозитория
- Автор: ulpi-io
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ulpi-io/skills/tree/HEAD/nodejs/SKILL.md
- Обновлён: 2026-08-31
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/nodejs

## Что делает

Скилл работает как маршрутизатор по набору референсов. Первым делом он открывает `references/stack.md` и фиксирует, что за проект: рантайм, фреймворк, ORM, тест-раннер, пакетный менеджер. Если в репозитории лежит `bun.lockb` или `bunfig.toml`, рантайм считается Bun, и подтягиваются заметки по нативным API Bun.

Дальше грузится только нужное под задачу. В таблице маршрутов есть HTTP-серверы, дизайн API, валидация Zod, работа с базой, авторизация, типизированные ошибки, логи pino, тесты, очереди BullMQ, кэш, Docker, WebSocket, CLI и наблюдаемость. Постоянный набор правил держится всё время: строгий TypeScript без `any`, проверка любого внешнего ввода, никакого `console.log` в боевом коде, корректное завершение по SIGTERM и SIGINT.

Фронтенд и проекты, где поверхностью владеет фреймворк, сюда не относятся: у Next.js, NestJS и Laravel свои скиллы. Здесь бэкенд без привязки к фреймворку, поэтому в Laravel-репозитории советы промахнутся. Из инструментов скиллу нужны Bash, Read, Write, Edit и Grep.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill nodejs -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/nodejs/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/nodejs/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill nodejs -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/nodejs/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill nodejs -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/nodejs/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills nodejs
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/nodejs/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill nodejs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ulpi-io/skills --path nodejs
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/nodejs/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill nodejs -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ulpi-io/skills/tree/HEAD/nodejs/SKILL.md

## Когда брать
- добавить HTTP-эндпоинт по текущей раскладке сервера
- провалидировать тело запроса и переменные окружения через Zod
- подключить pino с идентификатором запроса
- закрыть соединения и пул базы при SIGTERM
- собрать multi-stage образ Docker для сервиса

## Примеры запросов агенту
- Добавь эндпоинт `POST /orders` с Zod-схемой и нашим форматом ошибок.
- Найди в воркере необработанный promise rejection и почини.
- Настрой очередь BullMQ с ретраями и разбором упавших задач.

## Похожие
- [nodejs-development](https://affpapa.org/nevibecode/skills/nodejs-development.md) — скилл · 800 установок
- [nodejs-backend](https://affpapa.org/nevibecode/skills/bobmatnyc-nodejs-backend.md) — скилл · 307 установок
- [backend-dev-guidelines](https://affpapa.org/nevibecode/skills/backend-dev-guidelines.md) — скилл · 1800 установок
- [feature-flags-nodejs](https://affpapa.org/nevibecode/skills/feature-flags-nodejs.md) — скилл · 113 установок
- [nodejs-expert](https://affpapa.org/nevibecode/skills/nodejs-expert.md) — скилл · 216 установок
- [fastify-best-practices](https://affpapa.org/nevibecode/skills/fastify-best-practices.md) — скилл · 100800 установок

Из того же набора: [ulpi-io/skills](https://affpapa.org/nevibecode/by/ulpi-io/skills.md) — 49 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
