ci-review

Diagnoses GitHub Actions CI run failures by inspecting job logs and identifying root causes.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/bismuthdigital/claude-project-template --skill ci-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ci-review
Source: https://github.com/bismuthdigital/claude-project-template/tree/main/.claude/skills/ci-review
Command: npx skills add https://github.com/bismuthdigital/claude-project-template --skill ci-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you quickly understand why a Continuous Integration (CI) run failed, pinpoint the exact cause, and get actionable steps to fix it, saving valuable debugging time.

Core Features & Use Cases

  • CI Run Inspection: Analyzes GitHub Actions workflow runs, including job statuses and logs.
  • Failure Diagnosis: Identifies the root cause of test, lint, build, or infrastructure failures.
  • Remediation Suggestions: Provides specific file paths and code changes needed for fixes.
  • Use Case: A pull request failed its CI checks. Use this Skill to automatically inspect the run, identify the failing test, and get a clear explanation of the error and where to fix it in the code.

Quick Start

Use the ci-review skill to diagnose the latest CI run on the current branch.

Frequently Asked Questions about ci-review

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

FAQPage Schema
How do I diagnose GitHub Actions CI failures from job logs?

Diagnosing GitHub Actions CI failures involves inspecting job logs to identify root causes like test failures or linting issues. This skill analyzes workflow runs and provides specific file paths and remediation steps to fix the errors.

Why did my GitHub Actions CI run fail and how do I fix it?

GitHub Actions CI runs fail due to test errors, linting issues, type errors, or infrastructure problems. This skill inspects the failed run logs to pinpoint the exact cause and provides actionable code changes needed for remediation.

Do I need the gh CLI to troubleshoot GitHub Actions workflow runs?

Yes, troubleshooting GitHub Actions workflow runs with this skill requires the gh CLI to interact with GitHub Actions. Understanding the workflow YAML is also necessary to provide proper context for the failure diagnosis.

What's the best way to find the root cause of a CI test failure?

Finding the root cause of a CI test failure is best done by inspecting the specific job logs. This skill automatically analyzes the GitHub Actions run to identify the failing test and explain where the fix is needed in the code.

Can I automatically inspect a failed pull request CI check?

Yes, you can automatically inspect a failed pull request CI check. This skill diagnoses the latest run on the current branch, identifies the failing component, and outputs clear remediation steps to fix the code.

What types of CI failures can be diagnosed from GitHub Actions logs?

CI failures that can be diagnosed from GitHub Actions logs include test failures, linting issues, type errors, and infrastructure problems. The diagnosis provides specific remediation steps for each identified root cause.