# Analyze CI Failure

> Download and analyze a CI failure log to construct an actionable suggested fix plan and report back

- Skill: `bazelbuild/analyze-ci-failure` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bazelbuild/analyze-ci-failure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bazelbuild/analyze-ci-failure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: bazelbuild (https://skillmd.com/u/bazelbuild)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/bazelbuild/analyze-ci-failure

---


When a CI monitoring workflow alerts you to a failed Buildkite job or GitHub
check, invoke this skill by running:
```bash
./.agents/skills/analyze-ci-failure/scripts/analyze_ci_failure.py \
  "<job_name>" "<build_id_or_log_url>" "<job_id>" "<your_conversation_id>"
```

### ✨ What this Skill Does
1. **Resolves Log**: Automatically resolves the Buildkite job download URL or
   fetches GitHub Actions logs via `gh` CLI.
2. **Downloads & Ingests**: Fetches the full raw CI log file and saves it
   locally to `.agents/skills/analyze-ci-failure/scratch/`.
3. **Smart Error Extraction**: Scans log lines for critical failure signatures
   (`Traceback`, `ERROR:`, `FAILED:`, missing packages, compiler aborts, linter
   errors).
4. **Fix Plan Synthesis**: Constructs a beautifully structured Markdown
   suggested plan on how to resolve the root cause.
5. **Natively Notifies**: Dispatches a high-priority summary notification
   message back to your active agent conversation via `agentapi send-message`.