Bazel Build Optimization

For teams running multi-language monorepos at scale, this handles the gnarly parts of Bazel configuration that usually take weeks to figure out. It covers remote caching setup, proper .bazelrc tuning for CI/CD, and cross-language dependency management between TypeScript, Python, and other ecosystems. The custom rule templates and query examples are especially useful when you're debugging why builds are slow or writing your own tooling. Most teams underestimate Bazel's complexity until they hit performance walls, and this gives you the production patterns that Google-scale companies actually use rather than basic tutorials.

skills.sh installs: 10.6K
GitHub stars: 42.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add wshobson/agents --skill bazel-build-optimization --agent claude-code

Installs into .claude/skills of the current project.

Files

Bazel Build Optimization

Production patterns for Bazel in large-scale monorepos.

When to Use This Skill

Setting up Bazel for monorepos
Configuring remote caching/execution
Optimizing build times
Writing custom Bazel rules
Debugging build issues
Migrating to Bazel

Core Concepts

1. Bazel Architecture

workspace/
├── WORKSPACE.bazel       # External dependencies
├── .bazelrc              # Build configurations
├── .bazelversion         # Bazel version
├── BUILD.bazel           # Root build file
├── apps/
│   └── web/
│       └── BUILD.bazel
├── libs/
│   └── utils/
│       └── BUILD.bazel
└── tools/
    └── bazel/
        └── rules/

2. Key Concepts

Concept	Description
Target	Buildable unit (library, binary, test)
Package	Directory with BUILD file
Label	Target identifier `//path/to:target`
Rule	Defines how to build a target
Aspect	Cross-cutting build behavior