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

pnpm-workspace — скилл для Claude Code: что делает и как установить

Скилл pnpm-workspace настраивает монорепозитории на базе pnpm и каталоги версий. Помогает агенту связывать локальные пакеты через протокол workspace:.

MIT 195 установок ★ 29 обновлён 2026-08-17

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

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

Скилл обучает ИИ-агента правильно организовывать структуру монорепозитория через pnpm-workspace.yaml. Он подсказывает синтаксис протокола workspace: для локальной линковки модулей и переносит общие версии библиотек в секции catalog:.

Внутри собраны правила фильтрации команд по именам пакетов или изменениям в git. Агент узнаёт, как запускать скрипты только для затронутых пакетов через --filter, а не тратить время на рекурсивный прогон во всём дереве.

Для проектов на pnpm 10 критично учитывать заблокированные по умолчанию скрипты сборки зависимостей. Скилл напоминает добавлять нужные модули в allowBuilds и включать inject-workspace-packages=true перед деплоем.

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

  • связать внутренние пакеты монорепозитория через протокол workspace:
  • объединить версии общих библиотек в единый каталог catalog:
  • запустить сборку только для изменённых модулей через фильтры git
  • настроить параметры развёртывания и разрешить скрипты для pnpm 10

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

  • Собери только те пакеты, которые изменились по сравнению с веткой origin/main.
  • Вынеси общие версии библиотек в секцию catalog: внутри файла pnpm-workspace.yaml.
  • Запусти тесты для модуля @scope/web вместе со всеми его зависимостями.

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

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill pnpm-workspace -a claude-code

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

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

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

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

Вопросы о pnpm-workspace

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

Выполните в терминале команду npx skills add oakoss/agent-skills --skill pnpm-workspace -a claude-code.

В каких проектах этот скилл не нужен?

Инструкции не подходят для репозиториев с одним пакетом или проектов на воркспейсах npm и yarn без миграции. Также скилл не пригодится, если каждому модулю требуются плавающие нефиксированные версии библиотек.

Что меняется при работе с pnpm 10?

В десятой версии pnpm жизненные циклы скриптов отключены по умолчанию. Для их работы требуется явное разрешение в allowBuilds, а для сборки и развёртывания необходим флаг inject-workspace-packages=true в файле .npmrc.

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

SKILL.md · MIT
---
name: pnpm-workspace
description: 'pnpm workspace monorepo management with filtering, catalogs, and shared configs. Use when setting up monorepos, managing workspace dependencies, filtering package commands, or sharing configuration across packages.'
license: MIT
metadata:
  author: oakoss
  version: '1.2'
  source: https://pnpm.io/workspaces
user-invocable: false
---

# pnpm Workspace

## Overview

pnpm workspaces provide built-in monorepo support through `pnpm-workspace.yaml`, the `workspace:` protocol for local package linking, and powerful filtering to run commands across specific packages. Catalogs enforce consistent dependency versions across all workspace packages.

**When to use:** Multi-package repositories, shared libraries with consuming apps, consistent dependency management across packages, running commands on subsets of packages.

**When NOT to use:** Single-package projects, projects already using npm/yarn workspaces (migration required), projects that need floating dependency versions per package.

## Quick Reference

| Pattern                  | API / Config                                   | Key Points                                              |
| ------------------------ | ---------------------------------------------- | ------------------------------------------------------- |
| Define workspace         | `pnpm-workspace.yaml` with `packages` globs    | Globs match directories containing `package.json`       |
| Link local package       | `"dep": "workspace:*"`                         | Always resolves to local workspace package              |
| Link with version range  | `"dep": "workspace:^1.0.0"`                    | Fails install if local version does not satisfy range   |
| Default catalog          | `catalog:` key in `pnpm-workspace.yaml`        | Single source of truth for dependency versions          |
| Named catalog            | `catalogs:` key with named groups              | Multiple version sets (e.g., `react18`, `react17`)      |
| Use catalog in package   | `"dep": "catalog:"` or `"dep": "catalog:name"` | Resolved to actual version on `pnpm publish`            |
| Filter by name           | `--filter <name>` or `-F <name>`               | Exact name or glob pattern (`@scope/*`)                 |
| Filter with dependencies | `--filter "foo..."`                            | Package and all its dependencies                        |
| Filter with dependents   | `--filter "...foo"`                            | Package and all packages that depend on it              |
| Filter by directory      | `--filter "./packages/app"`                    | All packages under a directory path                     |
| Filter by git changes    | `--filter "[origin/main]"`                     | Packages changed since a commit or branch               |
| Exclude from filter      | `--filter "!foo"`                              | Remove matching packages from selection                 |
| Run script in package    | `pnpm --filter <pkg> <script>`                 | Runs script only in matched packages                    |
| Recursive run            | `pnpm -r run <script>`                         | Runs script in all workspace packages                   |
| Install all              | `pnpm install`                                 | Single lockfile for entire workspace                    |
| Publish workspace pkg    | `pnpm publish`                                 | Replaces `workspace:` and `catalog:` with real versions |
| Inject workspace deps    | `inject-workspace-packages=true` in `.npmrc`   | Hard-links instead of symlinks; required for deploy     |
| Script security (v10+)   | `allowBuilds` in `package.json`                | Lifecycle scripts blocked by default; opt-in per dep    |

