bazel-build-optimization

Overview

What is bazel-build-optimization?

bazel-build-optimization is a specialized skill designed to help developers and teams optimize Bazel builds in large-scale monorepos. It provides practical guidance for configuring Bazel, implementing remote caching and execution, and improving build performance in enterprise environments. This skill is especially useful for organizations migrating to Bazel or facing slow build times in complex codebases.

Who should use this skill?

• Developers managing monorepos with Bazel
• Build engineers seeking faster build times
• Teams migrating to Bazel from other build systems
• Anyone needing to configure custom Bazel rules or debug build issues

Problems solved

• Slow build times in large repositories
• Inefficient build configurations
• Difficulty setting up remote caching and execution
• Challenges in writing custom Bazel rules

How to Use

Installation Steps

1. Install the skill using:
   npx skills add https://github.com/wshobson/agents --skill bazel-build-optimization
2. Review the SKILL.md file for an overview and workflow guidance.
3. Explore supporting files such as README.md, AGENTS.md, metadata.json, and folders like rules/, resources/, references/, or scripts/ for additional context and templates.

Initial Setup

• Start by configuring your Bazel workspace with files like WORKSPACE.bazel, .bazelrc, .bazelversion, and BUILD.bazel.
• Use provided templates and examples to set up remote caching and execution.
• Adapt the recommended patterns to fit your repository structure and build requirements.

Best Practices

• Use Bazel's remote caching to speed up builds across teams.
• Write custom rules for project-specific build needs.
• Regularly review build configurations for performance bottlenecks.

When is it a good fit?

• Your codebase is a monorepo or has complex dependencies.
• You need to optimize build times for CI/CD pipelines.
• You are migrating to Bazel and want proven patterns.

When is it not a good fit?

• Your project is small and does not require Bazel.
• You do not need advanced build optimization or remote execution.

FAQ

Where can I find templates and examples?

Templates for workspace configuration and build files are available in the skill's supporting folders and SKILL.md.

How do I debug Bazel build issues?

The skill provides guidance on debugging build problems, including tips for inspecting build targets, rules, and remote execution logs.

Can I use this skill for non-monorepo projects?

While the skill is optimized for monorepos, some patterns may be adapted for smaller projects, but the main benefits are seen in large-scale repositories.

How do I access all resources?

Open the Files tab to view the complete file tree, including nested references, templates, and helper scripts for Bazel build optimization.