Descripción detallada
Este Skill encaja cuando una aplicación importa otro paquete del repositorio, pero no declara correctamente esa dependencia. Primero identifica quién consume y quién proporciona el paquete. Que un alias funcione en el editor no demuestra que la instalación o la ejecución lo resuelvan bien.
La fuente incluye métodos para npm, pnpm, Yarn y Bun. El campo packageManager, el archivo de bloqueo y la configuración del workspace determinan cuál corresponde. Su ejemplo de pnpm selecciona el consumidor con --filter y exige un paquete local con --workspace. Después deben revisarse los cambios del manifiesto y del bloqueo.
La comprobación depende del modo de instalación. Yarn PnP puede usar .pnp.cjs sin node_modules, por lo que la falta de un enlace simbólico no demuestra un fallo. Si persiste el error, hay que comprobar exports, los artefactos necesarios y el build o la revisión de tipos del proyecto.
Qué preparar
- Nombres y package.json del consumidor y del proveedor, junto con el import fallido.
- Gestor, versión, archivo de bloqueo y alcance del workspace.
Resultados esperados
- Dependencia declarada en el consumidor correcto y estado de instalación correspondiente.
- Verificación que distingue conexión, exports y artefactos.
Cómo utilizarlo
- Confirmar la relación de importación y que ambos paquetes pertenecen al workspace.
- Elegir la sintaxis del gestor y la versión utilizados.
- Añadir la dependencia al consumidor y revisar las diferencias.
- Verificar la resolución con el linker activo y las comprobaciones del proyecto.
Límites y comprobaciones
- Un paquete homónimo del registro puede no ser el proveedor local.
- Con Yarn PnP no se exige node_modules para dar por correcta la instalación.
- Revisar exports y resultados de compilación si la conexión no basta.
- nx-import mueve código e historial; nx-plugins añade integraciones de Nx.
Preguntas frecuentes
¿Es necesario Nx?
Las instrucciones revisadas usan workspaces de gestores de paquetes y no exigen Nx ni un servidor Nx MCP. Siguen haciendo falta un agente compatible y el contexto del repositorio.
¿La copia en nrwl/nx ofrece otra capacidad?
En las dos revisiones fijadas, los directorios del Skill son idénticos. Esta página describe nx-ai-agents-config; conviene elegir la distribución ya utilizada sin esperar una segunda capacidad.
¿Se ha ejecutado aquí el procedimiento?
No. La explicación procede del Skill fijado y de documentación oficial; no es una prueba en tu repositorio.
Instalar este Skill
Añade este Skill desde su fuente verificada en GitHub con la Skills CLI.
npx skills add https://github.com/nrwl/nx-ai-agents-config --skill link-workspace-packagesInformación de la fuente
- 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
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
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



