debug-ci-failures

Inspect CircleCI pipeline statuses, failure logs, and flaky test results.

84|40|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/CircleCI-Public/chunk-cli --skill debug-ci-failures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-ci-failures
Source: https://github.com/CircleCI-Public/chunk-cli/tree/main/skills/debug-ci-failures
Command: npx skills add https://github.com/CircleCI-Public/chunk-cli --skill debug-ci-failures

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly understand why a CircleCI pipeline failed, determine whether tests are flaky, and pinpoint the most likely causes so you can get back to green builds without guesswork.

Core Features & Use Cases

  • Pipeline triage: Checks the latest pipeline status to confirm failing workflows and jobs before pulling heavy logs.
  • Failure log and test analysis: Retrieves build failure logs and, when applicable, fetches focused failed test results with stack traces and durations.
  • Flakiness detection and remediation path: Flags likely flaky tests and suggests next steps, including rerunning workflows from the failed job.

Quick Start

Ask the AI to debug your failing CircleCI pipeline by saying: "Debug CI failures for my latest CircleCI build and tell me what broke and whether any tests look flaky."

Frequently Asked Questions about debug-ci-failures

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

FAQPage Schema
How do I debug CircleCI pipeline failures and find broken jobs?

Debug CircleCI pipeline failures by checking the latest pipeline status to identify failing workflows and jobs, then retrieve build failure logs to pinpoint the specific errors. This triage approach reduces time-to-resolution by inspecting statuses before pulling heavy logs.

How do I find flaky tests in my CircleCI build after a code change?

Find flaky tests in your CircleCI build by using flaky test discovery tools that flag intermittent failures across pipeline runs. The skill identifies likely flaky tests and suggests remediation steps, including rerunning workflows from the failed job.

Can I extract failed test results with stack traces from CircleCI logs?

You can extract failed test results from CircleCI by fetching focused failed test outputs that include stack traces and durations. This applies to scenarios where you need to inspect specific job errors or broken workflows after code changes.

How do I rerun a CircleCI workflow from a failed job?

Rerun a CircleCI workflow from the failed job after diagnosing the root cause of the failure. The skill identifies failing pipelines, analyzes failure logs and test results, then suggests rerunning the workflow from the specific failed job as a remediation path.

Does CircleCI debugging work with my git branch or do I need a project URL?

CircleCI debugging supports project identification via git remote or branch names, as well as user-provided CircleCI URLs. This allows the debugging process to locate your pipeline status, failure logs, and test results regardless of how you reference the project.

Why is my CircleCI build failing and how do I get back to green builds?

Your CircleCI build may be failing due to broken workflows, specific job errors, or flaky test behavior after code changes. Diagnose the cause by inspecting pipeline statuses, logs, and test results to determine whether tests are flaky and get back to green builds.