Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

pnpm — Claude Code skill: Node.js package manager

Skill for working with pnpm, a Node.js package manager with strict dependency resolution. Use it when your project relies on workspaces, version catalogs, patches, or dependency overrides.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add antfu/skills --skill pnpm -a claude-code
Open on GitHub

What pnpm does

pnpm is a fast, disk-efficient package manager that uses a content-addressable store to deduplicate dependencies across projects. It prevents phantom dependencies by default and scales from single projects to monorepos via pnpm-workspace.yaml.

Version 12 is a Rust rewrite of v11 that keeps commands, flags, and lockfile format identical. Configuration lives in pnpm-workspace.yaml with camelCase keys; .npmrc is reserved for registry credentials only. The skill covers dependency installation and management, version catalogs, patches, overrides, the global virtual store, task orchestration across monorepo packages, and experimental Python and Cargo support alongside npm.

In CI, always run pnpm ci with --frozen-lockfile to prevent unexpected updates. When migrating from npm or Yarn, watch for phantom dependencies—pnpm will reject them by default.

What it helps with

  • set up a package manager for a monorepo
  • centralize dependency versions using catalogs
  • patch third-party packages without forking
  • speed up CI installs with store caching
  • orchestrate build and test tasks across monorepo packages

Example prompts for the agent

  • Configure pnpm for a monorepo with shared version catalog
  • Apply a patch to a package using pnpm
  • Install dependencies in CI and cache the pnpm store

How to install pnpm

1Skills CLI (Vercel)

npx skills add antfu/skills --skill pnpm -a claude-code

2Manually: put the files in place

~/.claude/skills/pnpm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pnpm/

From the same set8

The whole set →
vitest Anthony Fu This skill guides work with Vitest tests, mocks, coverage, filtering, and fixtures. Use it when setting up tests or checking how Vitest fits a Vite project. Claude Code CX Codex Cursor +1 43,600installs vite Anthony Fu This skill covers Vite configuration, plugin development, SSR builds, and the Vite 8 move to Rolldown. Use it with vite.config.ts work. Claude Code CX Codex Cursor +1 39,800installs vue Anthony Fu This skill guides agents through Vue 3 Composition API, script setup, and reactivity. Use it when writing Vue SFCs or built-in component flows. Claude Code CX Codex Cursor +1 35,800installs nuxt Anthony Fu This skill equips your AI agent with Nuxt 5 knowledge: server-side rendering, file-based routing, auto-imports, and Nitro v3 deployment. Use it when building Nuxt apps, server routes, useFetch calls, middleware, or hybrid rendering. Claude Code CX Codex Cursor +1 24,100installs pinia Anthony Fu Pinia skill adds reference documentation to Claude Code for the official Vue state management library. Use it when defining stores, managing state, getters, and actions in Vue apps. Claude Code CX Codex Cursor +1 19,700installs unocss Anthony Fu A skill that gives the agent reference material on UnoCSS configuration, rules, shortcuts and presets. Useful when setting up UnoCSS or reusing Tailwind knowledge in it. Claude Code CX Codex Cursor +1 16,000installs nitro Anthony Fu A skill with Nitro v3 references: file-based routing, route rules, caching, storage and deployment presets. Use it when the agent edits nitro.config or writes H3 handlers. Claude Code CX Codex Cursor +1 2,600installs

Similar

update-avm-modules-in-bicep official github Updates Azure Verified Module versions in Bicep files and checks the result with lint and build. Useful when reviewing infrastructure changes. GitHub Copilot 8,600installs portless vercel-labs Assigns local dev servers stable names like myapp.localhost instead of port numbers. Claude Code CX Codex Cursor +1 5,900installs workload-manager-basics official google This skill manages Google Cloud Workload Manager rules, evaluations, scanned resources, and findings. Use it for workload best-practice checks. Claude Code Gemini CLI CX Codex 6,999installs agent-platform-alert-configuration official google This skill creates Terraform alert policies for AI agents from OpenTelemetry metrics. Use it to watch latency, errors, token usage, and quality. Claude Code Gemini CLI CX Codex 6,857installs gke-inference official google Select a model profile and accelerator, then prepare Kubernetes manifests for AI/ML inference serving on GKE. Claude Code Gemini CLI CX Codex 6,791installs bigtable-basics official google This skill helps configure Google Bigtable, design row keys, and work with queries. Use it when building client code or investigating slow table performance. Claude Code Gemini CLI CX Codex 6,768installs wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. Claude Code 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. Claude Code CX Codex Cursor +1 1,200,000installs

