К основному содержанию
скилл CX Codex

nx-workspace · tech-leads-club — скилл для Claude Code: что делает и как установить

Скилл nx-workspace для работы с Nx-монорепозиторием из CLI: список проектов, полная конфигурация, поиск затронутых проектов и affected-команды в CI.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tech-leads-club/agent-skills --skill nx-workspace -a claude-code
Открыть на GitHub

Что делает nx-workspace

Скилл направляет агента в CLI Nx. Список проектов собирается командой nx show projects с фильтрами --type, --projects и --withTarget, а настройки одного проекта агент берёт из nx show project <name> --json. Читать project.json напрямую скилл не советует: там только часть конфигурации, поэтому targets можно не увидеть.

Для проверки изменений есть nx show projects --affected --base=main и nx affected -t test --base=main, а граф зависимостей открывается через nx graph. К скиллу приложены справочные файлы: nx.json и границы модулей, remote caching, список команд, примеры CI для GitHub Actions, GitLab CI, Jenkins, Azure Pipelines и CircleCI, разбор частых ошибок. Библиотеки он раскладывает по типам feature, ui, data-access и util.

Запуск задач и генерация кода сюда не входят: для них есть отдельные скиллы nx-run-tasks и nx-generate. В CI нужна полная git-история (fetch-depth: 0), иначе affected работать не будет. Если кэш ведёт себя странно, поможет nx reset.

Какие задачи решает

  • узнать, какие приложения и библиотеки есть в монорепозитории
  • получить полную конфигурацию проекта и список его targets
  • найти проекты, затронутые изменениями относительно main
  • подключить affected-команды в GitHub Actions или GitLab CI
  • сбросить кэш Nx, когда сборка ведёт себя странно

Примеры запросов агенту

  • Покажи все приложения в этом Nx-воркспейсе и targets каждого из них
  • Какие проекты затронуты изменениями относительно main? Используй nx-workspace
  • Настрой в GitHub Actions запуск nx affected -t test и добавь fetch-depth: 0

Как установить nx-workspace

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill nx-workspace -a claude-code

2Вручную: положить файлы

~/.claude/skills/nx-workspace/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nx-workspace/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о nx-workspace

Как установить nx-workspace в Claude Code?

Выполните npx skills add tech-leads-club/agent-skills --skill nx-workspace -a claude-code. Файл скилла лежит по пути ~/.claude/skills/nx-workspace/SKILL.md.

Что делает nx-workspace?

Помогает агенту изучать Nx-монорепозиторий: выводить проекты и их полную конфигурацию, искать affected-проекты, разбираться с кэшем и настраивать CI.

Чем nx-workspace отличается от nx-run-tasks и nx-generate?

nx-workspace отвечает за структуру, конфигурацию и анализ изменений. Запуск задач остаётся за nx-run-tasks, а генераторы кода за nx-generate.

Исходный текст

SKILL.md · MIT
---
name: nx-workspace
description: Configure, explore, and optimize Nx monorepo workspaces. Use when setting up Nx, exploring workspace structure, configuring project boundaries, analyzing affected projects, optimizing build caching, or implementing CI/CD with affected commands. Keywords — nx, monorepo, workspace, projects, targets, affected. Do NOT use for running tasks (use nx-run-tasks) or code generation with generators (use nx-generate).
---

# Nx Workspace Management

## Quick Start

**Exploring workspace**: `nx show projects` and `nx show project <name> --json`  
**Running tasks**: `nx <target> <project>` (e.g., `nx build my-app`)  
**Affected analysis**: `nx show projects --affected` or `nx affected -t <target>`

> **Note**: Prefix commands with `npx`/`pnpx`/`yarn` if nx isn't installed globally.

## Core Commands

### List and Explore Projects

```bash
# List all projects
nx show projects

# Filter by type, pattern, or target
nx show projects --type app
nx show projects --projects "apps/*"
nx show projects --withTarget build

# Find affected projects
nx show projects --affected --base=main
```

### Get Project Information

**Critical**: Always use `nx show project <name> --json` for full resolved configuration. Do NOT read `project.json` directly - it contains only partial configuration.

```bash
# Get full configuration
nx show project my-app --json

# Extract targets
nx show project my-app --json | jq '.targets | keys'
```

Configuration schemas:

- Workspace: `node_modules/nx/schemas/nx-schema.json`
- Project: `node_modules/nx/schemas/project-schema.json`

### Run Tasks

```bash
# Run specific project
nx build web --configuration=production

# Run affected
nx affected -t test --base=main

# View dependency graph
nx graph
```

## Workspace Architecture

```
workspace/
├── apps/              # Deployable applications
├── libs/              # Shared libraries
│   ├── shared/        # Shared across scopes
│   └── feature/       # Feature-specific
├── nx.json            # Workspace configuration
└── tools/             # Custom executors/generators
```

### Library Types

| Type            | Purpose                          | Example             |
| --------------- | -------------------------------- | ------------------- |
| **feature**     | Business logic, smart components | `feature-auth`      |
| **ui**          | Presentational components        | `ui-buttons`        |
| **data-access** | API calls, state management      | `data-access-users` |
| **util**        | Pure functions, helpers          | `util-formatting`   |

