pnpm

---
name: pnpm
description: Node.js package manager with strict dependency resolution. Use when running pnpm specific commands, configuring workspaces, or managing dependencies with catalogs, patches, or overrides.
metadata:
  author: Anthony Fu
  version: '2026.1.28'
  source: Generated from https://github.com/pnpm/pnpm, scripts located at https://github.com/antfu/skills
---

pnpm is a fast, disk space efficient package manager. It uses a content-addressable store to deduplicate packages across all projects on a machine, saving significant disk space. pnpm enforces strict dependency resolution by default, preventing phantom dependencies. Configuration should preferably be placed in `pnpm-workspace.yaml` for pnpm-specific settings.

**Important:** When working with pnpm projects, agents should check for `pnpm-workspace.yaml` and `.npmrc` files to understand workspace structure and configuration. Always use `--frozen-lockfile` in CI environments.

> The skill is based on pnpm 10.x, generated at 2026-01-28.

## Core

| Topic         | Description                                                              | Reference                                        |
| ------------- | ------------------------------------------------------------------------ | ------------------------------------------------ |
| CLI Commands  | Install, add, remove, update, run, exec, dlx, and workspace commands     | [core-cli](references/core-cli.md)               |
| Configuration | pnpm-workspace.yaml, .npmrc settings, and package.json fields            | [core-config](references/core-config.md)         |
| Workspaces    | Monorepo support with filtering, workspace protocol, and shared lockfile | [core-workspaces](references/core-workspaces.md) |
| Store         | Content-addressable storage, hard links, and disk efficiency             | [core-store](references/core-store.md)           |

## Features

| Topic             | Description                                                  | Reference                                              |
| ----------------- | ------------------------------------------------------------ | ------------------------------------------------------ |
| Catalogs          | Centralized dependency version management for workspaces     | [features-catalogs](references/features-catalogs.md)   |
| Overrides         | Force specific versions of dependencies including transitive | [features-overrides](references/features-overrides.md) |
| Patches           | Modify third-party packages with custom fixes                | [features-patches](references/features-patches.md)     |
| Aliases           | Install packages under custom names using npm: protocol      | [features-aliases](references/features-aliases.md)     |
| Hooks             | Customize resolution with .pnpmfile.cjs hooks                | [features-hooks](references/features-hooks.md)         |
| Peer Dependencies | Auto-install, strict mode, and dependency rules              | [features-peer-deps](references/features-peer-deps.md) |

## Best Practices

| Topic       | Description                                                        | Reference                                                              |
| ----------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------- |
| CI/CD Setup | GitHub Actions, GitLab CI, Docker, and caching strategies          | [best-practices-ci](references/best-practices-ci.md)                   |
| Migration   | Migrating from npm/Yarn, handling phantom deps, monorepo migration | [best-practices-migration](references/best-practices-migration.md)     |
| Performance | Install optimizations, store caching, workspace parallelization    | [best-practices-performance](references/best-practices-performance.md) |

From sanity-io/plugins at a80a997, shown as plain text under its license: MIT (permissive). The license text is in LICENSE.

• SKILL.md3.9 KB · d58bdfa07358
• GENERATION.md134 B · 9904d933ccf1
• references/
• best-practices-ci.md5.3 KB · 05b079822987
• best-practices-migration.md5.1 KB · d8affe2bdf5a
• best-practices-performance.md4.8 KB · 107f4b5b1cd8
• core-cli.md3.6 KB · e69fdadda69d
• core-config.md3.9 KB · 216ab8a06f65
• core-store.md4.0 KB · 8486ef184a15
• core-workspaces.md4.2 KB · 10963209061b
• features-aliases.md2.9 KB · 31516ff651c2
• features-catalogs.md3.2 KB · fd898a167e58
• features-hooks.md4.5 KB · 5632f5bf5fe2
• features-overrides.md3.5 KB · b7a199754b6f
• features-patches.md3.9 KB · fe4ec0addb0b
• features-peer-deps.md4.3 KB · aa2a846a664f

15 files, 57 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.