Nodejs

Node.js Skill

Use this skill when writing any Node.js JavaScript code: modules, async logic, error handling, project structure, or environment configuration.

When to Use

• Writing or reviewing any Node.js source file
• Working with ESM modules, imports, and exports
• Handling async operations, Promises, or streams
• Managing environment variables and configuration
• Structuring a Node.js project
• Documenting API endpoints with Swagger/OpenAPI

Rules

1. [rules/esm.md](rules/esm.md) — ESM module system: imports, exports, file extensions, dynamic imports.
2. [rules/async.md](rules/async.md) — Async/await, Promise patterns, error propagation, concurrency.
3. [rules/error-handling.md](rules/error-handling.md) — Error types, propagation, process-level handlers, safe coding.
4. [rules/project-structure.md](rules/project-structure.md) — Feature-oriented directory layout, config, environment variables, entry points.
5. [rules/swagger.md](rules/swagger.md) — JSDoc @swagger blocks with swagger-jsdoc: schemas, routes, parameters, tags.

Quick Reference

// ESM import — always use .js extension for local files
import { createUser } from './users.js';
import { readFile } from 'node:fs/promises';

// Async function — always propagate errors, never swallow
async function loadConfig(path) {
  const raw = await readFile(path, 'utf8');
  return JSON.parse(raw);
}

// Concurrent work — use Promise.all, not sequential awaits
const [users, products] = await Promise.all([getUsers(), getProducts()]);

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jesus-seijas-sp
• Source: jesus-seijas-sp/claude-node-setup
• License: MIT

Install and usage instructions live in the source repository linked above.