🎯

nx-workspace-patterns

🎯Skill

Helps you set up and organize an Nx workspace, a tool for keeping many apps and shared code in one repository. It explains how to split code, stop messy links between parts, and speed up builds by only rebuilding what changed.

wshobson/agents8,328 Installs27,673Added Jan 31, 2026

Installation

$npx skills add wshobson/agents --skill nx-workspace-patterns

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/nx-workspace-patterns
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/nx-workspace-patterns/
  • All projects ~/.claude/skills/nx-workspace-patterns/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

What this skill does

Overview

This skill helps you manage an Nx monorepo. A monorepo is one repository that holds many apps and shared libraries. Nx is a tool that organizes that code and makes builds and tests faster.

Key Features

  • Lay out a workspace with separate folders for apps, shared libraries and custom tools.
  • Sort libraries into five clear types, such as feature, ui, data-access, util and shell.
  • Use tags to set rules about which parts of the code may depend on others.
  • Run tests only on projects affected by a change, to save time in automated checks.
  • Turn on caching, which reuses past build results, early to cut build time.

Who is this for?

It suits developers and teams who are starting or moving to an Nx workspace. It also helps teams whose large codebase has slow builds or tangled links between projects.

Summarized by AI from this skill's SKILL.md. Suggest a better one

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

Nx Workspace Patterns

Production patterns for Nx monorepo management.

When to Use This Skill

  • Setting up new Nx workspaces
  • Configuring project boundaries
  • Optimizing CI with affected commands
  • Implementing remote caching
  • Managing dependencies between projects
  • Migrating to Nx

Core Concepts

1. Nx Architecture

workspace/
β”œβ”€β”€ apps/              # Deployable applications
β”‚   β”œβ”€β”€ web/
β”‚   └── api/
β”œβ”€β”€ libs/              # Shared libraries
β”‚   β”œβ”€β”€ shared/
β”‚   β”‚   β”œβ”€β”€ ui/
β”‚   β”‚   └── utils/
β”‚   └── feature/
β”‚       β”œβ”€β”€ auth/
β”‚       └── dashboard/
β”œβ”€β”€ tools/             # Custom executors/generators
β”œβ”€β”€ nx.json            # Nx configuration
└── workspace.json     # Project configuration

2. Library Types

TypePurposeExample
featureSmart components, business logicfeature-auth
uiPresentational componentsui-buttons
data-accessAPI calls, state managementdata-access-users
utilPure functions, helpersutil-formatting
shellApp bootstrappingshell-web

Templates and detailed worked examples

Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.

Best Practices

Do's

  • Use tags consistently - Enforce with module boundaries
  • Enable caching early - Significant CI savings
  • Keep libs focused - Single responsibility
  • Use generators - Ensure consistency
  • Document boundaries - Help new developers

Don'ts

  • Don't create circular deps - Graph should be acyclic
  • Don't skip affected - Test only what changed
  • Don't ignore boundaries - Tech debt accumulates
  • Don't over-granularize - Balance lib count

More from this repository10

🎯
tailwind-design-system🎯Skill

Helps you build a consistent look for your app with Tailwind CSS v4. It sets up shared colors, sizes, dark mode and reusable components so every screen matches.

🎯
typescript-advanced-types🎯Skill

A guide to TypeScript's advanced type features, which describe the shape of your data so mistakes are caught before the code runs. It covers reusable types, types that change based on rules, and built-in helper types, with short examples.

🎯
nodejs-backend-patterns🎯Skill

Guidance for building reliable server-side apps with Node.js, using Express or Fastify. It covers login, error handling, databases, API design and a list of proven best practices.

πŸͺ
wshobson-agentsπŸͺMarketplace

Intelligent automation and multi-agent orchestration for Claude Code

πŸ”Œ
framework-migrationπŸ”ŒPlugin

Claude Code plugin for AI-powered framework migration workflows, coordinating specialized agents to plan and execute transitions between technology stacks as part of the wshobson/agents marketplace.

πŸ”Œ
payment-processingπŸ”ŒPlugin

A Claude Code plugin for payment system integration covering Stripe, PayPal, and billing platforms with checkout flows, subscription management, and webhook handling in the wshobson/agents ecosystem.

πŸ”Œ
developer-essentialsπŸ”ŒPlugin

A Claude Code plugin bundling core development tools and agents for everyday tasks like debugging and code generation, part of the wshobson/agents marketplace with 73 focused plugins.

πŸ”Œ
observability-monitoringπŸ”ŒPlugin

Claude Code plugin for observability and monitoring including logging, metrics, distributed tracing, and alerting, part of the wshobson/agents marketplace with 73 focused plugins.

πŸ”Œ
deployment-strategiesπŸ”ŒPlugin

A Claude Code plugin providing specialized AI agents for deployment strategy planning and execution, covering blue-green deployments, canary releases, rolling updates, and zero-downtime patterns.

πŸ”Œ
jvm-languagesπŸ”ŒPlugin

Claude Code plugin for JVM language development including Java, Kotlin, and Scala with specialized agents for idiomatic patterns, build tools, and runtime optimization in the wshobson/agents marketplace.