Nodejs Architecture

Use when the user asks about Node.js backend architecture, choosing Express vs Fastify vs Hono, Node project structure, middleware order, central error handling or env validation with Zod. Produces a Node service layout. Not for one framework in depth (use nodejs-express-skill, nodejs-fastify or nodejs-hono).

45 stars 6 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add j4flmao/agent-skills --skill nodejs-architecture
Manual install
git clone --depth 1 https://github.com/j4flmao/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/backend/nodejs/architecture ~/.claude/skills/nodejs-architecture

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Node.js Architecture

## Purpose
Define and enforce Node.js backend architecture, framework selection, and middleware pipeline conventions.

## Agent Protocol

### Trigger
User request includes: `node.js`, `nodejs`, `express`, `fastify`, `hono`, `node backend`, `node project structure`, `middleware`, `node.js routing`.

### Input Context
- Framework (Express, Fastify, Hono)
- Runtime (Node.js 22 or 24 LTS — 18 and 20 are end-of-life; Bun, Deno)
- Language (JavaScript, TypeScript)
- Project type (REST API, GraphQL, BFF)

### Output Artifact
A markdown document containing:
- Project structure
- Middleware pipeline ordering
- Routing conventions
- Error handling strategy
- Validation setup (Zod, Joi)
- Dependency injection pattern
- Testing setup

### Response Format
Produce the artifact directly. No preamble, no postamble, no explanations. No filler, no hedging, no transitions. Strip articles a/an/the where unambiguous. Compress output — why use many token when few do trick.

### Completion Criteria
- Project structure follows separation of concerns
- Middleware pipeline ordered by responsibility
- Error handler catches all exceptions
- Validation integrated with schema library

### Max Response Length
4096 tokens

## Workflow

### Step 1: Select Framework

| Framework | Performance | Ecosystem | TypeScript | When |
|---|---|---|---|---|
| **Express** | Moderate | Largest | Manual setup | Large ecosystem, legacy, most devs know it |
Read the full skill on GitHub

Details

Skill name
nodejs-architecture
Path
skills/backend/nodejs/architecture/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Nodejs Architecture skill do?

Use when the user asks about Node.js backend architecture, choosing Express vs Fastify vs Hono, Node project structure, middleware order, central error handling or env validation with Zod. Produces a Node service layout. Not for one framework in depth (use nodejs-express-skill, nodejs-fastify or nodejs-hono).

How do I install the Nodejs Architecture skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add j4flmao/agent-skills --skill nodejs-architecture. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Nodejs Architecture popular?

It lives in j4flmao/agent-skills, which has 45 GitHub stars and 6 forks.

Related skills

Agent Observability

45

j4flmao/agent-skills

Use when the user asks about agent observability, tracing agent reasoning, debugging an agent loop, OpenTelemetry GenAI spans for LLM calls, LLM cost tracking per agent, agent audit logs or hallucination/eval monitoring in production. Produces instrumentation config, trace schema, dashboards, alerts and cost attribution. Not for generic service tracing without LLMs (use devops-opentelemetry).

DevOps & Cloud

AI Agent Architectures

45

j4flmao/agent-skills

Use when the user asks to build an AI agent, design an agent that calls tools and keeps memory, write an agent system prompt or pick an agent framework (Claude Agent SDK, OpenAI Agents SDK, LangGraph). Produces an architecture brief covering loop, tools, memory, guardrails and evals, routing depth to child skills. Not for workflow patterns (use ai-agentic-workflows).

AI, LLMs & Agents

AI Agent Core Loop

45

j4flmao/agent-skills

Use when the user asks about the agent loop, ReAct vs plan-and-solve, re-planning, Reflexion, an agent stuck in a loop, max iterations or termination conditions. Produces a loop spec or patch with state, success predicate, caps and no-progress detection. Not for overall agent design (use ai-agent-architectures) or tool schemas (use tool-calling-principles).

AI, LLMs & Agents

Nodejs Express Skill

45

j4flmao/agent-skills

Use when the user asks about Express.js, Express 5, Express middleware order, Express routers, Express error handler, Zod validation in Express or graceful shutdown. Produces an Express app factory with modules and tests. Not for Fastify (use nodejs-fastify) or NestJS (use nestjs-architecture).

Software Development

Nestjs Patterns

45

j4flmao/agent-skills

Use when the user asks about NestJS guards, interceptors, pipes, exception filters, custom decorators, @nestjs/cqrs or NestJS microservices (@MessagePattern). Produces NestJS request-pipeline and CQRS code. Not for module layout and DI scopes (use nestjs-architecture).

Software Development

Nodejs Fastify

45

j4flmao/agent-skills

Use when the user asks about Fastify, Fastify plugins and encapsulation, JSON Schema or TypeBox route schemas, Fastify hooks, serializers or @fastify/swagger. Produces Fastify 5 apps with schema-validated routes. Not for Express (use nodejs-express-skill).

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.