AGENT SKILL

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 calling nx_docs or exploring - this skill handles discovery internally.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 3
Forks
0

01 前言 Front Matter

name
nx-generate
description
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 calling nx_docs or exploring - this skill handles discovery internally.

03 SKILL.md 正文

Run Nx Generator

Nx generators are powerful tools that scaffold projects, make automated code migrations or automate repetitive tasks in a monorepo. They ensure consistency across the codebase and reduce boilerplate work.

This skill applies when the user wants to:

  • Create new projects like libraries or applications
  • Scaffold features or boilerplate code
  • Run workspace-specific or custom generators
  • Do anything else that an nx generator exists for

Key Principles

  1. Always use --no-interactive - Prevents prompts that would hang execution
  2. Read the generator source code - The schema alone is not enough; understand what the generator actually does
  3. Match existing repo patterns - Study similar artifacts in the repo and follow their conventions
  4. Verify with lint/test/build/typecheck etc. - Generated code must pass verification. The listed targets are just an example, use what's appropriate for this workspace.

Steps

1. Discover Available Generators

Use the Nx CLI to discover available generators:

  • List all generators for a plugin: npx nx list @nx/react
  • View available plugins: npx nx list

This includes plugin generators (e.g., @nx/react:library) and local workspace generators.

2. Match Generator to User Request

Identify which generator(s) could fulfill the user's needs. Consider what artifact type they want, which framework is relevant, and any specific generator names mentioned.

IMPORTANT: When both a local workspace generator and an external plugin generator could satisfy the request, always prefer the local workspace generator. Local generators are customized for the specific repo's patterns.

If no suitable generator exists, you can stop using this skill. However, the burden of proof is high—carefully consider all available generators before deciding none apply.

3. Get Generator Options

Use the --help flag to understand available options:

npx nx g @nx/react:library --help

Pay attention to required options, defaults that might need overriding, and options relevant to the user's request.

Library Buildability

Default to non-buildable libraries unless there's a specific reason for buildable.

Type When to use Generator flags
Non-buildable (default) Internal monorepo libs consumed by apps No --bundler flag
Buildable Publishing to npm, cross-repo sharing, stable libs for cache hits --bundler=vite or --bundler=swc

Non-buildable libs:

  • Export .ts/.tsx source directly
  • Consumer's bundler compiles them
  • Faster dev experience, less config

Buildable libs:

  • Have their own build target
  • Useful for stable libs that rarely change (cache hits)
  • Required for npm publishing

If unclear, ask the user: "Should this library be buildable (own build step, better caching) or non-buildable (source consumed directly, simpler setup)?"

4. Read Generator Source Code

This step is critical. The schema alone does not tell you everything. Reading the source code helps you:

  • Know exactly what files will be created/modified and where
  • Understand side effects (updating configs, installing deps, etc.)
  • Identify behaviors and options not obvious from the schema
  • Understand how options interact with each other

To find generator source code:

  • For plugin generators: Use node -e "console.log(require.resolve('@nx/<plugin>/generators.json'));" to find the generators.json, then locate the source from there
  • If that fails, read directly from node_modules/<plugin>/generators.json
  • For local generators: Typically in tools/generators/ or a local plugin directory. Search the repo for the generator name.

After reading the source, reconsider: Is this the right generator? If not, go back to step 2.

⚠️ --directory flag behavior can be misleading. It should specify the full path of the generated library or component, not the parent path that it will be generated in.

# ✅ Correct - directory is the full path for the library
nx g @nx/react:library --directory=libs/my-lib
# generates libs/my-lib/package.json and more

# ❌ Wrong - this will create files at libs and libs/src/...
nx g @nx/react:library --name=my-lib --directory=libs
# generates libs/package.json and more

5. Examine Existing Patterns

Before generating, examine the target area of the codebase:

  • Look at similar existing artifacts (other libraries, applications, etc.)
  • Identify naming conventions, file structures, and configuration patterns
  • Note which test runners, build tools, and linters are used
  • Configure the generator to match these patterns

6. Dry-Run to Verify File Placement

Always run with --dry-run first to verify files will be created in the correct location:

npx nx g @nx/react:library --name=my-lib --dry-run --no-interactive

