nx-workspace · tech-leads-club — скилл для Claude Code: что делает и как установить
Скилл nx-workspace для работы с Nx-монорепозиторием из CLI: список проектов, полная конфигурация, поиск затронутых проектов и affected-команды в CI.
MIT ★ 7 191 обновлён 2026-10-24
npx skills add tech-leads-club/agent-skills --skill nx-workspace -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/nx-workspace/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nx-workspace/
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill nx-workspace -a codex2Вручную: положить файлы
.agents/skills/nx-workspace/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill nx-workspace -a cursor2Вручную: положить файлы
.cursor/skills/nx-workspace/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(tooling)/nx-workspace'2Вручную: положить файлы
.github/skills/nx-workspace/SKILL.md1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill nx-workspace -a gemini-cli2Командой платформы
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(tooling)/nx-workspace'Вручную: положить файлы
.devin/skills/nx-workspace/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.