Explicação detalhada
Este Skill é útil quando uma aplicação importa um pacote vizinho do repositório sem declarar corretamente a dependência. Primeiro identifica quem consome e quem fornece o pacote. Um alias reconhecido pelo editor não comprova que a instalação ou a execução resolva o pacote corretamente.
A fonte apresenta procedimentos para npm, pnpm, Yarn e Bun. packageManager, arquivo de lock e configuração do workspace orientam a escolha. No exemplo de pnpm, --filter seleciona o consumidor e --workspace exige um pacote local. As alterações no manifesto e no lock precisam ser revisadas depois.
A verificação depende do modo de instalação. Yarn PnP pode resolver dependências com .pnp.cjs sem node_modules; a ausência de um link simbólico não comprova falha. Se o import continuar quebrado, confira exports, artefatos necessários e as verificações de tipos ou build do projeto.
O que preparar
- Nomes e package.json do consumidor e do fornecedor, além do import com falha.
- Gerenciador, versão, lock e limites do workspace.
Resultados esperados
- Dependência declarada no consumidor correto e estado correspondente da instalação.
- Resultado que separa problemas de conexão, exports e artefatos.
Como usar
- Confirmar a relação de importação e a presença dos dois pacotes no workspace.
- Escolher a sintaxe do gerenciador e da versão em uso.
- Adicionar a dependência ao consumidor e revisar as diferenças.
- Verificar a resolução com o linker ativo e executar os controles existentes do projeto.
Limites e verificações
- Um pacote homônimo no registro não é necessariamente o fornecedor local.
- Com Yarn PnP, node_modules não é requisito de sucesso.
- Confira exports e resultados de build se a conexão não resolver tudo.
- nx-import move código e histórico; nx-plugins adiciona integrações do Nx.
Perguntas frequentes
Nx é obrigatório?
As instruções revisadas usam workspaces de gerenciadores e não exigem Nx nem servidor Nx MCP. Ainda são necessários um agente compatível e o contexto do repositório.
A cópia em nrwl/nx oferece outra capacidade?
Nas duas revisões fixadas, os diretórios do Skill são idênticos. Esta página trata da distribuição nx-ai-agents-config; escolha a fonte já usada sem esperar uma segunda capacidade.
O procedimento foi executado aqui?
Não. A explicação se baseia no Skill fixado e na documentação oficial, não em um teste no seu repositório.
Instalar este Skill
Adicione o Skill de sua fonte verificada no GitHub usando a Skills CLI.
npx skills add https://github.com/nrwl/nx-ai-agents-config --skill link-workspace-packagesInformações da fonte
- github.com/nrwl/nx-ai-agents-config/blob/13282936b5f6aa53e3d41ba589a4a2dc0d6f5786/skills/link-workspace-packages/SKILL.md
- github.com/nrwl/nx-ai-agents-config/blob/13282936b5f6aa53e3d41ba589a4a2dc0d6f5786/README.md
- github.com/nrwl/nx/tree/d976a693f12e81402bcbd53d4b04f91974650c04/.agents/skills/link-workspace-packages
- pnpm.io/cli/add
- yarnpkg.com/features/pnp
Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.
Link Workspace Packages
Add dependencies between packages in a monorepo. All package managers support workspaces but with different syntax.
Detect Package Manager
Check whether there's a packageManager field in the root-level package.json.
Alternatively check lockfile in repo root:
pnpm-lock.yaml→ pnpmyarn.lock→ yarnbun.lock/bun.lockb→ bunpackage-lock.json→ npm
Workflow
- Identify consumer package (the one importing)
- Identify provider package(s) (being imported)
- Add dependency using package manager's workspace syntax
- Verify symlinks created in consumer's
node_modules/
pnpm
Uses workspace: protocol - symlinks only created when explicitly declared.
# From consumer directory
pnpm add @org/ui --workspace
# Or with --filter from anywhere
pnpm add @org/ui --filter @org/app --workspaceResult in package.json:
{ "dependencies": { "@org/ui": "workspace:*" } }yarn (v2+/berry)
Also uses workspace: protocol.
yarn workspace @org/app add @org/uiResult in package.json:
{ "dependencies": { "@org/ui": "workspace:^" } }npm
No workspace: protocol. npm auto-symlinks workspace packages.
npm install @org/ui --workspace @org/appResult in package.json:
{ "dependencies": { "@org/ui": "*" } }npm resolves to local workspace automatically during install.
bun
Supports workspace: protocol (pnpm-compatible).
cd packages/app && bun add @org/uiResult in package.json:
{ "dependencies": { "@org/ui": "workspace:*" } }Examples
Example 1: pnpm - link ui lib to app
pnpm add @org/ui --filter @org/app --workspaceExample 2: npm - link multiple packages
npm install @org/data-access @org/ui --workspace @org/dashboardExample 3: Debug "Cannot find module"
- Check if dependency is declared in consumer's
package.json - If not, add it using appropriate command above
- Run install (
pnpm install,npm install, etc.)
Notes
- Symlinks appear in
<consumer>/node_modules/@org/<package> - Hoisting differs by manager:
- npm/bun: hoist shared deps to root
node_modules - pnpm: no hoisting (strict isolation, prevents phantom deps)
- yarn berry: uses Plug'n'Play by default (no
node_modules) - Root
package.jsonshould have"private": trueto prevent accidental publish