## Common Mistakes

| Mistake                                                 | Correct Pattern                                                         |
| ------------------------------------------------------- | ----------------------------------------------------------------------- |
| Using `workspace:*` then publishing as-is               | pnpm automatically replaces `workspace:*` with real versions on publish |
| Forgetting to list directory in `packages:`             | Every package directory must match a glob in `pnpm-workspace.yaml`      |
| Using `npm install` in workspace packages               | Always use `pnpm install` from the workspace root                       |
| Hardcoding versions duplicated across packages          | Use `catalog:` to centralize version definitions                        |
| Running `pnpm install` inside a sub-package             | Run from workspace root; use `--filter` to target packages              |
| Expecting `--filter` to match directory names           | `--filter` matches `package.json` `name` field, not directory names     |
| Not escaping `!` in zsh for exclude filters             | Use `\!` or quote the filter: `--filter="!foo"`                         |
| Using `workspace:` for non-workspace deps               | `workspace:` protocol only works for packages defined in the workspace  |
| Lifecycle scripts failing after pnpm 10 upgrade         | pnpm 10 blocks scripts by default; add deps to `allowBuilds` in config  |
| Using `pnpm deploy` without `inject-workspace-packages` | Set `inject-workspace-packages=true` in `.npmrc` (required in pnpm 10)  |

## Delegation

- **Workspace scaffolding**: Use `Explore` agent to discover existing package structure
- **Dependency auditing**: Use `Task` agent to check version consistency across packages

> If the `turborepo` skill is available, delegate build orchestration, task caching, and CI optimization to it.
> If the `changesets` skill is available, delegate versioning, changelog generation, and npm publishing to it.

## References

- [Workspace setup, workspace protocol, and catalogs](references/workspace-setup.md)
- [Filtering packages for targeted commands](references/filtering.md)
- [Shared configuration across workspace packages](references/shared-configs.md)
- [Monorepo integration: pnpm + Turborepo + Changesets pipeline](references/monorepo-integration.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «DevOps и инфраструктура» →
pnpm Anthony Fu Даёт агенту правила работы с менеджером пакетов pnpm версий 11 и 12. Помогает настраивать монорепозитории и чинить зависимости без фантомных пакетов. CX Codex +1 23 200установок monorepo-management Seth Hobson Скилл monorepo-management для Claude Code настраивает и поддерживает монорепозитории с Turborepo, Nx и pnpm workspaces. Настраивает сборку, общие зависимости и публикацию пакетов. CX Codex +1 14 548установок monorepo-navigator Alireza Rezvani Скилл monorepo-navigator для Claude Code, который добавляет агенту понимание структуры монорепозитория: Turborepo, Nx, pnpm workspaces и Lerna. CX Codex +1 591установок monorepo-setup patricio0312rev Скилл monorepo-setup разворачивает каркас монорепозитория на Turborepo и pnpm: приложения, общие пакеты, конфиги TypeScript и ESLint, пайплайн сборки. CX Codex +1 283установок nx-workspace nrwl Скилл nx-workspace для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который даёт агенту команды для навигации по Nx-монорепозиторию. CX Codex +1 100 600установок link-workspace-packages nrwl Скилл link-workspace-packages для Claude Code настраивает зависимости между пакетами монорепозитория через менеджер пакетов и разрешает импорты из соседних пакетов. CX Codex +1 3 200установок

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

Весь набор →
react-patterns Скилл react-patterns по React 19+: паттерны хуков, выбор управления состоянием, загрузка данных через use() и борьба с лишними ре-рендерами. CX Codex +1 201установок ci-cd-architecture Скилл ci-cd-architecture помогает спроектировать CI/CD-пайплайн, выбрать платформу деплоя и настроить безопасность GitHub Actions. Пригодится при запуске и развитии проекта. CX Codex +1 199установок openapi Настраивает агента на проектирование спецификаций OpenAPI 3.1 и генерацию TypeScript-клиентов. Помогает писать схемы контрактов и документацию для REST API. CX Codex +1 197установок css-animation-patterns Скилл css-animation-patterns для Claude Code помогает создавать CSS-анимации без перерисовки макета. Описывает аппаратно ускоренные свойства, переходы и новые API движения. CX Codex +1 196установок icon-design Скилл icon-design помогает выбрать подходящие по смыслу иконки из Lucide, Heroicons или Phosphor и настроить чистый импорт без поломки tree-shaking. CX Codex +1 187установок pdf-tools Скилл pdf-tools для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который покрывает весь цикл работы с PDF: извлечение текста и таблиц, генерацию, изменение и заполнение форм. CX Codex +1 186установок ssh-remote Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок tanstack-hotkeys Скилл для агента: подсказывает, как собрать горячие клавиши в React на TanStack Hotkeys — от одиночных комбинаций до записи пользовательских шорткатов. CX Codex +1 179установок

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

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