pnpm

Enforce pnpm workspace conventions and Bun-based runtime rules in monorepos.

5|1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/Alpha-Innovation-Labs/ratkit --skill pnpm-alpha-innovation-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pnpm
Source: https://github.com/Alpha-Innovation-Labs/ratkit/tree/main/.agents/skills/software-enginering/pnpm
Command: npx skills add https://github.com/Alpha-Innovation-Labs/ratkit --skill pnpm-alpha-innovation-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill defines and enforces a consistent pnpm-based workspace structure, guiding dependency management, and runtime script execution in this monorepo.

Core Features & Use Cases

  • Workspace layout conventions for apps and packages
  • Bun-based runtime execution for scripts
  • Strict .npmrc baselines to enforce hardlinks and isolated linker
  • Clear separation of runnable apps (apps) and libraries (packages)

Quick Start

Validate and align your workspace with the defined pnpm + Bun conventions.

Frequently Asked Questions about pnpm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce pnpm workspace conventions in a monorepo?

Enforce pnpm workspace conventions by applying strict layout rules under src/apps and src/packages, separating runnable apps from reusable libraries while maintaining a standard dependency policy.

How does the Bun runtime execute pnpm workspace scripts?

Bun executes pnpm workspace scripts by targeting specific package directories directly, using the command structure `bun --cwd <package-dir> run <script>` to run package-level tasks within the monorepo.

Can I use Bun with pnpm as the sole package manager in a monorepo?

Yes, you can use Bun with pnpm as the sole package manager. The setup uses pnpm to manage dependencies via a hardlink-based node_modules configuration, while Bun acts as the runtime for script execution.

What is the purpose of a hardlink-based node_modules setup in pnpm?

A hardlink-based node_modules setup in pnpm enforces strict dependency isolation across the workspace. Configured via a baseline .npmrc, it ensures packages only access explicitly declared dependencies, preventing phantom dependencies.

What is the best way to structure apps and packages in a pnpm workspace?

The best way to structure apps and packages in a pnpm workspace is to place runnable applications under src/apps and reusable libraries under src/packages, ensuring clear separation for dependency management and runtime execution.