Agent skill

Monorepo Navigator

by borghei in borghei/Claude-Skills

Manage and optimize monorepos with Turborepo, Nx, pnpm workspaces, and Changesets.

MITAuto-check passedDevelopment

Install Monorepo Navigator

skills CLI
$ npx skills add borghei/Claude-Skills --skill monorepo-navigator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills monorepo-navigator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/monorepo-navigator .claude/skills/monorepo-navigator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
monorepo-navigator
GitHub stars
886
Token cost
~1.5k tokens
SKILL.md length
609 words
Files
6 (incl. scripts, references)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Manage and optimize monorepos with Turborepo, Nx, pnpm workspaces, and Changesets.

  • Working in monorepos
  • SKILL.md covers Core Capabilities, When to Use, Clarify First and Tools, plus 3 more sections
  • Runs Python scripts from its folder; calls python and changeset
  • Running impact analysis

What it does

Monorepo Navigator is an agent skill from borghei/Claude-Skills. Manage and optimize monorepos with Turborepo, Nx, pnpm workspaces, and Changesets. Use when working in monorepos, running impact analysis, optimizing build times with remote caching, migrating from multi-repo, or coordinating publishing.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/operations-and-best-practices.md`, `references/tooling-and-configuration.md` and `scripts/dependency_graph.py`).

It sits in Development, covering Monorepo tooling. It works with Turborepo. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Working in monorepos
  • Running impact analysis
  • Optimizing build times with remote caching
  • Migrating from multi-repo

Example prompts

  • “/monorepo-navigator”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • changeset

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Monorepo Navigator loads about 1.5k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 609 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 609 words, ~1,500 tokens.

Download SKILL.mdSave it as .claude/skills/monorepo-navigator/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
monorepo-navigator
description
Manage and optimize monorepos with Turborepo, Nx, pnpm workspaces, and Changesets. Use when working in monorepos, running impact analysis, optimizing build times with remote caching, migrating from multi-repo, or coordinating publishing.
license
MIT + Commons Clause
metadata.version
1.1.0
metadata.author
borghei
metadata.category
engineering
metadata.domain
monorepo-architecture
metadata.tier
POWERFUL
metadata.updated
2026-06-17
metadata.frameworks
turborepo, nx, pnpm-workspaces, changesets

Monorepo Navigator

Navigate, manage, and optimize monorepos at any scale. Covers Turborepo, Nx, pnpm workspaces, and Lerna/Changesets for cross-package impact analysis, selective builds on affected packages only, dependency graph visualization, remote caching configuration, migration from multi-repo to monorepo with preserved git history, and coordinated package publishing with automated changelogs.

Keywords: monorepo, Turborepo, Nx, pnpm workspaces, Changesets, dependency graph, remote cache, affected packages, selective builds, cross-package impact, npm publishing, workspace protocol

Core Capabilities

  • Impact analysis — determine which apps break when a shared package changes, trace dependency chains, visualize Mermaid graphs, and calculate blast radius.
  • Selective execution — run tests/builds only for affected packages, filter by changed files since a git ref, and skip unchanged packages in CI.
  • Build optimization — remote caching (Turborepo/Vercel, Nx Cloud), incremental builds with input/output config, dependency-aware parallel scheduling, and artifact sharing.
  • Publishing — Changesets for coordinated versioning, automated per-package changelogs, pre-release channels, and workspace:* replacement during publish.

When to Use

  • Multiple packages/apps share code (UI components, utils, types, API clients)
  • Build times are slow because everything rebuilds on every change
  • Migrating from multiple repos to a single monorepo
  • Publishing npm packages with coordinated versioning
  • Teams work across packages and need unified tooling

Clarify First

Before analyzing or configuring, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Tooling — Turborepo, Nx, pnpm workspaces, or Changesets (drives the config and commands generated)
  • Task — impact/dependency analysis, build optimization, or publishing setup (selects dependency_graph.py vs impact_detector.py vs package_analyzer.py)
  • Repo root & git ref — the monorepo path and the baseline ref for "affected" detection (sets --ref and what counts as changed)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Tools

ToolPurposeCommand
dependency_graph.pyGenerate a Mermaid dependency graph of internal packagespython scripts/dependency_graph.py . --focus @repo/ui --direction dependents
impact_detector.pyDetect which packages are affected by file changespython scripts/impact_detector.py . --ref origin/main --affected-only
package_analyzer.pyAnalyze package structure, dependencies, and healthpython scripts/package_analyzer.py . --only-shared
Show full SKILL.md (277 more words)Show less

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/tooling-and-configuration.md — tool selection decision matrix, recommended repo structure, full turbo.json and pnpm-workspace config, key Turborepo/pnpm commands, impact-analysis commands, remote-caching setup, affected-only CI workflow, Changesets publishing, and multi-repo→monorepo migration steps. Read when configuring or operating a monorepo.
  • references/operations-and-best-practices.md — common pitfalls, best practices, troubleshooting table, and success criteria. Read when something misbehaves or when validating a setup.

Scope & Limitations

This skill covers:

  • Turborepo, Nx, and pnpm workspace configuration and optimization
  • Cross-package dependency analysis and impact visualization
  • Remote caching setup (Vercel, Nx Cloud, self-hosted)
  • Changesets-based coordinated versioning and npm publishing

This skill does NOT cover:

  • Application-level build configuration (webpack, Vite, esbuild internals) — see performance-profiler
  • CI/CD pipeline design beyond monorepo-specific filters — see ci-cd-pipeline-builder
  • Git branching strategies and release flow — see release-manager
  • Dependency vulnerability scanning and license auditing — see dependency-auditor

Integration Points

SkillIntegrationData Flow
ci-cd-pipeline-builderMonorepo-aware CI workflows use --filter flags and remote caching tokensMonorepo Navigator defines filter patterns and cache config that CI pipelines consume
release-managerChangesets versioning feeds into release orchestration and tag managementRelease Manager triggers changeset version and changeset publish as part of release flow
dependency-auditorWorkspace dependency graph informs vulnerability and license scanning scopeMonorepo Navigator exports the package dependency tree that Dependency Auditor analyzes
performance-profilerBuild profiling data identifies slow packages for optimizationPerformance Profiler measures per-package build times surfaced by Turborepo --summarize
changelog-generatorChangesets produce per-package changelogs consumed by release notesChangeset summaries flow into Changelog Generator for formatted release documentation
tech-debt-trackerCross-package coupling and circular dependencies surface as tracked tech debt itemsMonorepo Navigator's impact analysis identifies coupling hotspots that Tech Debt Tracker records

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in engineering/monorepo-navigator of borghei/Claude-Skills.

  • SKILL.md
  • references/operations-and-best-practices.md
  • references/tooling-and-configuration.md
  • scripts/dependency_graph.py
  • scripts/impact_detector.py
  • scripts/package_analyzer.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Monorepo Navigator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Monorepo Navigator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Monorepo Navigator this skillborghei/Claude-Skills886—~1.5kAutomated safety check: PassMIT
Monorepo Managementgluestack/gluestack-ui5.3k12 repos~3.2kAutomated safety check: WarnNone
TS SDK Authormindfold-ai/Trellis15k—~6.1kAutomated safety check: PassMIT
Turborepo Cachingwshobson/agents40k9 repos~2kAutomated safety check: NotesMIT
TurborepoJetBrains/skills36620 repos~6.7kAutomated safety check: NotesMIT
Turborepo WorkflowChatbotXIO/ChatbotX881—~880Automated safety check: NotesCustom licence

Similar skills

  • Monorepo Management

    gluestack/gluestack-ui

    Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management.

    5.3k GitHub starsUsed in 12 repos~3.2k tokens
    DevelopmentAuto-check: warnings
  • TS SDK Author

    mindfold-ai/Trellis

    Design, build, verify, and publish production-grade TypeScript SDKs as npm packages inside a pnpm monorepo.

    15k GitHub stars~6.1k tokensUpdated 10 days ago
    DevelopmentAuto-check passed
  • Turborepo Caching

    wshobson/agents

    Configures Turborepo pipelines and local or remote caching for monorepo builds, including Vercel remote cache, a self-hosted cache and cache-miss debugging.

    40k GitHub starsUsed in 9 repos~2k tokens
    DevelopmentAuto-check: notes
  • Turborepo

    JetBrains/skills

    Official

    Turborepo monorepo build system guidance. An agent skill from JetBrains/skills.

    366 GitHub starsUsed in 20 repos~6.7k tokens
    DevelopmentAuto-check: notes
  • Turborepo Workflow

    ChatbotXIO/ChatbotX

    Manage turborepo monorepo development workflow including dev servers, builds, linting, and package management.

    881 GitHub stars~880 tokensUpdated today
    DevelopmentAuto-check: notes
  • Monorepo Architect

    davila7/claude-code-templates

    Expert in monorepo architecture, build systems, and dependency management at scale.

    32k GitHub starsUsed in 8 repos~542 tokens
    DevelopmentAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Monorepo Navigator

What does Monorepo Navigator do?

Manage and optimize monorepos with Turborepo, Nx, pnpm workspaces, and Changesets. Monorepo Navigator is an agent skill from borghei/Claude-Skills. Manage and optimize monorepos with Turborepo, Nx, pnpm workspaces, and Changesets.

When should I use Monorepo Navigator?

Monorepo Navigator fits situations like: working in monorepos; running impact analysis; optimizing build times with remote caching; migrating from multi-repo.

How do I install Monorepo Navigator in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill monorepo-navigator -a claude-code`. Or copy the skill folder (engineering/monorepo-navigator in borghei/Claude-Skills) into .claude/skills/monorepo-navigator in your project. Claude Code loads it when a task matches its description.

