Agent skill

Diagnose CI Failures

by Terry-Mao in Terry-Mao/AICodingFlow

Diagnose a PR, branch, run, or GitHub Actions URL from CI evidence and produce a fix plan without changing code.

MITAuto-check passedDevOps & Cloud

Install Diagnose CI Failures

skills CLI
$ npx skills add Terry-Mao/AICodingFlow --skill diagnose-ci-failures -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Terry-Mao/AICodingFlow diagnose-ci-failures --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Terry-Mao/AICodingFlow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/diagnose-ci-failures .claude/skills/diagnose-ci-failures && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
diagnose-ci-failures
GitHub stars
167
Token cost
~447 tokens
SKILL.md length
207 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Diagnose a PR, branch, run, or GitHub Actions URL from CI evidence and produce a fix plan without changing code.

  • Tasks that involve Failing and flaky tests
  • SKILL.md covers Find and inspect the target and Produce the plan
  • Calls gh
  • Tasks that involve CI/CD

What it does

Diagnose CI Failures is an agent skill from Terry-Mao/AICodingFlow. Diagnose a PR, branch, run, or GitHub Actions URL from CI evidence and produce a fix plan without changing code.

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Failing and flaky tests and CI/CD. It works with GitHub Actions. The repository describes itself as: Setup a AI Coding Flow. The licence is MIT.

When your agent uses it

  • Tasks that involve Failing and flaky tests
  • Tasks that involve CI/CD

Example prompts

  • “/diagnose-ci-failures”

What it can do on your machine

Read from SKILL.md and the folder at commit 7703e16. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Diagnose CI Failures loads about 447 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 207 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~447

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Terry-Mao/AICodingFlow at commit 7703e16, republished under its MIT licence (© Terry-Mao). 207 words, ~447 tokens.

