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
.claude/agents/nodejs-expert.mdWhat 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 auditfindings inpackage.jsonand tell me what to bump
How to install nodejs-expert
Manually: put the files in place
.claude/agents/nodejs-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/nodejs-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/nodejs-expert.mdCursor also reads .claude/agents/
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.