Agent skill · software engineering · davila7
nodejs-best-practices
Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying.
Why this skill is useful
Provides a decision-making framework for selecting Node.js frameworks and architectural patterns that the AI wouldn't generate on its own.
What it needs
About 5k tokens when loaded. Last updated 2026-08-06. 30,138 stars on the source repository.
What this skill does
Node.js Best Practices Principles and decision-making for Node.js development in 2025. Learn to THINK, not memorize code patterns. --- ⚠️ How to Use This Skill This skill teaches decision-making principles, not fixed code to copy. ASK user for preferences when unclear Choose framework/pattern based on CONTEXT Don't default to same solution every time --- 1. Framework Selection (2025) Decision Tree Comparison Principles Factor Hono Fastify Express -------- ------ --------- --------- Best for Edge, serverless Performance Legacy, learning Cold start Fastest Fast Moderate Ecosystem Growing Good Largest TypeScript Native Excellent Good Learning curve Low Medium Low Selection Questions to Ask: 1. What's the deployment target? 2. Is cold start time critical? 3. Does team have existing experience? 4. Is there legacy code to maintain? --- 2. Runtime Considerations (2025) Native TypeScript Module System Decision Runtime Selection Runtime Best For --------- ---------- Node.js General purpose, largest ecosystem Bun Performance, built-in bundler Deno Security-first, built-in TypeScript --- 3. Architecture Principles Layered Structure Concept Why This Matters: Testability: Mock layers independently Flexibility: Swap database without touching business logic Clarity: Each layer has single responsibility When to Simplify: Small scripts → Single file OK Prototypes → Less structure acceptable Always ask: "Will this grow?" --- 4. Error Handling Principles Centralized Error Handling Error Response Philosophy Status Code Selection Situation Status When ----------- -------- ------ Bad input 400 Client sent invalid data No auth 401 Missing or invalid credentials No permission 403 Valid auth, but not allowed Not found 404 Resource doesn't exist Conflict 409 Duplicate or state conflict Validation 422 Schema valid but business rules fail Server error 500 Our fault, log everything --- 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills davila7/nodejs-best-practices