nodejs-best-practices — Claude Code skill: purpose and install
This skill guides Node.js framework, async, architecture, and security choices from project context. Use it when planning or reviewing a Node.js codebase.
npx claude-code-templates@latest --skill development/nodejs-best-practicesWhat nodejs-best-practices does
The skill is a decision guide for Node.js work rather than a set of snippets to repeat. It maps project needs to framework choices: Hono for edge and serverless deployments, Fastify for high-performance APIs, NestJS for a structured team codebase, Express for legacy systems, and Next.js API Routes or tRPC for full-stack work. It also compares ESM with CommonJS and Node.js with Bun or Deno. Node.js 22+ TypeScript execution via --experimental-strip-types is covered.
Its architecture guidance separates HTTP handling, business services, and data access. Other sections cover error propagation, boundary validation, async patterns, event-loop blocking, security checks, and test planning. The security material includes parameterized queries, password hashing, JWT verification, CORS, environment secrets, and dependency audits. Testing examples use node:test, Vitest, Supertest, and Playwright. The configured tools are Read, Write, Edit, Glob, and Grep. For a new edge project, this guide rejects Express and points to Hono instead.
What it helps with
- choose a Node.js framework for a deployment target
- split business logic from routes and database access
- match async control flow to sequential or parallel work
- validate requests, uploads, API responses, and environment values
- plan security checks and tests for critical paths
Example prompts for the agent
- Choose a framework for this serverless API and explain the trade-offs.
- Review this Node.js project for layer boundaries, input validation, and error handling.
- Pick between
async/await,Promise.all, andPromise.allSettledfor these operations.
How to install nodejs-best-practices
1claude-code-templates
npx claude-code-templates@latest --skill development/nodejs-best-practices2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill nodejs-best-practices -a claude-code3Manually: put the files in place
~/.claude/skills/nodejs-best-practices/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/nodejs-best-practices/
Manually: put the files in place
.agents/skills/nodejs-best-practices/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/nodejs-best-practices/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates nodejs-best-practices2Manually: put the files in place
.github/skills/nodejs-best-practices/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/nodejs-best-practicesManually: put the files in place
.devin/skills/nodejs-best-practices/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about nodejs-best-practices
How do I install nodejs-best-practices in Claude Code?
Run npx claude-code-templates@latest --skill development/nodejs-best-practices. The installed skill is available at ~/.claude/skills/nodejs-best-practices/SKILL.md.
What does nodejs-best-practices do?
It helps an agent choose Node.js frameworks, module systems, async patterns, and architecture based on the project context. It also covers validation, security, error handling, and testing.
Which tools can the skill use?
Its configuration allows Read, Write, Edit, Glob, and Grep. The testing guidance discusses node:test, Vitest, Supertest, and Playwright.
