Présentation détaillée
Ce Skill convient lorsqu’une application importe un paquet voisin du dépôt sans le déclarer correctement dans ses dépendances. Il commence par identifier le consommateur et le fournisseur. Un alias compris par l’éditeur ne prouve pas que l’installation ou l’exécution résoudra correctement le paquet.
La source propose des démarches pour npm, pnpm, Yarn et Bun. Le champ packageManager, le fichier de verrouillage et la configuration du workspace permettent de choisir. Dans l’exemple pnpm, --filter désigne le consommateur et --workspace impose un paquet local. Il faut ensuite examiner les modifications du manifeste et du verrouillage.
La vérification dépend du mode d’installation. Yarn PnP peut résoudre les dépendances avec .pnp.cjs sans node_modules : l’absence de lien symbolique n’indique donc pas nécessairement un échec. Si l’import échoue encore, vérifier exports, les artefacts attendus et les contrôles de types ou de compilation du projet.
Éléments à préparer
- Noms et package.json du consommateur et du fournisseur, import en échec.
- Gestionnaire, version, verrouillage et périmètre du workspace.
Résultats attendus
- Dépendance déclarée dans le bon consommateur et état d’installation correspondant.
- Résultat distinguant un problème de liaison d’un problème d’exports ou d’artefacts.
Marche à suivre
- Confirmer la relation d’import et la présence des deux paquets dans le workspace.
- Choisir la syntaxe du gestionnaire et de sa version réels.
- Ajouter la dépendance au consommateur et examiner les différences.
- Vérifier la résolution avec le linker actif puis les contrôles du projet.
Limites et vérifications
- Un paquet homonyme du registre n’est pas forcément le fournisseur local.
- Avec Yarn PnP, node_modules n’est pas un critère obligatoire.
- Vérifier exports et les artefacts si la liaison ne suffit pas.
- nx-import déplace le code et son historique ; nx-plugins ajoute une intégration Nx.
Questions fréquentes
Nx est-il nécessaire ?
La source examinée utilise les workspaces des gestionnaires et ne déclare pas Nx ou un serveur Nx MCP comme prérequis. Un agent compatible et le contexte du dépôt restent nécessaires.
La copie dans nrwl/nx apporte-t-elle une autre capacité ?
Aux deux révisions figées examinées, les répertoires du Skill sont identiques. Cette page décrit la distribution nx-ai-agents-config : choisir la source déjà utilisée plutôt qu’attendre une seconde capacité.
La procédure a-t-elle été exécutée ici ?
Non. Cette explication repose sur le Skill figé et les documentations officielles, sans test dans votre dépôt.
Installer ce Skill
Ajoutez ce Skill depuis sa source GitHub vérifiée avec la Skills CLI.
npx skills add https://github.com/nrwl/nx-ai-agents-config --skill link-workspace-packagesInformations sur la source
- 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
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
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



