How do I install the Nx skill?

Run npx skillmds@latest add claude-dev-suite/nx in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nx?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

claude-dev-suite (@claude-dev-suite) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nx by claude-dev-suite — Agent Skill

Name: Nx
Rating: 4.2 (5 reviews)
Author: claude-dev-suite

Nx build system and monorepo tools. Advanced task orchestration, generators, and plugins. Use for complex enterprise monorepos with multiple technologies. USE WHEN: user mentions "Nx", "nx.json", "Nx monorepo", "Nx generators", asks about "Nx workspace", "affected commands", "module boundaries" DO NOT USE FOR: Turborepo (use turborepo skill), simple monorepos (Turborepo is simpler), single-package projects

claude-dev-suite Updated Aug 19, 2026 28 repo stars

File contents

Nx - Quick Reference

Full Reference: See advanced.md for custom generators, custom executors, remote/self-hosted cache, module boundaries, and CI/CD GitHub Actions setup.

Deep Knowledge: Use mcp__documentation__fetch_docs with technology: nx for comprehensive documentation.

Setup

# New workspace
npx create-nx-workspace@latest my-workspace

# Add to existing repo
npx nx@latest init

Project Structure

my-workspace/
├── nx.json
├── apps/
│   ├── web/project.json
│   └── api/project.json
└── libs/
    ├── ui/project.json
    └── utils/project.json

Configuration (nx.json)

{
  "targetDefaults": {
    "build": {
      "dependsOn": ["^build"],
      "inputs": ["production", "^production"],
      "cache": true
    },
    "test": {
      "inputs": ["default", "^production"],
      "cache": true
    }
  },
  "namedInputs": {
    "default": ["{projectRoot}/**/*", "sharedGlobals"],
    "production": ["default", "!{projectRoot}/**/*.spec.ts"]
  }
}

Running Tasks

# Run target
nx build web
nx test api

# Run for all projects
nx run-many -t build
nx run-many -t build test lint

# Affected (changed since base)
nx affected -t build
nx affected -t test --base=main

# Graph
nx graph

Generators

# Generate application
nx g @nx/react:app my-app
nx g @nx/node:app my-api

# Generate library
nx g @nx/react:lib ui --directory=libs/shared

# Generate component
nx g @nx/react:component button --project=ui

# Dry run
nx g @nx/react:lib feature --dry-run

Plugins

# Add plugin
nx add @nx/react
nx add @nx/node
nx add @nx/vite

Caching

# Skip cache
nx build web --skip-nx-cache

# Clear cache
nx reset

Comparison: Nx vs Turborepo

Feature	Nx	Turborepo
Configuration	TypeScript	JSON
Generators	Advanced	Basic
Plugins	50+	Limited
Module boundaries	Enforced	Manual
Learning curve	Steeper	Lower

When NOT to Use This Skill

Simple monorepos - Turborepo has simpler configuration
Single package - No need for monorepo tools
Quick setup needed - Turborepo is faster to configure

Anti-Patterns

Anti-Pattern	Why It's Bad	Correct Approach
Ignoring module boundaries	Tight coupling	Enforce with @nx/enforce-module-boundaries
Circular dependencies	Build failures	Use nx graph to detect and fix
Not using affected	Wastes CI time	Always use nx affected in CI
Missing project tags	Can't enforce constraints	Tag all projects properly
No workspace generators	Inconsistent code	Create generators for common patterns

Quick Troubleshooting

Issue	Cause	Solution
Module boundary violation	Wrong import	Check depConstraints in .eslintrc.json
Circular dependency	Projects import each other	Use nx graph, refactor to shared lib
Affected not working	Missing dependencies	Check implicit dependencies
Cache not working	Missing outputs	Add outputs to target configuration
Build order wrong	Missing dependsOn	Add dependsOn: ["^build"]

Production Checklist

nx.json configured
project.json for each project
Module boundaries with tags
Affected in CI pipeline
Nx Cloud for remote cache
Generators for consistency

Reference Documentation

Nx Docs

---name: nxdescription: Nx build system and monorepo tools. Advanced task orchestration, generators, and plugins. Use for complex enterprise monorepos with multiple technologies. USE WHEN: user mentions "Nx", "nx.json", "Nx monorepo", "Nx generators", asks about "Nx workspace", "affected commands", "module boundaries" DO NOT USE FOR: Turborepo (use turborepo skill), simple monorepos (Turborepo is simpler), single-package projects---# Nx - Quick Reference> **Full Reference**: See [advanced.md](advanced.md) for custom generators, custom executors, remote/self-hosted cache, module boundaries, and CI/CD GitHub Actions setup.> **Deep Knowledge**: Use `mcp__documentation__fetch_docs` with technology: `nx` for comprehensive documentation.## Setup```bash# New workspacenpx create-nx-workspace@latest my-workspace# Add to existing reponpx nx@latest init```## Project Structure```my-workspace/├── nx.json├── apps/│ ├── web/project.json│ └── api/project.json└── libs/ ├── ui/project.json └── utils/project.json```## Configuration (nx.json)```json{ "targetDefaults": { "build": { "dependsOn": ["^build"], "inputs": ["production", "^production"], "cache": true }, "test": { "inputs": ["default", "^production"], "cache": true } }, "namedInputs": { "default": ["{projectRoot}/**/*", "sharedGlobals"], "production": ["default", "!{projectRoot}/**/*.spec.ts"] }}```## Running Tasks```bash# Run targetnx build webnx test api# Run for all projectsnx run-many -t buildnx run-many -t build test lint# Affected (changed since base)nx affected -t buildnx affected -t test --base=main# Graphnx graph```## Generators```bash# Generate applicationnx g @nx/react:app my-appnx g @nx/node:app my-api# Generate librarynx g @nx/react:lib ui --directory=libs/shared# Generate componentnx g @nx/react:component button --project=ui# Dry runnx g @nx/react:lib feature --dry-run```## Plugins```bash# Add pluginnx add @nx/reactnx add @nx/nodenx add @nx/vite```## Caching```bash# Skip cachenx build web --skip-nx-cache# Clear cachenx reset```## Comparison: Nx vs Turborepo| Feature | Nx | Turborepo ||---------|-----|-----------|| Configuration | TypeScript | JSON || Generators | Advanced | Basic || Plugins | 50+ | Limited || Module boundaries | Enforced | Manual || Learning curve | Steeper | Lower |## When NOT to Use This Skill- **Simple monorepos** - Turborepo has simpler configuration- **Single package** - No need for monorepo tools- **Quick setup needed** - Turborepo is faster to configure## Anti-Patterns| Anti-Pattern | Why It's Bad | Correct Approach ||--------------|--------------|------------------|| Ignoring module boundaries | Tight coupling | Enforce with @nx/enforce-module-boundaries || Circular dependencies | Build failures | Use nx graph to detect and fix || Not using affected | Wastes CI time | Always use nx affected in CI || Missing project tags | Can't enforce constraints | Tag all projects properly || No workspace generators | Inconsistent code | Create generators for common patterns |## Quick Troubleshooting| Issue | Cause | Solution ||-------|-------|----------|| Module boundary violation | Wrong import | Check depConstraints in .eslintrc.json || Circular dependency | Projects import each other | Use nx graph, refactor to shared lib || Affected not working | Missing dependencies | Check implicit dependencies || Cache not working | Missing outputs | Add outputs to target configuration || Build order wrong | Missing dependsOn | Add dependsOn: ["^build"] |## Production Checklist- [ ] nx.json configured- [ ] project.json for each project- [ ] Module boundaries with tags- [ ] Affected in CI pipeline- [ ] Nx Cloud for remote cache- [ ] Generators for consistency## Reference Documentation- [Nx Docs](https://nx.dev/getting-started/intro)

Frequently asked questions

Nx