pnpm

Name: pnpm
Author: antfu

github.com/antfuDevelopment6.0k22.5k installsUpdated 6d ago

About pnpm

A skill for using pnpm, the package manager for JavaScript projects. It covers commands, configuration, workspaces, dependency management, security, task orchestration, and release workflows across pnpm v11 and v12.

Key features

01Package and workspace commands
02Centralized versions and dependency overrides
03Patches, hooks, and peer dependency controls
04Supply-chain security settings
05Workspace task and release management

Use cases

01Managing dependencies in a pnpm project
02Configuring a JavaScript monorepo
03Setting up CI installs and release workflows

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/antfu/skills --skill pnpm

After installing, type/pnpmin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

GENERATION.md

references/

best-practices-ci.md

best-practices-migration.md

best-practices-performance.md

core-cli.md

core-config.md

core-store.md

core-workspaces.md

features-aliases.md

features-catalogs.md

features-config-dependencies.md

features-global-virtual-store.md

features-hooks.md

features-multi-ecosystem.md

features-overrides.md

features-patches.md

features-peer-deps.md

features-supply-chain-security.md

features-task-orchestration.md

features-versioning.md

Details

From the project README

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

Comments

Markdown supported

Details

Author: antfu
Repository: antfu/skills
Category: Development
Installs: 22,482
GitHub stars: 6,019

Report

More skills

All skills

remotion-render

github.com/inference-sh

1.6M

Render videos from React/Remotion component code via inference.sh. Pass TSX code, get MP4. Supports all Remotion APIs: useCurrentFrame, useVideoConfig, spring, interpolate, AbsoluteFill, Sequence. Configurable resolution, FPS, duration, codec. Use for: programmatic video generation, animated graphics, motion design, data-driven videos, React animations to video. Triggers: remotion, render video from code, tsx to video, react video, programmatic video, remotion render, code to video, animated video, motion graphics code, react animation video

improve-codebase-architecture

github.com/mattpocock

1.2M

Scan a codebase for architecture improvement opportunities, present them as a visual HTML report, then dive deep into whichever one you pick.

design-mobile-apps

github.com/designed-by-ai

1.1M

Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML

vercel-react-best-practices

github.com/vercel-labs

848.6k

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.