Skip to main content
subagent CX Codex

nodejs-expert · 0xfurai — Claude Code subagent: what it does, how to install

nodejs-expert — a Claude subagent for server-side Node.js work: async patterns, streams, Express APIs, profiling. Tests, linting and a dependency audit are part of its brief.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/nodejs-expert.md
Open on GitHub

What nodejs-expert does

The instructions cover the server side of Node.js: async/await, the event loop, streams, npm, Express routes and performance profiling. Four sections make up the file — focus areas, working approach, a quality checklist and expected deliverables. The last one is where it gets opinionated: tests on Jest or Mocha, ESLint with Prettier, JSDoc comments and npm audit runs count as part of the job.

Setup is a single file at .claude/agents/nodejs-expert.md. No scripts ship with it.

Express is the only framework the checklist names, so a Fastify or Koa codebase will need those middleware points rewritten before the advice fits.

What it helps with

  • Trace which handler blocks the event loop
  • Set up error middleware for an Express API
  • Move large file reads onto streams
  • Close vulnerabilities flagged by npm audit
  • Add Jest tests and lint rules to a running service

Example prompts for the agent

  • Review this Express route and point out where the event loop gets blocked
  • Rewrite the log reader with streams and handle errors in the pipeline
  • Go through npm audit findings in package.json and tell me what to bump

How to install nodejs-expert

Manually: put the files in place

.claude/agents/nodejs-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about nodejs-expert

How do I install nodejs-expert in Claude Code?

Copy nodejs-expert.md into the .claude/agents/ folder of your project. That file is the whole agent.

What does nodejs-expert do?

It acts as a Node.js specialist for backend work: async code, event-driven design, streams, Express endpoints and performance checks, all measured against a fixed quality checklist.

Does it work for a Fastify project?

Partly. Express.js is the framework named in its checklist, so the middleware and routing items need adjusting for Fastify.

Source text

nodejs-expert.md · MIT
---
name: nodejs-expert
description: Specializes in Node.js development, focusing on performance optimization, asynchronous programming, and best practices for building scalable server-side applications.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Efficient asynchronous programming with async/await
- Event-driven architecture and event loop in Node.js
- Building scalable network applications using Node.js
- Streamlining data handling with Streams in Node.js
- Managing packages and dependencies with npm
- Error handling and debugging in Node.js applications
- Creating RESTful APIs with Express.js
- Utilizing Node.js built-in modules effectively
- Optimizing Node.js application performance
- Implementing security best practices in Node.js

## Approach

- Use async/await for cleaner and more readable asynchronous code
- Structure applications using modular code organization
- Leverage event emitters for efficient event-driven programming
- Profile and monitor applications using Node.js performance tools
- Implement logging and monitoring for application insights
- Ensure proper error handling with try/catch and error middleware
- Use Streams for efficient data processing and manipulation
- Maintain code quality through consistent code style and linting
- Optimize performance by minimizing synchronous blocking code
- Secure applications by validating input and managing dependencies

## Quality Checklist

- Code follows standard JavaScript conventions and ES6+ features
- All asynchronous operations are handled efficiently
- Application is modular with clear separation of concerns
- Comprehensive unit testing for all key components
- Security vulnerabilities are regularly checked and addressed
- Ensure high test coverage with Jest or Mocha testing frameworks
- Use ESLint and Prettier for maintaining code quality
- Optimize start-up and response times for API endpoints
- Properly manage and update npm dependencies
- Document API endpoints and key code sections with JSDoc

## Output

- High-performance Node.js application with clean architecture
- Modular and maintainable codebase following Node.js best practices
- Secure and scalable server-side application ready for deployment
- Comprehensive test suite with extensive coverage reports
- Automated build and deployment scripts for CI/CD pipelines
- Detailed documentation of application functionalities and APIs
- Logging and monitoring setup for proactive error management
- Dependency management and security updates using npm audit
- Optimized resource management with effective use of clustering
- Readable and well-documented source code following industry standards

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Programming languages →

nodejs-expert by other authors comes first.

nodejs-expert carlrannaberg nodejs-expert — a Node.js runtime subagent for Claude. It chases unhandled rejections, ESM and CommonJS clashes, memory growth and a stalled event loop, then patches the code behind them. CX Codex ★ 763repo stars nodejs-backend-patterns Seth Hobson nodejs-backend-patterns tells the agent how to build Express and Fastify servers: middleware, error handling, auth, database integration. CX Codex +1 48,535installs nodejs-development Mindrally The nodejs-development Claude Code skill guides Node.js and TypeScript development for server-side and client-side code. CX Codex +1 800installs nodejs-backend alinaqi nodejs-backend — a skill that lays out Node.js project structure and ready-made patterns for Express, Fastify and repositories. It kicks in when the agent edits code under src/api, src/routes or src/server. CX Codex +1 445installs nodejs-best-practices davila7 nodejs-best-practices is a Claude Code skill for choosing Node.js tools and architecture in context. It responds to requests about frameworks, async code, security, and testing. CX Codex +1 501installs nodejs-express-server aj-geddes nodejs-express-server is a Claude Code skill for building Express.js servers with routes, middleware, and authentication. It activates for REST API work and request handling. CX Codex +1 3,300installs nodejs-mongodb-cursorrules-prompt-file-tutorial PatrickJS nodejs-mongodb-cursorrules-prompt-file-tutorial guides Cursor through building a Node.js and MongoDB backend with Express, Mongoose, and specific pool entry game logic. CX Codex +1 ★ 41,178repo stars

From the same set137

The whole set →
dynamodb-expert The dynamodb-expert subagent for Claude Code helps design DynamoDB schemas, choose keys and indexes, and review queries and capacity settings when designing or checking a database. CX Codex ★ 1,029repo stars grpc-expert grpc-expert — a Claude subagent for gRPC work: streaming, protobuf, channel setup, load balancing and tracing. Useful when calls fail with vague status codes. CX Codex ★ 1,029repo stars postgres-expert postgres-expert helps design PostgreSQL schemas, optimize slow SQL queries, and configure indexes for balanced read and write performance. CX Codex ★ 1,029repo stars graphql-expert The graphql-expert subagent helps design GraphQL schemas, improve queries, and review API architecture. Use it when performance, introspection, or schema changes need attention. CX Codex ★ 1,029repo stars rails-expert rails-expert guides Claude Code through Ruby on Rails development with ActiveRecord optimizations, RSpec testing patterns, and architectural conventions. CX Codex ★ 1,029repo stars elasticsearch-expert The elasticsearch-expert subagent helps inspect Elasticsearch clusters, refine search queries, and plan indexing and recovery work. Use it when troubleshooting cluster health or tuning performance. CX Codex ★ 1,029repo stars gitlab-ci-expert gitlab-ci-expert — a Claude subagent that writes and reviews .gitlab-ci.yml: stage order, caching, artifacts, conditional jobs, masked secrets. Useful when a pipeline rebuilds the same things on every commit. CX Codex ★ 1,029repo stars prisma-expert prisma-expert designs Prisma schemas, refines database queries, and manages migrations. Useful for keeping TypeScript database code strictly typed and performant. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open