Diagnose and fix CI/CD failures by analyzing logs, reproducing locally, and applying fixes. Use when CI checks fail on pull requests.
name: fix-ci-failures
description: Diagnose and fix CI/CD failures by analyzing logs, reproducing locally, and applying fixes. Use when CI checks fail on pull requests.
mcp_fallback: none
category: ci
Fix CI Failures Skill
Diagnose and fix CI failures systematically.
When to Use
CI checks fail on PR
Workflow runs fail
Tests pass locally but fail in CI
Need to debug CI issues
Quick Reference
# View PR checks
gh pr checks <pr-number>
# View specific run details
gh run view <run-id> --log-failed
# Reproduce locally
./scripts/reproduce_ci.sh <run-id>
Workflow
Check status - View failed PR checks
Get logs - Download or view failure details
Reproduce - Run same commands locally
Fix issue - Apply necessary changes
Verify - Test passes locally
Push - Commit and push fix
Monitor - Check CI passes
Common Failures
Failure
Command
Fix
Trailing whitespace
just pre-commit-all
Stage and re-commit
Test failure
pixi run mojo test tests/
Fix code, re-run tests
Markdown lint
npx markdownlint-cli2 --fix "**/*.md"
Commit fixes
Build error
Check imports/deps
Update and rebuild
Diagnosis Workflow
# 1. View CI status
gh pr checks 123
# 2. Get failure details
gh run view <run-id> --log-failed
# 3. Download logs for analysis
gh run download <run-id>
# 4. Reproduce issue locally
./scripts/reproduce_ci.sh <run-id>
# 5. Fix the issue
# ... make changes ...
# 6. Verify locally
./scripts/run_ci_locally.sh
# 7. Push fix
git add .
git commit -m "fix: address CI failure"
git push
# 8. Monitor CI
gh pr checks 123 --watch