fix-ci-failures

Diagnose CI failures by inspecting logs and reproducing issues locally.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/mvillmow/ml-odyssey --skill fix-ci-failures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-ci-failures
Source: https://github.com/mvillmow/ml-odyssey/tree/main/.claude/skills/fix-ci-failures
Command: npx skills add https://github.com/mvillmow/ml-odyssey --skill fix-ci-failures

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) components.

What problem does it solve?

CI failures on PRs and workflow runs require fast diagnosis. This Skill helps you inspect checks, view logs, reproduce locally, and apply fixes to restore green CI.

Core Features & Use Cases

  • View PR checks: Inspect the status of checks for a PR.
  • View run details: Inspect failure details of a workflow run.
  • Reproduce locally: Reproduce the failure to verify fixes.
  • Apply fixes & verify: Commit changes and re-run tests to confirm success.

Quick Start

View PR checks: gh pr checks <pr-number> View a run: gh run view <run-id> --log-failed Reproduce locally: ./scripts/reproduce_ci.sh <run-id>

Frequently Asked Questions about fix-ci-failures

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose why CI tests fail when they pass locally?

CI failures often stem from environment differences, missing dependencies, or configuration mismatches. Use `gh run view <run-id> --log-failed` to inspect failure logs, then reproduce the issue locally with `./scripts/reproduce_ci.sh <run-id>` to identify and fix the root cause before rerunning CI.

How do I view and debug a failed GitHub Actions workflow run?

Inspect workflow run details with `gh run view <run-id> --log-failed` to see failure logs and error messages. Review the logs to pinpoint which step failed, then apply fixes locally and commit changes to verify the workflow passes on the next CI rerun.

Can I reproduce CI test failures on my local machine?

Yes. Use the `reproduce_ci.sh` script with the run ID to recreate the exact CI environment and failure locally. This lets you debug interactively, test fixes without waiting for CI reruns, and confirm changes work before pushing.

What's the workflow for fixing a failed PR check?

View PR checks with `gh pr checks <pr-number>`, inspect logs of failed checks, reproduce the failure locally using the run ID, apply fixes to your code, commit and push changes, then monitor the CI rerun to confirm the check passes.

Do I need GitHub CLI to debug CI failures?

Yes. The Skill uses `gh` (GitHub CLI) to fetch PR check status and workflow run logs. Install it to access `gh pr checks` and `gh run view` commands for inspecting CI failures and automating diagnosis.