How do I install Monorepo Navigator in Codex?

Run `npx skills add borghei/Claude-Skills --skill monorepo-navigator -a codex`. Or copy the skill folder (engineering/monorepo-navigator in borghei/Claude-Skills) into .agents/skills/monorepo-navigator in your project. Codex loads it when a task matches its description.

Can I use Monorepo Navigator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill monorepo-navigator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/monorepo-navigator, .gemini/skills/monorepo-navigator, .github/skills/monorepo-navigator and .opencode/skills/monorepo-navigator in your project.

What does Monorepo Navigator need to run?

Going by SKILL.md and its folder, Monorepo Navigator needs Python for the scripts in its folder and the command-line tools its instructions call (python and changeset). Our summary lists: Python 3.

Does Monorepo Navigator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Monorepo Navigator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Monorepo Navigator use?

Monorepo Navigator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Monorepo Navigator use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.2k tokens, read only when the agent opens those files.

What are the alternatives to Monorepo Navigator?

Skills that share tags, products or a category with Monorepo Navigator: Monorepo Management (gluestack/gluestack-ui, 5.3k stars), TS SDK Author (mindfold-ai/Trellis, 15k stars), Turborepo Caching (wshobson/agents, 40k stars) and Turborepo (JetBrains/skills, 366 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Monorepo Navigator?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.