Investigate Failing Github Actions Runs With Ci Doctor

---
name: "Investigate failing GitHub Actions runs with CI Doctor"
slug: "investigate-failing-github-actions-runs-with-ci-doctor"
description: "Use GitHub Next's CI Doctor workflow to watch GitHub Actions runs, pull failure logs, trace recurring patterns, and open investigation issues with concrete next steps. This is for agents acting as CI failure investigators, not for listing GitHub Agentic Workflows as a product."
verification: "security_reviewed"
source: "https://github.com/githubnext/agentics/blob/main/docs/ci-doctor.md"
author: "GitHub Next"
publisher_type: "Open source project"
category: "CI/CD Integrations"
framework: "Multi-Framework"
---

# Investigate failing GitHub Actions runs with CI Doctor

Use GitHub Next's CI Doctor workflow to watch GitHub Actions runs, pull failure logs, trace recurring patterns, and open investigation issues with concrete next steps. This is for agents acting as CI failure investigators, not for listing GitHub Agentic Workflows as a product.

## Prerequisites

GitHub, GitHub Actions, gh, GitHub Agentic Workflows extension, AI provider token supported by gh-aw

## Installation

Use the upstream install or setup path that matches your environment:
- Make software maintenance enjoyable! From basic issue triage to Repo Assist - a powerful triage multi-task backlog burner, issue labeller, bug fixer and general repository assistant. Other workflows help gate your rep...

Basic usage or getting-started notes:
- [💰 Cost Tracker](docs/cost-tracker.md) - Post per-run agent spend summaries on pull requests using token-usage.jsonl from gh-aw's firewall
- [📝 Markdown Linter](docs/markdown-linter.md) - Run Markdown quality checks on all documentation files and get a prioritized issue report of violations
- **[Reporting](workflows/shared/reporting.md)** - Guidelines for reporting workflow run information with clickable run ID links

- Source: https://github.com/githubnext/agentics/blob/main/docs/ci-doctor.md
- Extracted from upstream docs: https://raw.githubusercontent.com/githubnext/agentics/HEAD/README.md

## Documentation

- https://raw.githubusercontent.com/githubnext/agentics/main/docs/ci-doctor.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/investigate-failing-github-actions-runs-with-ci-doctor/)