Questions about pnpm

How do I install the pnpm skill in Claude Code?

Run npx skills add antfu/skills --skill pnpm -a claude-code twice. The skill will appear at ~/.claude/skills/pnpm/SKILL.md.

What does the pnpm skill do?

It gives your agent knowledge of pnpm commands, configuration via pnpm-workspace.yaml, workspaces, version catalogs, patches, overrides, and task orchestration.

How does pnpm differ from npm?

pnpm uses a content-addressable store (saves disk space), forbids phantom dependencies, and configures through pnpm-workspace.yaml instead of package.json. For CI, use pnpm ci with --frozen-lockfile.

Source text

SKILL.md · MIT 
---
name: pnpm
description: 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.
metadata:
  author: Anthony Fu
  version: "2026.9.25"
  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, 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](references/core-cli.md) |
| Configuration | pnpm-workspace.yaml settings (camelCase), global config.yaml, packageConfigs, .npmrc auth | [core-config](references/core-config.md) |
| Workspaces | Monorepo support: filtering, workspace protocol, shared lockfile, packageConfigs | [core-workspaces](references/core-workspaces.md) |
| Store | Content-addressable store, virtual store, node linker modes, frozen/read-only store | [core-store](references/core-store.md) |

## Features

| Topic | Description | Reference |
|-------|-------------|-----------|
| Catalogs | Centralized dependency versions; catalogMode, catalog: in overrides | [features-catalogs](references/features-catalogs.md) |
| Overrides | Force versions (incl. transitive & peer deps); packageExtensions | [features-overrides](references/features-overrides.md) |
| Patches | Modify third-party packages; patchedDependencies in pnpm-workspace.yaml | [features-patches](references/features-patches.md) |
| Aliases | Install under custom names (npm:) and registry aliases (namedRegistries) | [features-aliases](references/features-aliases.md) |
| Hooks | .pnpmfile.mjs hooks (readPackage, updateConfig, beforePacking), finders, resolvers/fetchers | [features-hooks](references/features-hooks.md) |
| Peer Dependencies | Auto-install, strict mode, rules, dedupePeers, peers check | [features-peer-deps](references/features-peer-deps.md) |
| Config Dependencies | Share hooks/settings/catalogs/patches across repos via configDependencies | [features-config-dependencies](references/features-config-dependencies.md) |
| 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) |
| Supply-Chain Security | Build approval (allowBuilds), minimumReleaseAge, trustPolicy, lockfile integrity | [features-supply-chain-security](references/features-supply-chain-security.md) |
| Task Orchestration | Cross-project task graphs (tasks/dependsOn), concurrency groups, priority, pnpm pipeline | [features-task-orchestration](references/features-task-orchestration.md) |
| Release Management | Native versioning: pnpm change/version -r/lane, lanes, epics, fixed groups | [features-versioning](references/features-versioning.md) |
| Multi-Ecosystem | Python (pypi:) and Cargo (crate:) dependencies alongside npm (experimental) | [features-multi-ecosystem](references/features-multi-ecosystem.md) |

## Best Practices

| Topic | Description | Reference |
|-------|-------------|-----------|
| CI/CD Setup | GitHub Actions, GitLab, Docker, pnpm ci, store caching, frozen lockfiles | [best-practices-ci](references/best-practices-ci.md) |
| Migration | npm/Yarn → pnpm, phantom deps, and pnpm v10 → v11 → v12 upgrade notes | [best-practices-migration](references/best-practices-migration.md) |
| Performance | Install optimizations, allowBuilds, global virtual store, workspace parallelization | [best-practices-performance](references/best-practices-performance.md) |

© Anthony Fu · MIT · antfu/skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor