How do I install the Nx Workspace skill?

Run npx skillmds@latest add gabrielmoreira/nx-workspace 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.

Is Nx Workspace safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nx Workspace?

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.

Is Nx Workspace free to use?

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

Who published Nx Workspace?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nx Workspace by gabrielmoreira — Agent Skill

Name: Nx Workspace
Rating: 4.666666666666667 (3 reviews)
Author: gabrielmoreira

Nx Workspace

Configure, explore, and optimize Nx monorepo workspaces. Use when setting up Nx, exploring workspace structure, configuring project boundaries, analyzing affected projects, optimizing build caching, or implementing CI/CD with affected commands. Keywords — nx, monorepo, workspace, projects, targets, affected. Do NOT use for running tasks (use nx-run-tasks) or code generation with generators (use nx-generate).

gabrielmoreira Updated Sep 9, 2026 17 repo stars

File contents

Nx Workspace Management

Quick Start

Exploring workspace: nx show projects and nx show project <name> --json
Running tasks: nx <target> <project> (e.g., nx build my-app)
Affected analysis: nx show projects --affected or nx affected -t <target>

Note: Prefix commands with npx/pnpx/yarn if nx isn't installed globally.

Core Commands

List and Explore Projects

# List all projects
nx show projects

# Filter by type, pattern, or target
nx show projects --type app
nx show projects --projects "apps/*"
nx show projects --withTarget build

# Find affected projects
nx show projects --affected --base=main

Get Project Information

Critical: Always use nx show project <name> --json for full resolved configuration. Do NOT read project.json directly - it contains only partial configuration.

# Get full configuration
nx show project my-app --json

# Extract targets
nx show project my-app --json | jq '.targets | keys'

Configuration schemas:

Workspace: node_modules/nx/schemas/nx-schema.json
Project: node_modules/nx/schemas/project-schema.json

Run Tasks

# Run specific project
nx build web --configuration=production

# Run affected
nx affected -t test --base=main

# View dependency graph
nx graph

Workspace Architecture

workspace/
├── apps/              # Deployable applications
├── libs/              # Shared libraries
│   ├── shared/        # Shared across scopes
│   └── feature/       # Feature-specific
├── nx.json            # Workspace configuration
└── tools/             # Custom executors/generators

Library Types

Type	Purpose	Example
feature	Business logic, smart components	`feature-auth`
ui	Presentational components	`ui-buttons`
data-access	API calls, state management	`data-access-users`
util	Pure functions, helpers	`util-formatting`

Detailed Resources

Configuration: See reference/configuration.md for:

nx.json templates and options
project.json structure
Module boundary rules
Remote caching setup

Commands: See reference/commands.md for:

Complete command reference
Advanced filtering options
Common workflows

CI/CD: See reference/ci-cd.md for:

GitHub Actions configuration
GitLab CI setup
Jenkins, Azure Pipelines, CircleCI examples
Affected commands in pipelines

Best Practices: See reference/best-practices.md for:

Do's and don'ts
Complete troubleshooting guide
Performance optimization
Migration guides

Common Workflows

"What's in this workspace?"

nx show projects --type app  # List applications
nx show projects --type lib  # List libraries

"How do I run project X?"

nx show project X --json | jq '.targets | keys'

"What changed?"

nx show projects --affected --base=main

Quick Troubleshooting

Targets not showing: Use nx show project <name> --json, not project.json
Affected not working: Ensure git history available (fetch-depth: 0 in CI)
Cache issues: Run nx reset

For detailed troubleshooting, see reference/best-practices.md.

---name: nx-workspacedescription: Configure, explore, and optimize Nx monorepo workspaces. Use when setting up Nx, exploring workspace structure, configuring project boundaries, analyzing affected projects, optimizing build caching, or implementing CI/CD with affected commands. Keywords — nx, monorepo, workspace, projects, targets, affected. Do NOT use for running tasks (use nx-run-tasks) or code generation with generators (use nx-generate).--- # Nx Workspace Management ## Quick Start **Exploring workspace**: `nx show projects` and `nx show project <name> --json` **Running tasks**: `nx <target> <project>` (e.g., `nx build my-app`) **Affected analysis**: `nx show projects --affected` or `nx affected -t <target>` > **Note**: Prefix commands with `npx`/`pnpx`/`yarn` if nx isn't installed globally. ## Core Commands ### List and Explore Projects ```bash # List all projects nx show projects # Filter by type, pattern, or target nx show projects --type app nx show projects --projects "apps/*" nx show projects --withTarget build # Find affected projects nx show projects --affected --base=main ``` ### Get Project Information **Critical**: Always use `nx show project <name> --json` for full resolved configuration. Do NOT read `project.json` directly - it contains only partial configuration. ```bash # Get full configuration nx show project my-app --json # Extract targets nx show project my-app --json | jq '.targets | keys' ``` Configuration schemas: - Workspace: `node_modules/nx/schemas/nx-schema.json` - Project: `node_modules/nx/schemas/project-schema.json` ### Run Tasks ```bash # Run specific project nx build web --configuration=production # Run affected nx affected -t test --base=main # View dependency graph nx graph ``` ## Workspace Architecture ``` workspace/ ├── apps/ # Deployable applications ├── libs/ # Shared libraries │ ├── shared/ # Shared across scopes │ └── feature/ # Feature-specific ├── nx.json # Workspace configuration └── tools/ # Custom executors/generators ``` ### Library Types | Type | Purpose | Example | | --------------- | -------------------------------- | ------------------- | | **feature** | Business logic, smart components | `feature-auth` | | **ui** | Presentational components | `ui-buttons` | | **data-access** | API calls, state management | `data-access-users` | | **util** | Pure functions, helpers | `util-formatting` | ## Detailed Resources **Configuration**: See [reference/configuration.md](reference/configuration.md) for: - nx.json templates and options - project.json structure - Module boundary rules - Remote caching setup **Commands**: See [reference/commands.md](reference/commands.md) for: - Complete command reference - Advanced filtering options - Common workflows **CI/CD**: See [reference/ci-cd.md](reference/ci-cd.md) for: - GitHub Actions configuration - GitLab CI setup - Jenkins, Azure Pipelines, CircleCI examples - Affected commands in pipelines **Best Practices**: See [reference/best-practices.md](reference/best-practices.md) for: - Do's and don'ts - Complete troubleshooting guide - Performance optimization - Migration guides ## Common Workflows **"What's in this workspace?"** ```bash nx show projects --type app # List applications nx show projects --type lib # List libraries ``` **"How do I run project X?"** ```bash nx show project X --json | jq '.targets | keys' ``` **"What changed?"** ```bash nx show projects --affected --base=main ``` ## Quick Troubleshooting - **Targets not showing**: Use `nx show project <name> --json`, not project.json - **Affected not working**: Ensure git history available (`fetch-depth: 0` in CI) - **Cache issues**: Run `nx reset` For detailed troubleshooting, see [reference/best-practices.md](reference/best-practices.md).

Frequently asked questions