PlugWiki

nx-workspace-patterns Skill (wshobson) for Claude: What It Does and How to Install It

Gives Claude Nx monorepo patterns: project layout, module boundaries, generators, affected commands in CI and remote caching.

Installs
11K
on skills.sh
Stars
42.1K
on GitHub
Files
1
besides SKILL.md
Updated
Oct 2026
last repo commit

This skill is an Nx reference for Claude, from wshobson's agents collection. SKILL.md shows the folder layout (apps, libs, tools), five library types and do and don't lists. references/details.md holds six templates: nx.json, project configuration, module boundary rules, a custom generator, a CI workflow with affected commands, and remote caching.

It loads when you set up Nx, configure project boundaries, tune build caching or use affected commands. It bundles no scripts. It needs an Nx workspace of your own.

Good for

  • Teams setting up or cleaning up an Nx monorepo
  • Engineers speeding up CI with affected commands and caching
  • Tech leads enforcing project boundaries with tags

Install nx-workspace-patterns

Claude Code

  1. 1

    Copy this prompt.

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

/plugin marketplace add wshobson/agents
/plugin install developer-essentials@claude-code-workflows

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

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

Pick one route. The plugin routes install the whole developer-essentials plugin: 1 agent, 0 commands and 11 skills (counted from the plugin folder in the repo tree, which has no hooks or MCP config files). The skills-only routes install just this skill, with no agents or commands. The skill needs an Nx workspace of your own.

From the project README. Source.

What's in the skill

When it loads

Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.

Sections in SKILL.md

  1. When to Use This Skill
  2. Core Concepts
  3. 1. Nx Architecture
  4. 2. Library Types
  5. Templates and detailed worked examples
  6. Best Practices
  7. Do's
  8. Don'ts

Key facts

Author
wshobson (repo owner)
License
MIT
Installs on skills.sh
11,038 (Nov 2, 2026)
GitHub stars
42,081 for the whole wshobson/agents repo (Nov 2, 2026)
Last repo commit
Oct 30, 2026
What it includes
2 files including SKILL.md: references/details.md holds the 6 templates and a list of common commands (no scripts)
Needs
An Nx workspace. The templates use Nx plugins such as @nx/webpack, @nx/jest and @nx/eslint
Part of
The developer-essentials plugin in wshobson/agents. Counted from the plugin folder: 1 agent, 0 commands and 11 skills
Works in
Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi, per the README. Skills-only installers ask which tool you use

What it includes

  • Layout with apps, libs, tools, nx.json and workspace.json

    Describes where deployable apps, shared libraries and custom executors or generators live.

    Try: “Lay out an Nx workspace for a web app, an API and shared UI libraries.”

    Read · Nx architecture

  • feature, ui, data-access, util and shell

    A table says what each library type is for, with names like feature-auth and util-formatting.

    Read · Library types

  • Caching, named inputs, target defaults and generator defaults

    Marks build, lint, test and e2e as cacheable and sets affected to compare against main.

    Write · Template 1: nx.json

  • A project.json with build, serve, test and lint targets

    Example for apps/web with webpack, dev-server, Jest and ESLint targets and tags.

    Write · Template 2: project configuration

  • ESLint rules that restrict which tags may import which

    Uses the @nx plugin in .eslintrc.json to enforce boundaries.

    Write · Template 3: module boundary rules

  • A TypeScript generator for feature libraries

    Generates files with @nx/devkit under tools/generators/feature-lib.

    Write · Template 4: custom generator

  • GitHub Actions workflow that runs lint, test, build and e2e on affected projects

    Uses npm ci, nrwl/nx-set-shas and the NX_CLOUD_ACCESS_TOKEN secret.

    Runs code · Template 5: CI with affected

  • Nx Cloud runner or a self-hosted S3 cache

    Shows nx.json with an Nx Cloud access token placeholder and an AWS bucket cache option.

    Write · Template 6: remote caching

  • Generate a library, run affected tests, view the graph, reset, migrate

    Includes nx reset (reset cache) and nx migrate latest followed by nx migrate --run-migrations.

    Runs code · Common commands

From the official docs

Permissions

Low risk

The main risk is that Claude changes CI and workspace config in ways that affect every project. Work on a branch and review the workflow and nx.json diffs.

What it can do

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

Watch out for

  • The CI and caching templates use an access token

    Template 5 reads NX_CLOUD_ACCESS_TOKEN from secrets and Template 6 puts an accessToken field in nx.json. Keep the real token in CI secrets, not in the committed file. github.com

  • Migration commands change your workspace

    details.md lists nx migrate latest and nx migrate --run-migrations. Run them on a branch and review what they change. github.com

  • The plugin route installs more than this skill

    The developer-essentials plugin has 11 skills, 1 agent and 0 commands. The repo tree shows no hooks or MCP config files in its folder. The skills-only routes install only this skill. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlyNo read-only mode. Use version control.
Talks toPackage downloads from npm ci and npx nx in the CI template. Nx Cloud, if you use the remote caching template. An S3 bucket, if you use the AWS cache option
Scopes

  • Claude edits nx.json, project.json, ESLint config and generators in your workspace when you ask

  • Template 5 is a GitHub Actions workflow under .github/workflows that reads the NX_CLOUD_ACCESS_TOKEN secret

  • The common commands include nx migrate latest and nx migrate --run-migrations, which update your workspace

Questions

What does the nx-workspace-patterns skill do?

It gives Claude ready patterns for Nx monorepos. Claude uses it to set up workspaces, define project boundaries, speed up CI with affected commands and add remote caching.

How do I install nx-workspace-patterns?

Use the install box at the top of this page. It lists the plugin route and two skills-only commands: npx skills add wshobson/agents --skill nx-workspace-patterns and gh skill install wshobson/agents nx-workspace-patterns (GitHub CLI 2.90 or later). The skills-only commands skip the plugin's agents and commands.

Does it need an Nx Cloud account?

Only for the remote caching template. Template 5 reads an NX_CLOUD_ACCESS_TOKEN secret and Template 6 shows an access token placeholder. The S3 cache option in Template 6 is an alternative.

What are the library types it recommends?

Five: feature, ui, data-access, util and shell. SKILL.md gives a purpose and an example name for each.

Will it work with my existing Nx version?

SKILL.md names no Nx version. The templates mix settings such as tasksRunnerOptions and targetDefaults, so check them against your Nx version and ask Claude to adapt them.

Is it safe?

Installing it adds a guide and one reference file, with no scripts. The templates include a CI workflow that uses a secret, an Nx Cloud token placeholder and migration commands that change your workspace, so review each file or command before you accept it.

Is this skill from Anthropic?

No. It is in wshobson/agents, a community collection. The skill sits in the developer-essentials plugin there.

Should I install the whole developer-essentials plugin?

Only if you want the rest. The README documents a plugin route for Claude Code and Codex. The plugin folder holds 11 skills, 1 agent and 0 commands, and the repo tree shows no hooks or MCP config files in it.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/developer-essentials/skills/nx-workspace-patterns

wshobson/agentsskills.sh

Sources

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

Show all 4
  1. nx-workspace-patterns SKILL.md · github.com
  2. wshobson/agents README · github.com
  3. developer-essentials plugin.json · github.com
  4. nx-workspace-patterns details.md · github.com

Updated Nov 2, 2026.