pnpm is a fast, disk space efficient package manager. It uses a content-addressable store to deduplicate packages across all projects on a machine, and enforces strict dependency resolution by default, preventing phantom dependencies.
pnpm v12 is a Rust rewrite of v11: stable, and keeps v11's commands, flags, settings, and lockfile format — so most guidance here applies to both. A handful of v12 behaviors differ (git deps resolve via HTTPS, project-aware global bins, other package managers, packageImportMethod: auto hardlinks first on Linux, --resolution-only removed) — see best-practices-migration.
Configuration model (important): pnpm settings live in pnpm-workspace.yaml (and the global config.yaml) using camelCase keys. .npmrc is used only for authentication/registry credentials, and the pnpm field of package.json is no longer read. When working in a pnpm project, check pnpm-workspace.yaml for settings/workspace structure and .npmrc only for auth. Always use --frozen-lockfile (or pnpm ci) in CI.
The skill is based on pnpm 12.x, generated at 2026-09-25. It covers v11+v12 behavior (config split, isolated global packages, allowBuilds, pmOnFail, global virtual store, native release management, workspace task orchestration, and experimental Python/Cargo support) where current docs describe them.
Core
| Topic |
Description |
Reference |
| CLI Commands |
install/add/remove/update, run, dlx/pnx, workspace, runtime, publishing (version, view, sbom, stage) |
core-cli |
| Configuration |
pnpm-workspace.yaml settings (camelCase), global config.yaml, packageConfigs, .npmrc auth |
core-config |
| Workspaces |
Monorepo support: filtering, workspace protocol, shared lockfile, packageConfigs |
core-workspaces |
| Store |
Content-addressable store, virtual store, node linker modes, frozen/read-only store |
core-store |
Features
| Topic |
Description |
Reference |
| Catalogs |
Centralized dependency versions; catalogMode, catalog: in overrides |
features-catalogs |
| Overrides |
Force versions (incl. transitive & peer deps); packageExtensions |
features-overrides |
| Patches |
Modify third-party packages; patchedDependencies in pnpm-workspace.yaml |
features-patches |
| Aliases |
Install under custom names (npm:) and registry aliases (namedRegistries) |
features-aliases |
| Hooks |
.pnpmfile.mjs hooks (readPackage, updateConfig, beforePacking), finders, resolvers/fetchers |
features-hooks |
| Peer Dependencies |
Auto-install, strict mode, rules, dedupePeers, peers check |
features-peer-deps |
| Config Dependencies |
Share hooks/settings/catalogs/patches across repos via configDependencies |
features-config-dependencies |
| Global Virtual Store & Shims |
Shared node_modules, git-worktree multi-agent setups, isolated global packages, project-aware bins, other package managers |
features-global-virtual-store |
| Supply-Chain Security |
Build approval (allowBuilds), minimumReleaseAge, trustPolicy, lockfile integrity |
features-supply-chain-security |
| Task Orchestration |
Cross-project task graphs (tasks/dependsOn), concurrency groups, priority, pnpm pipeline |
features-task-orchestration |
| Release Management |
Native versioning: pnpm change/version -r/lane, lanes, epics, fixed groups |
features-versioning |
| Multi-Ecosystem |
Python (pypi:) and Cargo (crate:) dependencies alongside npm (experimental) |
features-multi-ecosystem |
Best Practices
| Topic |
Description |
Reference |
| CI/CD Setup |
GitHub Actions, GitLab, Docker, pnpm ci, store caching, frozen lockfiles |
best-practices-ci |
| Migration |
npm/Yarn → pnpm, phantom deps, and pnpm v10 → v11 → v12 upgrade notes |
best-practices-migration |
| Performance |
Install optimizations, allowBuilds, global virtual store, workspace parallelization |
best-practices-performance |
1---2name: pnpm-23description: Node.js package manager with strict dependency resolution. Use when running pnpm specific commands, configuring workspaces via pnpm-workspace.yaml, or managing dependencies with catalogs, patches, overrides, config dependencies, or the global virtual store.4metadata:5 author: Anthony Fu6 version: "2026.9.25"7 source: https://skillmd.com/skills/pleaseai/pnpm-28 upstream: Generated from https://github.com/pnpm/pnpm, scripts located at https://github.com/antfu/skills9---1011pnpm is a fast, disk space efficient package manager. It uses a content-addressable store to deduplicate packages across all projects on a machine, and enforces strict dependency resolution by default, preventing phantom dependencies.1213**pnpm v12 is a Rust rewrite** of v11: stable, and keeps v11's commands, flags, settings, and lockfile format — so most guidance here applies to both. A handful of v12 behaviors differ (git deps resolve via HTTPS, project-aware global bins, other package managers, `packageImportMethod: auto` hardlinks first on Linux, `--resolution-only` removed) — see best-practices-migration.1415**Configuration model (important):** pnpm settings live in `pnpm-workspace.yaml` (and the global `config.yaml`) using **camelCase** keys. `.npmrc` is used **only** for authentication/registry credentials, and the `pnpm` field of `package.json` is no longer read. When working in a pnpm project, check `pnpm-workspace.yaml` for settings/workspace structure and `.npmrc` only for auth. Always use `--frozen-lockfile` (or `pnpm ci`) in CI.1617> The skill is based on pnpm 12.x, generated at 2026-09-25. It covers v11+v12 behavior (config split, isolated global packages, `allowBuilds`, `pmOnFail`, global virtual store, native release management, workspace task orchestration, and experimental Python/Cargo support) where current docs describe them.1819## Core2021| Topic | Description | Reference |22|-------|-------------|-----------|23| CLI Commands | install/add/remove/update, run, dlx/pnx, workspace, runtime, publishing (version, view, sbom, stage) | [core-cli](references/core-cli.md) |24| Configuration | pnpm-workspace.yaml settings (camelCase), global config.yaml, packageConfigs, .npmrc auth | [core-config](references/core-config.md) |25| Workspaces | Monorepo support: filtering, workspace protocol, shared lockfile, packageConfigs | [core-workspaces](references/core-workspaces.md) |26| Store | Content-addressable store, virtual store, node linker modes, frozen/read-only store | [core-store](references/core-store.md) |2728## Features2930| Topic | Description | Reference |31|-------|-------------|-----------|32| Catalogs | Centralized dependency versions; catalogMode, catalog: in overrides | [features-catalogs](references/features-catalogs.md) |33| Overrides | Force versions (incl. transitive & peer deps); packageExtensions | [features-overrides](references/features-overrides.md) |34| Patches | Modify third-party packages; patchedDependencies in pnpm-workspace.yaml | [features-patches](references/features-patches.md) |35| Aliases | Install under custom names (npm:) and registry aliases (namedRegistries) | [features-aliases](references/features-aliases.md) |36| Hooks | .pnpmfile.mjs hooks (readPackage, updateConfig, beforePacking), finders, resolvers/fetchers | [features-hooks](references/features-hooks.md) |37| Peer Dependencies | Auto-install, strict mode, rules, dedupePeers, peers check | [features-peer-deps](references/features-peer-deps.md) |38| Config Dependencies | Share hooks/settings/catalogs/patches across repos via configDependencies | [features-config-dependencies](references/features-config-dependencies.md) |39| Global Virtual Store & Shims | Shared node_modules, git-worktree multi-agent setups, isolated global packages, project-aware bins, other package managers | [features-global-virtual-store](references/features-global-virtual-store.md) |40| Supply-Chain Security | Build approval (allowBuilds), minimumReleaseAge, trustPolicy, lockfile integrity | [features-supply-chain-security](references/features-supply-chain-security.md) |41| Task Orchestration | Cross-project task graphs (tasks/dependsOn), concurrency groups, priority, pnpm pipeline | [features-task-orchestration](references/features-task-orchestration.md) |42| Release Management | Native versioning: pnpm change/version -r/lane, lanes, epics, fixed groups | [features-versioning](references/features-versioning.md) |43| Multi-Ecosystem | Python (pypi:) and Cargo (crate:) dependencies alongside npm (experimental) | [features-multi-ecosystem](references/features-multi-ecosystem.md) |4445## Best Practices4647| Topic | Description | Reference |48|-------|-------------|-----------|49| CI/CD Setup | GitHub Actions, GitLab, Docker, pnpm ci, store caching, frozen lockfiles | [best-practices-ci](references/best-practices-ci.md) |50| Migration | npm/Yarn → pnpm, phantom deps, and pnpm v10 → v11 → v12 upgrade notes | [best-practices-migration](references/best-practices-migration.md) |51| Performance | Install optimizations, allowBuilds, global virtual store, workspace parallelization | [best-practices-performance](references/best-practices-performance.md) |