Review the output carefully. If files would be created in the wrong location, adjust your options based on what you learned from the generator source code.

Note: Some generators don't support dry-run (e.g., if they install npm packages). If dry-run fails for this reason, proceed to running the generator for real.

7. Run the Generator

Execute the generator:

nx generate <generator-name> <options> --no-interactive

Tip: New packages often need workspace dependencies wired up (e.g., importing shared types, being consumed by apps). The link-workspace-packages skill can help add these correctly.

8. Modify Generated Code (If Needed)

Generators provide a starting point. Modify the output as needed to:

  • Add or modify functionality as requested
  • Adjust imports, exports, or configurations
  • Integrate with existing code patterns

Important: If you replace or delete generated test files (e.g., *.spec.ts), either write meaningful replacement tests or remove the test target from the project configuration. Empty test suites will cause nx test to fail.

9. Format and Verify

Format all generated/modified files:

nx format --fix

This example is for built-in nx formatting with prettier. There might be other formatting tools for this workspace, use these when appropriate.

Then verify the generated code works. Keep in mind that the changes you make with a generator or subsequent modifications might impact various projects so it's usually not enough to only run targets for the artifact you just created.

# these targets are just an example!
nx run-many -t build,lint,test,typecheck

These targets are common examples used across many workspaces. You should do research into other targets available for this workspace and its projects. CI configuration is usually a good guide for what the critical targets are that have to pass.

If verification fails with manageable issues (a few lint errors, minor type issues), fix them. If issues are extensive, attempt obvious fixes first, then escalate to the user with details about what was generated, what's failing, and what you've attempted.

04 同仓库更多 Skills

whimzyLive
whimzyLive/nightshift-ai

designing-in-patterns

Use when designing, planning or auditing UI against a component library — naming surfaces with the repo's pattern vocabulary, deciding reuse versus extend versus new, exploring compositions, or writing the reuse table (component-plan.md, a spec's `## Reuse`, a UI audit). Carries the design method; the repo's own vocabulary, bundle and board rules come from project-context and the designer override.

★ 3
whimzyLive
whimzyLive/nightshift-ai

typeorm

Use when defining TypeORM entities, writing migrations, or building repository/query-builder code in TypeScript. Covers entity and relation decorators, the Data Mapper pattern, migrations, the query builder, transactions, and multi-database configuration.

★ 3
whimzyLive
whimzyLive/nightshift-ai

hono-api

Use when building or extending REST APIs with Hono + @hono/zod-openapi. Covers schema-first route declaration with createRoute, feature-grouped composable routers, a class-based service layer behind interfaces, the strategy pattern for multi-event webhooks, typed request validation, and auto-generated OpenAPI docs.

★ 3
whimzyLive
whimzyLive/nightshift-ai

electrodb

Use when defining DynamoDB entities, modeling indexes, or writing queries/mutations with the ElectroDB ORM. Covers entity schema, access patterns, CRUD operations, update expressions, and single-table design patterns.

★ 3
whimzyLive
whimzyLive/nightshift-ai

atomic-design

Use when structuring or decomposing any frontend UI into reusable components, regardless of framework. Applies Brad Frost's atomic design methodology — atoms, molecules, organisms, templates, and pages — to guide consistent component hierarchy, naming, and composition decisions.

★ 3
whimzyLive
whimzyLive/nightshift-ai

writing-docs

Use when writing, restructuring, or reviewing any prose documentation — a tutorial, how-to guide, reference page, or explanation/conceptual doc — for a public docs site (e.g. Mintlify MDX, docs/, README material), a getting-started guide, an API/CLI reference page, or a "why we built it this way" conceptual page. Applies the Diátaxis framework (see https://diataxis.fr/) — every document belongs to exactly one of the four quadrants (tutorial / how-to guide / reference / explanation), and mixing quadrants inside one document is the single most common documentation failure. Covers the four-quadrant compass for picking the right form, per-quadrant structure templates, an anti-pattern list for quadrant drift, and generic voice/craft rules — repo-specific voice and target output format (e.g. Mintlify MDX) are resolved from the repo's docs-manifest (falling back to project-context), never hardcoded here.

★ 3