nx-workspace skill from Nx for Claude Code: explore projects, targets and dependencies

Nx's own skill that makes Claude answer questions about an Nx monorepo by running nx commands instead of guessing.

Installs: 81.9K; on skills.sh
Stars: 29; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

nx-workspace makes Claude explore an Nx workspace with nx show projects, nx show project --json and nx graph --print, then compute answers with jq. SKILL.md calls it read-only exploration. It triggers on questions about projects, targets and dependencies, and when an nx command fails. The skill is from the Nx team, needs nx available in the workspace, and has one reference file for affected projects.

Good for

Developers working in an Nx monorepo with Claude Code
Anyone asking what depends on a library or which targets a project has
Teams debugging an nx task that fails with a configuration error

Install nx-workspace

Claude Code

Copy this prompt.

Install the nx-workspace skill in Claude Code. Run this command:

nx configure-ai-agents

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires An Nx workspace with nx installed.

Pick one route, not both. nx configure-ai-agents is the route the README leads with. The README tells you to disable the existing nx@nx-claude-plugins plugin in .claude/settings.json when you enable the preview plugin, because both are named nx. The skills CLI route installs only this skill.

From the project README. Source.

What's in the skill

When it loads

Explore and understand Nx workspaces. USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails or you need to check available targets/configuration before running a task. EXAMPLES: 'What projects are in this workspace?', 'How is project X configured?', 'What depends on library Y?', 'What targets can I run?', 'Cannot find configuration for task', 'debug nx task failure'.

Sections in SKILL.md

Listing Projects
Project Configuration
Target Information
Workspace Configuration
Affected Projects
Common Exploration Patterns
"What's in this workspace?"
"How do I build/test/lint project X?"
"What depends on library Y?"
Programmatic Answers
Listing Projects
Project Details
Project Graph
Troubleshooting
"Cannot find configuration for task X:target"
"The workspace is out of sync"

Key facts

Author: Nx (Narwhal Technologies Inc); the vendor's own repo, described as official Nx AI agent artifacts
License: MIT (LICENSE file and plugin manifest)
Installs on skills.sh: 81,890 as of 2026-11-02
GitHub stars: 29 for the whole nx-ai-agents-config repo, 2026-11-02
What is inside: 2 files: SKILL.md and references/AFFECTED.md
Part of: The nx plugin (6 skills in the repo, plus the nx MCP server) and the repo-wide Nx AI agent setup
Needs: Nx in the workspace; SKILL.md says to prefix with npx, pnpx or yarn if nx is not installed globally
Last repo commit: 2026-10-29
Works in: Claude Code, Cursor, GitHub Copilot, Gemini and OpenCode badges in the README; Codex plugin commands in the README

What it includes

nx show projects with filters
Filters by glob, tag, directory, target or affected status, negation, and --json output for jq.
Try: “Which projects in this workspace have a build target?”
Runs code · Listing projects
nx show project <name> --json
Gets the full resolved config including targets inferred from plugins. SKILL.md says not to read project.json directly because it holds only part of the config.
Try: “How is the checkout-ui project configured?”
Runs code · Project configuration
Inspects executors, options, inputs and outputs
Uses nx show project with jq to list targets and read a target's executor, command, options, inputs and outputs.
Runs code · Target information
Reads nx.json and the schemas in node_modules
Reads nx.json directly with cat and jq, and can read nx-schema.json and project-schema.json under node_modules/nx/schemas.
Files · Workspace configuration
Points to references/AFFECTED.md
A reference file with commands for projects affected since a base branch, between two commits, by uncommitted changes or by untracked files.
Try: “What is affected by my changes compared to main?”
Runs code · Affected projects
What is in the workspace, how to build X, what depends on Y
Short recipes using nx show projects, nx show project and nx graph --print piped into jq.
Runs code · Exploration patterns
Use --json and jq instead of counting by hand
SKILL.md tells Claude to compute answers such as project counts with command-line tools and structured output.
Runs code · Programmatic answers
Cannot find configuration for task, out of sync workspace
Checks which targets exist with nx show project. For an out-of-sync workspace it lists nx sync, and nx reset if sync does not fix a stale cache.
Runs code · Troubleshooting

From the official docs

Permissions

Low risk

The skill runs nx and shell commands in your workspace, and its troubleshooting lists nx sync and nx reset. Check what a command changes before you approve it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Troubleshooting runs nx sync and nx reset
SKILL.md calls the skill read-only exploration, but its troubleshooting section lists nx sync and, if that fails, nx reset. Check what those commands will change in your workspace before approving them. github.com
The plugin route adds 5 more skills and an MCP server
The nx plugin holds 6 skills (counted from plugins/nx/skills in the git tree): link-workspace-packages, nx-generate, nx-import, nx-plugins, nx-run-tasks and nx-workspace, not only this one. Its mcp.json runs npx nx-mcp@latest --minimal, a package npx fetches at that version tag. Use the skills command if you want only this skill. github.com
The nx-cloud plugin is separate
The README's preview commands install a second plugin, nx-cloud, whose mcp.json points to a hosted Nx Cloud MCP server. You do not need it for nx-workspace. github.com

Technical details

Turning on read-only	No switch. SKILL.md describes the skill as read-only exploration of Nx workspaces, but its troubleshooting lists nx sync and nx reset.
Sign-in and keys	SKILL.md names no account or API key.
Data retention	SKILL.md names no logging or telemetry.
Scopes	Runs nx and jq commands in your workspace and reads nx.json and project settings Troubleshooting lists nx sync and nx reset Plugin route: the nx MCP server runs through npx

Questions

What does nx-workspace do?

It makes Claude explore an Nx workspace with the nx command line: list projects, read resolved project and target configuration, find affected projects and trace dependencies, then answer from structured output.

How do I install nx-workspace?

Use the install box at the top of this page. The README leads with running nx configure-ai-agents in your workspace. The plugin route is marked a preview.

Is it official?

Yes. It is in the Nx team's own nx-ai-agents-config repo, which the README describes as official AI agent configuration for Nx.

Does it change my workspace?

SKILL.md describes it as read-only exploration. Its troubleshooting section also lists nx sync and nx reset, so check what Claude proposes to run.

Do I need Nx installed?

Yes. The skill runs nx commands. If nx is not installed globally, SKILL.md says to prefix commands with npx, pnpx or yarn, depending on your lockfile.

Why does Claude not read project.json?

SKILL.md says project.json holds only partial configuration. nx show project --json returns the full resolved config, including targets inferred from plugins.

Is nx-workspace safe to install?

The skill folder holds SKILL.md and one reference file, and bundles no scripts. It has Claude run nx and jq commands in your workspace. The plugin route adds an MCP server started with npx; see the safety section.

Can I use it in the Claude app?

Our advice: use Claude Code, Cursor, Codex or another coding agent. This page offers no Claude app upload because the skill runs nx in your local workspace.

Information

updated Nov 2, 2026

Repository: nrwl/nx-ai-agents-config
Folder: skills/nx-workspace

nrwl/nx-ai-agents-config skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 9

README · github.com
plugins marketplace.json · github.com
nx-workspace on skills.sh · skills.sh
nx-workspace SKILL.md · github.com
LICENSE · github.com
plugin.json · github.com
references/AFFECTED.md · github.com
plugins/nx/mcp.json · github.com
plugins/nx-cloud/mcp.json · github.com