Download SKILL.mdSave it as .claude/skills/diagnose-ci-failures/SKILL.md (or your agent's skills folder).
name
diagnose-ci-failures
description
Diagnose a PR, branch, run, or GitHub Actions URL from CI evidence and produce a fix plan without changing code.

diagnose-ci-failures

Use this when the user asks to inspect failing CI. This skill is diagnosis-only: it produces a reviewable plan and does not edit, commit, push, or create PRs.

Find and inspect the target

Use the user's run URL, run ID, or branch when provided. Otherwise inspect the current branch's PR and failed checks, then fall back to recent failed runs for that branch. If no failing target exists, report that and stop.

bash
gh run view <run-id> --verbose
gh run list --branch <branch> --status failure --limit 5
gh pr view --json number,title,url,state,statusCheckRollup

For the selected PR/run, identify completed, pending, passed, and failed checks. If checks are still running, report the partial state instead of guessing. Pull failed-step logs first:

bash
gh run view <run-id> --log-failed

Inspect a specific job or download artifacts only when the failed-step output is insufficient. Extract observed paths, line numbers, error messages, failing tests, stack traces, and environment/permission failures.

Produce the plan

Group evidence into build/compile, test, lint/format, and environment/setup failures. Do not assume a language, tool, or root cause before repository files or logs establish it. Write a plan containing:

  • problem statement and affected checks;
  • current evidence and locations;
  • likely root cause grounded in the logs;
  • specific proposed changes;
  • validation steps for the follow-up implementation.

Prefer CI evidence over local guesses. Treat multiple unrelated failures as separate categories and recommend resolving them one category at a time.

© Terry-Mao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/diagnose-ci-failures of Terry-Mao/AICodingFlow.

Open the folder on GitHubat commit 7703e16

Compare with similar skills

Diagnose CI Failures next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Diagnose CI Failures compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Diagnose CI Failures this skillTerry-Mao/AICodingFlow167—~447Automated safety check: PassMIT
CI Failure Triage and RepairChachamaru127/claude-code-harness3.2k1 repos~1.1kAutomated safety check: NotesMIT
CI Watchdoglatitude-dev/latitude-llm4.7k—~1.6kAutomated safety check: PassMIT
Megatron-LM CI Failure TriageNVIDIA/Megatron-LM18k—~1.6kAutomated safety check: PassApache-2.0
CI Triagefair-acc/gnuradio4115—~548Automated safety check: PassLGPL-3.0
CI Failure Triagen1m21n/Infinite272—~1.5kAutomated safety check: PassCustom licence

Similar skills

  • CI Failure Triage and Repair

    Chachamaru127/claude-code-harness

    Diagnoses failing CI pipelines and tests, deciding first whether the test or the implementation is at fault, and hands hard cases to a dedicated fixer subagent.

    3.2k GitHub starsUsed in 1 repo~1.1k tokens
    DevOps & CloudAuto-check: notes
  • CI Watchdog

    latitude-dev/latitude-llm

    Continuously monitor GitHub PR CI checks and automatically fix failures until all checks pass.

    4.7k GitHub stars~1.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Official

    Investigates a failing GitHub Actions run or job for Megatron-LM, finds the root cause plus the PR and test author involved, and files a structured bug issue.

    18k GitHub stars~1.6k tokensUpdated today
    DevOps & CloudAuto-check passed
  • CI Triage

    fair-acc/gnuradio4

    Fetch and classify a failed GitHub Actions job for this repo — distinguish out-of-memory kills, six-hour timeouts, configure errors and genuine test failures, and identify what was in flight.

    115 GitHub stars~548 tokensUpdated today
    DevOps & CloudAuto-check passed
  • CI Failure Triage

    n1m21n/Infinite

    Diagnose a failed GitHub Actions run (Windows MSVC crash, Linux clang/sanitizer, link errors) from the logs in one pass, and fix every candidate at once instead of one CI round-trip at a time.

    272 GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • CI Debugging

    citypaul/.dotfiles

    Systematic CI/CD failure diagnosis using hypothesis-first investigation, local reproduction, and environment delta analysis.

    740 GitHub stars~1.5k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes

More from Terry-Mao/AICodingFlow

All 30 skills in this repo
  • PR Walkthrough

    Terry-Mao/AICodingFlow

    Generate a local static interactive D3 walkthrough of a pull request.

    167 GitHub stars~2.1k tokensUpdated 7 days ago
    Auto-check passed
  • Update PR Review

    Terry-Mao/AICodingFlow

    Improve repo-local PR review companion skills from human feedback on bot reviews.

    167 GitHub stars~1.1k tokensUpdated 7 days ago
    Auto-check passed
  • Implement Issue

    Terry-Mao/AICodingFlow

    Implement a GitHub issue in this repository by applying the local shared implement-specs workflow with repository-specific issue, spec-context, and summary-file handling.

    167 GitHub stars~2.3k tokensUpdated 7 days ago
    Auto-check passed
  • Implement Specs

    Terry-Mao/AICodingFlow

    Implement an approved feature from the repository's product and tech specs, keeping specs and code aligned in the same change as implementation evolves.

    167 GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • Review PR

    Terry-Mao/AICodingFlow

    Review a GitHub pull request from pinned prdescription.txt, prdiff.txt, and optional speccontext.md snapshots, then write and validate review.json.

    167 GitHub stars~1k tokensUpdated 7 days ago
    Auto-check passed
  • Update Dedupe

    Terry-Mao/AICodingFlow

    Learn repo-local duplicate issue guidance from recent maintainer duplicate closures and propose updates to the dedupe companion skill.

    167 GitHub stars~1.1k tokensUpdated 7 days ago
    Auto-check passed

Works with

Questions about Diagnose CI Failures

What does Diagnose CI Failures do?

Diagnose a PR, branch, run, or GitHub Actions URL from CI evidence and produce a fix plan without changing code. Diagnose CI Failures is an agent skill from Terry-Mao/AICodingFlow. Diagnose a PR, branch, run, or GitHub Actions URL from CI evidence and produce a fix plan without changing code.

When should I use Diagnose CI Failures?

Diagnose CI Failures fits situations like: tasks that involve Failing and flaky tests; tasks that involve CI/CD.

How do I install Diagnose CI Failures in Claude Code?

Run `npx skills add Terry-Mao/AICodingFlow --skill diagnose-ci-failures -a claude-code`. Or copy the skill folder (.agents/skills/diagnose-ci-failures in Terry-Mao/AICodingFlow) into .claude/skills/diagnose-ci-failures in your project. Claude Code loads it when a task matches its description.

How do I install Diagnose CI Failures in Codex?

Run `npx skills add Terry-Mao/AICodingFlow --skill diagnose-ci-failures -a codex`. Or copy the skill folder (.agents/skills/diagnose-ci-failures in Terry-Mao/AICodingFlow) into .agents/skills/diagnose-ci-failures in your project. Codex loads it when a task matches its description.

Can I use Diagnose CI Failures in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Terry-Mao/AICodingFlow --skill diagnose-ci-failures -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/diagnose-ci-failures, .gemini/skills/diagnose-ci-failures, .github/skills/diagnose-ci-failures and .opencode/skills/diagnose-ci-failures in your project.

What does Diagnose CI Failures need to run?

Going by SKILL.md and its folder, Diagnose CI Failures needs the command-line tools its instructions call (gh).

Does Diagnose CI Failures access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Diagnose CI Failures safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Diagnose CI Failures use?

Diagnose CI Failures is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Diagnose CI Failures use?

About 447 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Diagnose CI Failures?

Skills that share tags, products or a category with Diagnose CI Failures: CI Failure Triage and Repair (Chachamaru127/claude-code-harness, 3.2k stars), CI Watchdog (latitude-dev/latitude-llm, 4.7k stars), Megatron-LM CI Failure Triage (NVIDIA/Megatron-LM, 18k stars) and CI Triage (fair-acc/gnuradio4, 115 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Diagnose CI Failures?

Terry-Mao (a GitHub user) maintains it in Terry-Mao/AICodingFlow, which has 167 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 3, 2026.

Source: Terry-Mao/AICodingFlow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.