Does this work with workspaces like Yarn, Lerna, or Nx?

Absolutely. While it doesn't replace those tools, it ensures Claude uses them correctly by executing the commands from the specific subproject paths those tools expect.

What happens if I have nested git repositories (subtrees)?

Standard Git commands may identify the innermost root. In these cases, creating a .monorepo.json config is highly recommended to explicitly define the true monorepo root for Claude.

How does the skill handle different repository roots?

It attempts to find a .monorepo.json file first. If one doesn't exist, it uses `git rev-parse --show-toplevel` to identify the repository root and build paths dynamically.

Can I automate the configuration for my existing monorepo?

Yes, the skill includes a `monorepo-init` script that can be run with --dry-run or --write flags to auto-detect subprojects and generate the necessary configuration file.

Why does this skill insist on using absolute paths?

Claude's shell state is not guaranteed to persist reliably between individual commands. Using absolute paths ensures that every command executes in the correct directory regardless of the current shell location.

Working in Monorepos

Name: Working in Monorepos
Author: technicalpickles

bytechnicalpickles

0•

Productividad y Flujo de Trabajo

Streamlines monorepo development by enforcing absolute path execution to prevent directory confusion and shell state errors.

Working in Monorepos is a specialized Claude Code skill designed to optimize development within complex, multi-project repositories. By mandating the use of absolute paths for every shell command, it eliminates the common pitfall of unreliable shell states, ensuring that tests, builds, and scripts are always executed from the precise subproject directory intended. Whether utilizing a dedicated .monorepo.json configuration or automatic root detection via Git, this skill provides a robust framework for navigating nested structures and maintaining consistency across diverse technology stacks in a single repository.

Características Principales

01Enforces the 'Iron Rule' of absolute paths for all shell commands

02Context-aware command overrides for root and subproject levels

030 GitHub stars

04Automatic monorepo root detection using Git metadata

05Support for .monorepo.json to map subprojects and custom commands

06Automated setup script for rapid subproject discovery and config generation

Casos de Uso

01Running CI/CD related tasks locally across different workspace packages

02Navigating and executing commands across multi-language subprojects (e.g., Ruby, Node, Go)

03Preventing command execution errors caused by inconsistent directory states between turns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add technicalpickles/pickled-claude-plugins working-in-monorepos

For use in Claude.ai and ChatGPT

Download Skill