Pnpm
antfu/skillsThis skill provides command-line tools and best practices for managing projects with pnpm, a fast and disk-efficient package manager. It supports monorepos, strict dependency resolution, and various features like dependency overrides, patches, and aliases, making it suitable for developers working on complex or large-scale JavaScript projects. The skill emphasizes configuration management, workspace handling, and optimized workflows in CI/CD environments.
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 Configuration pnpm-workspace.yaml, .npmrc settings, and package.json fields core-config Workspaces Monorepo support with filtering, workspace protocol, and shared lockfile core-workspaces Store Content-addressable storage, hard links, and disk efficiency core-store
Features
Topic Description Reference Catalogs Centralized dependency version management for workspaces features-catalogs Overrides Force specific versions of dependencies including transitive features-overrides Patches Modify third-party packages with custom fixes features-patches Aliases Install packages under custom names using npm: protocol features-aliases Hooks Customize resolution with .pnpmfile.cjs hooks features-hooks Peer Dependencies Auto-install, strict mode, and dependency rules features-peer-deps
Best Practices
Topic Description Reference CI/CD Setup GitHub Actions, GitLab CI, Docker, and caching strategies best-practices-ci Migration Migrating from npm/Yarn, handling phantom deps, monorepo migration best-practices-migration Performance Install optimizations, store caching, workspace parallelization best-practices-performance
GitHub Owner
Owner: antfu
GitHub Links
- Twitter: https://twitter.com/antfu7
- YouTube: https://www.youtube.com/c/AnthonyFu7
- Instagram: https://www.instagram.com/antfu7
Files
core-cli
core-config
core-workspaces
core-store
features-catalogs
features-overrides
features-patches
features-aliases
features-hooks
features-peer-deps
best-practices-ci
best-practices-migration
best-practices-performance
- View: https://github.com/antfu/skills/blob/HEAD/skills/pnpm/references/best-practices-performance.md
SKILL.md
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 |
| Configuration | pnpm-workspace.yaml, .npmrc settings, and package.json fields | core-config |
| Workspaces | Monorepo support with filtering, workspace protocol, and shared lockfile | core-workspaces |
| Store | Content-addressable storage, hard links, and disk efficiency | core-store |
Features
| Topic | Description | Reference |
|---|---|---|
| Catalogs | Centralized dependency version management for workspaces | features-catalogs |
| Overrides | Force specific versions of dependencies including transitive | features-overrides |
| Patches | Modify third-party packages with custom fixes | features-patches |
| Aliases | Install packages under custom names using npm: protocol | features-aliases |
| Hooks | Customize resolution with .pnpmfile.cjs hooks | features-hooks |
| Peer Dependencies | Auto-install, strict mode, and dependency rules | features-peer-deps |
Best Practices
| Topic | Description | Reference |
|---|---|---|
| CI/CD Setup | GitHub Actions, GitLab CI, Docker, and caching strategies | best-practices-ci |
| Migration | Migrating from npm/Yarn, handling phantom deps, monorepo migration | best-practices-migration |
| Performance | Install optimizations, store caching, workspace parallelization | best-practices-performance |