| name | buildbuddy |
| description | Route public BuildBuddy troubleshooting, invocation comparison, action reproduction, log-root-cause, flaky-test, and usage-analysis requests to the focused BuildBuddy skills bundled in this plugin. |
BuildBuddy
Overview
Use this as the umbrella entrypoint for public BuildBuddy workflows. It should
classify the request quickly and route to the most specific bundled skill.
This plugin is for workflows that are safe to keep in dotfiles. Local
development, internal operations, admin impersonation, direct metrics access,
database queries, and log lookup workflows belong in the local-only
buildbuddy-dev plugin instead.
BuildBuddy also has an official MCP server. Use it opportunistically when the
requested operation is exposed by that server, but do not replace the
API-backed workflows below with MCP-only logic; the MCP surface is narrower.
Load ../../references/buildbuddy-mcp.md when the user asks how to configure
the official MCP server.
Routing
Route by user intent:
- Invocation failure, target logs, execution details, profiles, raw BES, or
cache scorecard:
../buildbuddy-invocation-troubleshoot/SKILL.md
- Two invocation URLs or IDs, cache invalidation, hermeticity, first shared AC
miss, or Action/ActionResult diffs:
../buildbuddy-invocation-compare/SKILL.md
- Replaying one remote action, modifying action args/env/exec properties, or
pinning to an executor:
../buildbuddy-action-reproduce/SKILL.md
- Recent flaky tests, Test Analytics flakes lists, target flake samples, or
recurring flaky-test triage:
../buildbuddy-flaky-tests/SKILL.md
- Pasted BuildBuddy or
bb CLI log snippets, customer symptoms, FastCDC
warnings, BES upload failures, confusing invocation IDs, or source-backed
root-cause questions without a clean invocation URL:
../buildbuddy-log-root-cause/SKILL.md
- Billing, usage, trends, heatmaps, drilldowns, cost anomalies, or projections:
../buildbuddy-usage-analysis/SKILL.md
Safety
- Check API key presence without printing the key.
- Store downloaded API responses and artifacts in a temp directory.
- Keep time windows narrow unless the user asks for a larger analysis.
- Redact credentials, impersonation headers, and private URLs before sharing
output.
