nodejs-best-practices

Guide Node.js framework selection and development decisions.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Geargrindadmin/gg-agentic-harness --skill nodejs-best-practices-geargrindadmin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nodejs-best-practices
Source: https://github.com/Geargrindadmin/gg-agentic-harness/tree/main/.agent/skills/nodejs-best-practices
Command: npx skills add https://github.com/Geargrindadmin/gg-agentic-harness --skill nodejs-best-practices-geargrindadmin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers make informed decisions about Node.js development, focusing on principles and context rather than rote memorization of code patterns.

Core Features & Use Cases

  • Framework Selection: Guides choices between Hono, Fastify, NestJS, Express, and Next.js based on project needs.
  • Runtime & Module Systems: Advises on native TypeScript, ESM vs. CommonJS, and runtime choices like Node.js, Bun, or Deno.
  • Architecture & Error Handling: Promotes layered structures and robust error handling strategies.
  • Use Case: A developer is starting a new high-performance API project and is unsure whether to use Express or Fastify. This Skill provides a decision tree and comparison to help them choose Fastify.

Quick Start

Use the nodejs-best-practices skill to understand the decision-making process for selecting a Node.js framework.

Frequently Asked Questions about nodejs-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the best Node.js framework for my new API project?

For high-performance Node.js APIs, Fastify is often recommended over Express due to its lower overhead. This Skill provides decision trees comparing framework selection criteria to guide your architecture choice.

When should I use ESM instead of CommonJS in Node.js development?

Use ESM in Node.js when adopting native TypeScript and modern async patterns. This Skill advises on module system selection and runtime considerations to align with modern application architectures.

What is the best way to structure Node.js architecture and error handling?

Structure Node.js architecture using layered designs and robust error handling strategies. This approach separates concerns and ensures resilient async patterns across the application.

Does this Node.js guidance support alternative runtimes like Bun or Deno?

Yes, this Node.js guidance supports alternative runtimes like Bun and Deno. It provides runtime considerations and decision-making context to help evaluate these environments for modern development.

What prerequisites do I need to understand Node.js development principles?

Prerequisites include understanding JavaScript, the Node.js ecosystem, and software design principles. This foundation enables informed decisions regarding architecture, security, and testing.

Why focus on decision-making principles rather than rote code patterns for Node.js?

Focusing on decision-making principles rather than rote code patterns solves the problem of adapting to new challenges. It teaches context for framework selection, validation, and security to ensure scalable architecture.