# Monorepo Manager > Use when working with a skill for managing and optimizing monorepo workspaces, dependency graphs, and build pipelines, leveraging tools like pnpm workspaces and Turborepo. - Skill: `tomevault-io/monorepo-manager` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/monorepo-manager` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/monorepo-manager/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/monorepo-manager --- # Monorepo Manager Skill This skill assists in maintaining a healthy and performant monorepo structure. ## Capabilities 1. **Dependency Graph Analysis**: Visualize and understand package dependencies. 2. **Task Orchestration**: Run tasks (build, test, lint) efficiently across multiple packages, respecting topological order. 3. **Cache Optimization**: Configure and troubleshoot build caching to speed up CI/CD. 4. **Workspace Integrity**: Ensure version consistency for shared dependencies. ## Key Concepts - **Workspace Protocol (`workspace:*`)**: Use this for internal dependencies to ensure the local version is always used. - **Topological Sort**: Tasks must run in dependency order (e.g., build `core` before `adapter-stockfish`). - **Remote Caching**: Sharing build artifacts across team members/CI (e.g., with Turborepo Remote Cache). ## Best Practices Checklist - [ ] **Consistent Dependency Versions**: Use `syncpack` or similar tools to keep external dependency versions aligned across packages. - [ ] **Root configuration**: Keep shared configs (tsconfig, eslintrc) in the root or a dedicated `config` package. - [ ] **Scoping**: Use `--filter` or similar flags to run commands only on affected packages. ## Common commands (pnpm) - `pnpm -r --filter `: Run a command in a specific package. - `pnpm -r --filter ...[origin/main] `: Run command on packages changed since main. - `pnpm install`: Install dependencies for the entire workspace. ## Troubleshooting - **"Module not found"**: Check if the dependency is listed in `package.json` and if the referenced workspace package is built. - **"Version mismatch"**: Ensure standard dependencies are using the same version to avoid multiple copies in `node_modules`. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/hdkz-dev) — claim your Tome and manage your conversions.