nrwl/nx-ai-agents-config

link-workspace-packages

Identifica el paquete consumidor y el proveedor para declarar la dependencia del workspace.

Ver código fuente

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

  1. Confirmar la relación de importación y que ambos paquetes pertenecen al workspace.
  2. Elegir la sintaxis del gestor y la versión utilizados.
  3. Añadir la dependencia al consumidor y revisar las diferencias.
  4. 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-packages

Información de la fuente

Documento original del Skill

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 → pnpm
  • yarn.lock → yarn
  • bun.lock / bun.lockb → bun
  • package-lock.json → npm

Workflow

  1. Identify consumer package (the one importing)
  2. Identify provider package(s) (being imported)
  3. Add dependency using package manager's workspace syntax
  4. Verify symlinks created in consumer's node_modules/

pnpm

Uses workspace: protocol - symlinks only created when explicitly declared.

bash
# From consumer directory
pnpm add @org/ui --workspace

# Or with --filter from anywhere
pnpm add @org/ui --filter @org/app --workspace

Result in package.json:

json
{ "dependencies": { "@org/ui": "workspace:*" } }

yarn (v2+/berry)

Also uses workspace: protocol.

bash
yarn workspace @org/app add @org/ui

Result in package.json:

json
{ "dependencies": { "@org/ui": "workspace:^" } }

npm

No workspace: protocol. npm auto-symlinks workspace packages.

bash
npm install @org/ui --workspace @org/app

Result in package.json:

json
{ "dependencies": { "@org/ui": "*" } }

npm resolves to local workspace automatically during install.


bun

Supports workspace: protocol (pnpm-compatible).

bash
cd packages/app && bun add @org/ui

Result in package.json:

json
{ "dependencies": { "@org/ui": "workspace:*" } }

Examples

Example 1: pnpm - link ui lib to app

bash
pnpm add @org/ui --filter @org/app --workspace

Example 2: npm - link multiple packages

bash
npm install @org/data-access @org/ui --workspace @org/dashboard

Example 3: Debug "Cannot find module"

  1. Check if dependency is declared in consumer's package.json
  2. If not, add it using appropriate command above
  3. 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.json should have "private": true to prevent accidental publish

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
nrwl
Comunidad

nx-workspace

Explore and understand Nx workspaces. USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails or you need to check available targets/configuration before running a task. EXAMPLES: 'What projects are in this workspace?', 'How is project X configured?', 'What depends on library Y?', 'What targets can I run?', 'Cannot find configuration for task', 'debug nx task failure'.

Instalaciones totales
100,6 mil
GitHub Stars
29
Actualizado
20 nov
nrwl
Comunidad

nx-import

Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository.

Instalaciones / 1h
1
GitHub Stars
29
Actualizado
20 nov
nrwl
Comunidad

nx-plugins

Find and add Nx plugins. USE WHEN user wants to discover available plugins, install a new plugin, or add support for a specific framework or technology to the workspace.

Instalaciones / 1h
1
GitHub Stars
29
Actualizado
20 nov
nrwl
Comunidad

nx-generate

Generate code using nx generators. INVOKE IMMEDIATELY when user mentions scaffolding, setup, structure, creating apps/libs, or setting up project structure. Trigger words - scaffold, setup, create a new app, create a new lib, project structure, generate, add a new project. ALWAYS use this BEFORE calling nxdocs or exploring - this skill handles discovery internally.

Instalaciones / 1h
7
GitHub Stars
28
Actualizado
7 oct