Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying.
The nodejs-best-practices skill provides developers with guiding principles and decision-making strategies for building robust and maintainable Node.js applications. Instead of offering ready-made code snippets, this skill focuses on teaching the rationale behind choosing frameworks, runtime environments, architecture patterns, and error-handling strategies. It addresses common challenges in Node.js development, such as asynchronous programming, security concerns, deployment considerations, and team collaboration, helping developers make informed choices tailored to their project context.
Key features include a structured framework selection decision tree, comparisons of popular frameworks like Hono, Fastify, Express, and NestJS, and guidance on runtime environments including Node.js, Bun, and Deno. It covers architecture principles with layered structures that enhance testability and flexibility, runtime decisions between ESM and CommonJS, native TypeScript usage, and centralized error-handling patterns with consistent logging and client response philosophies. Selection questions are suggested to ensure decisions align with project goals and team expertise.
This skill is ideal for Node.js developers, software architects, and teams who need to make high-level technical decisions rather than memorize code patterns. It is particularly useful when designing new projects, evaluating framework choices, implementing secure and scalable architectures, or maintaining legacy systems. Use cases include building serverless applications, high-performance APIs, enterprise-grade applications, and full-stack solutions with integrated frontend frameworks. By emphasizing thinking over rote memorization, it equips developers to adapt best practices to evolving project needs.
Use it as a decision-making guide rather than a source of copy-paste code. Apply its principles when choosing frameworks, designing architecture, handling async operations, or implementing security best practices.
It covers frameworks like Hono, Fastify, Express, NestJS, and full-stack options like Next.js or tRPC. Runtime environments include Node.js, Bun, and Deno, along with guidance on ESM and CommonJS module systems.
Yes. For smaller projects, the skill suggests simplified structures or single-file approaches while still applying core best practices where appropriate.
No. It focuses on teaching principles, reasoning, and decision-making strategies rather than providing fixed code patterns to copy.
This skill assumes familiarity with Node.js development concepts, TypeScript, and basic web application architecture. It does not replace framework documentation or detailed API references.
Quick Setup:
.claude/skills/Repository
sickn33/antigravity-awesome-skills