AGENT SKILL

nx-developer

General Nx workspace guidance. USE WHEN working in an Nx workspace, answering Nx architecture/configuration questions, choosing Nx commands, or deciding which Nx-specific skill/helper to use. Routes to nx-workspace, nx-generate, nx-run-tasks, nx-plugins, nx-import, and nx-docs as appropriate.

License 许可
MIT
最近更新
2026-10-26
Stars
★ 0
Forks
2

01 前言 Front Matter

name
nx-developer
description
General Nx workspace guidance. USE WHEN working in an Nx workspace, answering Nx architecture/configuration questions, choosing Nx commands, or deciding which Nx-specific skill/helper to use. Routes to nx-workspace, nx-generate, nx-run-tasks, nx-plugins, nx-import, and nx-docs as appropriate.

03 SKILL.md 正文

Nx Developer

Use this skill as the general router for Nx work. Load the more focused Nx skills when they match the task.

General Nx command rules

  • Prefer Nx commands (nx run, nx run-many, nx affected, nx show, nx graph) over calling underlying tools directly.
  • Prefix Nx commands with the workspace package manager, for example pnpm nx ..., npm exec nx ..., yarn nx ..., or bunx nx .... Check the lockfile before choosing.
  • Use --no-interactive for generators and commands that could prompt.
  • Do not guess unfamiliar CLI flags. Use <package-manager> nx <command> --help first, then the nx-docs skill for deeper/current documentation.

Workspace exploration routing

Use the nx-workspace skill when answering questions about projects, targets, dependencies, or workspace architecture.

Useful CLI commands:

pnpm nx show projects --json
pnpm nx show project <project-name> --json
pnpm nx graph --print

For project-specific structure and inferred targets, prefer pnpm nx show project <project-name> --json over reading project.json directly.

Generator/scaffolding routing

Use the nx-generate skill before scaffolding projects, libraries, plugins, package structure, or other generated artifacts.

Key rules:

  • Prefer local workspace generators over external plugin generators when both apply.
  • Check generator help with pnpm nx g <generator> --help.
  • Read the generator source when behavior or file placement matters.
  • Run a dry run first when supported.

Task running routing

Use the nx-run-tasks skill when running build, test, lint, typecheck, serve, e2e, or other Nx targets.

Prefer:

pnpm nx run <project>:<target>
pnpm nx run-many -t <target>
pnpm nx affected -t <target>

Plugin and import routing

  • Use nx-plugins when discovering or adding Nx plugins.
  • Use nx-import when migrating/importing existing projects into an Nx workspace.
  • Use link-workspace-packages when sibling workspace packages need dependency links or imports fail for workspace packages.

Documentation lookup routing

Use the nx-docs skill when CLI help is not enough, especially for advanced configuration, migrations, plugin setup, release configuration, caching, affected behavior, or project graph behavior.

The local helper can be run from the nx-docs skill directory:

node scripts/search-documentation.mjs "targetDefaults nx.json" --limit 4

Or from any directory with an absolute path to that script.

Plugin best practices

When plugin-specific best practices are needed, check node_modules/@nx/<plugin>/PLUGIN.md if it exists. Not every plugin ships this file.

Not included yet

Nx Cloud CI monitoring/self-healing automation is intentionally not included in this package yet. Use standard Nx/Nx Cloud CLI workflows or repository-specific guidance until script-based support is added.

04 同仓库更多 Skills

araketski
araketski/pi-packages

taiga-ui-docs

Use when implementing, debugging, reviewing, migrating, or looking up Angular Taiga UI components. Provides a bundled helper script equivalent to Taiga UI MCP docs tools for overview/import guidance, section lists, exact component documentation/examples, and migration guide content from llms-full.txt.

★ 0
araketski
araketski/pi-packages

nx-workspace

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'.

★ 0
araketski
araketski/pi-packages

nx-run-tasks

Helps with running tasks in an Nx workspace. USE WHEN the user wants to execute build, test, lint, serve, or run any other tasks defined in the workspace.

★ 0
araketski
araketski/pi-packages

nx-plugins

Find and add Nx plugins. USE WHEN user wants to discover available plugins, install a new plugin, or add support for a specific framework or technology to the workspace.

★ 0
araketski
araketski/pi-packages

nx-import

Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository.

★ 0
araketski
araketski/pi-packages

nx-generate

Generate code using nx generators. INVOKE IMMEDIATELY when user mentions scaffolding, setup, structure, creating apps/libs, or setting up project structure. Trigger words - scaffold, setup, create a new app, create a new lib, project structure, generate, add a new project. ALWAYS use this BEFORE using the nx-docs skill or local Nx documentation helper or exploring - this skill handles discovery internally.

★ 0