run-nx-generator

nrwl's avatarfrom nrwl

Run Nx generators with prioritization for workspace-plugin generators. Use this when generating code, scaffolding new features, or automating repetitive tasks in the monorepo.

⭐27.6kstars🔀2.6kforks📁View on GitHub🕐Updated Nov 25, 2025
[Code Generation]

When & Why to Use This Skill

This Claude skill enables developers to efficiently execute Nx generators within a monorepo environment, with a strategic focus on prioritizing internal workspace-plugin generators. It streamlines the development lifecycle by automating code scaffolding, feature generation, and repetitive configuration tasks, ensuring architectural consistency and reducing manual boilerplate effort.

Use Cases

  • 1. Automated Scaffolding: Rapidly generate new React components, Node.js libraries, or API endpoints using standardized templates to maintain project structure.
  • 2. Monorepo Maintenance: Automate repetitive updates such as bumping Maven versions or updating internal plugin configurations across multiple packages simultaneously.
  • 3. Custom Tooling Integration: Leverage internal workspace-plugin generators to enforce team-specific coding standards and specialized architectural patterns.
  • 4. Safe Code Migrations: Execute complex refactoring or version updates with built-in support for dry-runs and automated formatting to ensure code quality before committing.
namerun-nx-generator
descriptionRun Nx generators with prioritization for workspace-plugin generators. Use this when generating code, scaffolding new features, or automating repetitive tasks in the monorepo.
allowed-toolsBash, Read, Glob, Grep, mcp__nx-mcp__nx_generators, mcp__nx-mcp__nx_generator_schema

Run Nx Generator

This skill helps you execute Nx generators efficiently, with special focus on workspace-plugin generators from your internal tooling.

Generator Priority List

Use the mcp__nx-mcp__nx_generator_schema tool to get more information about how to use the generator

Choose which generators to run in this priority order:

🔥 Workspace-Plugin Generators (High Priority)

These are your custom internal tools in tools/workspace-plugin/

📦 Core Nx Generators (Standard)

Only use these if workspace-plugin generators don't fit:

  • nx generate @nx/devkit:... - DevKit utilities
  • nx generate @nx/node:... - Node.js libraries
  • nx generate @nx/react:... - React components and apps
  • Framework-specific generators

How to Run Generators

  1. List available generators:

  2. Get generator schema (to see available options): Use the mcp__nx-mcp__nx_generator_schema tool to get more information about how to use the generator

  3. Run the generator:

    nx generate [generator-path] [options]

  4. Verify the changes:

    • Review generated files
    • Run tests: nx affected -t test
    • Format code: npx prettier --write [files]

Best Practices

  • ✅ Always check workspace-plugin first - it has your custom solutions
  • ✅ Use --dry-run flag to preview changes before applying
  • ✅ Format generated code immediately with Prettier
  • ✅ Test affected projects after generation
  • ✅ Commit generator changes separately from manual edits

Examples

Bumping Maven Version

When updating the Maven plugin version, use the workspace-plugin generator:

nx generate @nx/workspace-plugin:bump-maven-version \
  --newVersion 0.0.10 \
  --nxVersion 22.1.0-beta.7

This automates all the version bumping instead of manual file edits.

Creating a New Plugin

For creating a new create-nodes plugin:

nx generate @nx/workspace-plugin:create-nodes-plugin \
  --name my-custom-plugin

When to Use This Skill

Use this skill when you need to:

  • Generate new code or projects
  • Scaffold new features or libraries
  • Automate repetitive setup tasks
  • Update internal tools and configurations
  • Create migrations or version updates