## Detailed Resources

**Configuration**: See [reference/configuration.md](reference/configuration.md) for:

- nx.json templates and options
- project.json structure
- Module boundary rules
- Remote caching setup

**Commands**: See [reference/commands.md](reference/commands.md) for:

- Complete command reference
- Advanced filtering options
- Common workflows

**CI/CD**: See [reference/ci-cd.md](reference/ci-cd.md) for:

- GitHub Actions configuration
- GitLab CI setup
- Jenkins, Azure Pipelines, CircleCI examples
- Affected commands in pipelines

**Best Practices**: See [reference/best-practices.md](reference/best-practices.md) for:

- Do's and don'ts
- Complete troubleshooting guide
- Performance optimization
- Migration guides

## Common Workflows

**"What's in this workspace?"**

```bash
nx show projects --type app  # List applications
nx show projects --type lib  # List libraries
```

**"How do I run project X?"**

```bash
nx show project X --json | jq '.targets | keys'
```

**"What changed?"**

```bash
nx show projects --affected --base=main
```

## Quick Troubleshooting

- **Targets not showing**: Use `nx show project <name> --json`, not project.json
- **Affected not working**: Ensure git history available (`fetch-depth: 0` in CI)
- **Cache issues**: Run `nx reset`

For detailed troubleshooting, see [reference/best-practices.md](reference/best-practices.md).

© tech-leads-club · MIT · tech-leads-club/agent-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — nx-workspace от других авторов.

nx-workspace nrwl Скилл nx-workspace для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который даёт агенту команды для навигации по Nx-монорепозиторию. CX Codex +1 100 600установок pnpm-workspace oakoss Скилл pnpm-workspace настраивает монорепозитории на базе pnpm и каталоги версий. Помогает агенту связывать локальные пакеты через протокол workspace:. CX Codex +1 195установок nx-console nrwl MCP-сервер nx-console для монорепозиториев Nx в Claude Code, Cursor, Codex и других IDE. Передаёт агенту структуру проекта, список генераторов, конфигурацию задач и актуальную документацию Nx. CX Codex +1 ★ 1 416звёзд репо nx-monorepo giuseppe-trisciuoglio Скилл nx-monorepo для Claude Code, Codex, Cursor и других AI-агентов, который берёт на себя управление Nx монорепо в TypeScript/JavaScript проектах. CX Codex +1 4 000установок monorepo-ci-optimizer patricio0312rev Скилл monorepo-ci-optimizer для Claude Code находит в монорепозитории пакеты, затронутые изменениями, и оставляет в CI только их сборку и тесты. При каждом PR пайплайн запускает сборку и тесты только затронутых пакетов. CX Codex +1 264установок om-smart-test open-mercato Скилл om-smart-test анализирует, какие файлы изменились, определяет затронутые тесты и запускает только их. Экономит время на больших проектах, где полный прогон займёт часы. CX Codex +1 991установок monorepo-management Seth Hobson Скилл monorepo-management для Claude Code настраивает и поддерживает монорепозитории с Turborepo, Nx и pnpm workspaces. Настраивает сборку, общие зависимости и публикацию пакетов. CX Codex +1 14 548установок

Из того же набора130

Весь набор →
js-batch-dom-css Правило js-batch-dom-css запрещает чередовать чтение геометрии DOM с записью стилей. Защищает код от синхронного reflow и просадок FPS при анимациях. CX Codex +1 ★ 7 191звёзд репо docs-writer Скилл docs-writer для Claude Code пишет, редактирует и проверяет документацию в проекте. Работает с README, Markdown-файлами и страницами docs/. CX Codex +1 ★ 7 191звёзд репо perf-astro Скилл perf-astro для Claude Code настраивает сборку Astro: встраивает критический CSS, минифицирует файлы, задаёт неблокирующую загрузку шрифтов и preload LCP-картинки. CX Codex +1 ★ 7 191звёзд репо tactical-ddd Скилл tactical-ddd находит анемичные доменные модели и переводит их в богатые сущности по правилам тактического DDD. Он проверяет инкапсуляцию и готовит пошаговый рефакторинг для Claude Code. CX Codex +1 ★ 7 191звёзд репо perf-web-optimization Скилл perf-web-optimization помогает оптимизировать загрузку веб-страниц: настраивает отложенную загрузку, сокращает размер бандла и выставляет кэш. Пригодится при медленной работе сайта или тяжёлом JS. CX Codex +1 ★ 7 191звёзд репо state-context-interface Правило state-context-interface для Claude Code: отделяет интерфейс компонентов от источника состояния через контекст с частями state, actions и meta. Один UI подключается к разным провайдерам состояния. CX Codex +1 ★ 7 191звёзд репо learning-opportunities Скилл learning-opportunities предлагает короткие учебные упражнения после архитектурной работы в Claude, чтобы код, который написал агент, не остался для вас чёрным ящиком. CX Codex +1 ★ 7 191звёзд репо confluence-assistant Скилл confluence-assistant учит агента работать с Confluence через Atlassian MCP. Помогает искать страницы поиском Rovo, создавать новые записи в разметке Markdown и обновлять документацию прямо из чата. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой