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.
Debug GitHub Actions build failures by fetching and analyzing workflow logs.
Install Gh Debug
$ npx skills add FastLED/FastLED --skill gh-debug -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install FastLED/FastLED gh-debug --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/FastLED/FastLED.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/gh-debug .claude/skills/gh-debug && rm -rf skills-srcUse ~/.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/
Install the "gh-debug" agent skill from https://github.com/FastLED/FastLED/tree/master/.claude/skills/gh-debug into .claude/skills/gh-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gh-debug", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/FastLED/FastLED/tree/master/.claude/skills/gh-debugType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add FastLED/FastLED --skill gh-debug -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install FastLED/FastLED gh-debug --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FastLED/FastLED.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/gh-debug .agents/skills/gh-debug && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gh-debug" agent skill from https://github.com/FastLED/FastLED/tree/master/.claude/skills/gh-debug into .agents/skills/gh-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gh-debug", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add FastLED/FastLED --skill gh-debug -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install FastLED/FastLED gh-debug --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FastLED/FastLED.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/gh-debug .cursor/skills/gh-debug && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gh-debug" agent skill from https://github.com/FastLED/FastLED/tree/master/.claude/skills/gh-debug into .cursor/skills/gh-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gh-debug", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/FastLED/FastLED.git --path .claude/skills/gh-debug--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add FastLED/FastLED --skill gh-debug -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install FastLED/FastLED gh-debug --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FastLED/FastLED.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/gh-debug .gemini/skills/gh-debug && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gh-debug" agent skill from https://github.com/FastLED/FastLED/tree/master/.claude/skills/gh-debug into .gemini/skills/gh-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gh-debug", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install FastLED/FastLED gh-debugInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add FastLED/FastLED --skill gh-debug -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/FastLED/FastLED.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/gh-debug .github/skills/gh-debug && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gh-debug" agent skill from https://github.com/FastLED/FastLED/tree/master/.claude/skills/gh-debug into .github/skills/gh-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gh-debug", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add FastLED/FastLED --skill gh-debug -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install FastLED/FastLED gh-debug --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FastLED/FastLED.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/gh-debug .opencode/skills/gh-debug && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gh-debug" agent skill from https://github.com/FastLED/FastLED/tree/master/.claude/skills/gh-debug into .opencode/skills/gh-debug/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gh-debug", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
gh-debug- GitHub stars
- 7.5k
- Token cost
- ~427 tokens
- SKILL.md length
- 202 words
- Files
- 1
- Skills in repo
- 23
- Repo updated
- First seen
- Licence
- MIT
At a glance
Debug GitHub Actions build failures by fetching and analyzing workflow logs.
- Works in 4 steps: Identify failed jobs/steps using gh run… → For each failed step, use targeted log… → Parse logs for: compilation errors, test… → …
- CI/CD pipelines fail and you need to identify the root cause
- SKILL.md covers Smart Log Fetching Strategy, Input Handling and Output Format
- Calls gh and uv
What it does
Gh Debug is an agent skill from FastLED/FastLED. Debug GitHub Actions build failures by fetching and analyzing workflow logs. Use when CI/CD pipelines fail and you need to identify the root cause.
Its SKILL.md is about 430 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 CI/CD and Root cause analysis. It works with GitHub Actions. The repository describes itself as: The FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r We'd like to use github… The licence is MIT.
When your agent uses it
- CI/CD pipelines fail and you need to identify the root cause
- Tasks that involve CI/CD
- Tasks that involve Root cause analysis
Example prompts
- “/gh-debug”
Requirements
- Python 3
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Identify failed jobs/steps using gh run view --log-failed
- For each failed step, use targeted log extraction with grep filters
- Parse logs for: compilation errors, test failures, runtime issues
- Extract error context: ~10 lines before and after each error
What it can do on your machine
Read from SKILL.md and the folder at commit ce225ed. 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:
ghuv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gh and uv, 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
Gh Debug loads about 427 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 202 words of instructions outside code blocks.
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 FastLED/FastLED at commit ce225ed, republished under its MIT licence (© FastLED). 202 words, ~427 tokens.
Download SKILL.mdSave it as
.claude/skills/gh-debug/SKILL.md (or your agent's skills folder).- name
- gh-debug
- description
- Debug GitHub Actions build failures by fetching and analyzing workflow logs. Use when CI/CD pipelines fail and you need to identify the root cause.
- argument-hint
- run-id or workflow-url
- context
- fork
Pull GitHub Actions logs for a workflow run, parse them to identify errors, and provide a clear diagnostic report.
Arguments: $ARGUMENTS
Primary Method (Recommended): Use the Python script for efficient log analysis:
uv run ci/tools/gh_debug.py $ARGUMENTSThis script:
- Tries build-summary artifacts first (small, focused files uploaded by CI — much faster)
- Falls back to streaming full logs if no summary artifact is available
- Filters for errors in real-time
- Stops after finding 10 errors (configurable with --max-errors)
- Shows context around each error (5 lines before/after, configurable with --context)
Fallback Method: If the Python script fails, use manual analysis:
Smart Log Fetching Strategy
- Identify failed jobs/steps using
gh run view <run-id> --log-failed - For each failed step, use targeted log extraction with grep filters
- Parse logs for: compilation errors, test failures, runtime issues
- Extract error context: ~10 lines before and after each error
Input Handling
Handle:
- Run IDs (e.g., "18391541037")
- Workflow URLs
- Most recent failed run if no argument provided (use
gh run list --status failure --limit 1)
Output Format
Provide:
- Workflow name and run number
- Job(s) that failed with step names
- Specific error messages with surrounding context (max ~50 lines per error)
- File paths and line numbers where applicable
- Suggested next steps or potential fixes
© FastLED, 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 .claude/skills/gh-debug of FastLED/FastLED.
Open the folder on GitHubat commit ce225ed
Compare with similar skills
Gh Debug 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gh Debug this skillFastLED/FastLED | 7.5k | — | ~427 | Automated safety check: Pass | MIT | |
| CI Failure Triage and RepairChachamaru127/claude-code-harness | 3.2k | 1 repos | ~1.1k | Automated safety check: Notes | MIT | |
| Megatron-LM CI Failure TriageNVIDIA/Megatron-LM | 18k | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| GitHub Actions Failure Analysisykdojo/claude-code-tips | 10k | — | ~639 | Automated safety check: Pass | Custom licence | |
| Spend Watchaeonfun/aeon | 767 | — | ~6.3k | Automated safety check: Pass | MIT | |
| gh-aw Workflow Diagnosisgithub/gh-aw | 5.4k | — | ~4k | Automated safety check: Pass | MIT |
Similar skills
- Official
Megatron-LM CI Failure Triage
NVIDIA/Megatron-LM
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.
GitHub Actions Failure Analysis
ykdojo/claude-code-tips
Investigates a failed GitHub Actions run from its URL: pinpoints the real failure, checks the job's history for flakiness, and finds the breaking commit and any existing fix PR.
Spend Watch
aeonfun/aeon
Autonomous cloud-cost analyst across Neon, Vercel, Railway and GitHub Actions - pulls per-object usage, attributes it to the biggest drivers, root-causes each, and emits recommendations ranked by…
- Official
gh-aw Workflow Diagnosis
github/gh-aw
Guides your agent through diagnosing failed GitHub Agentic Workflows by downloading run logs, auditing individual runs and reading the artifacts they leave behind.
GreptimeDB Fuzz CI Failure Investigation
GreptimeTeam/greptimedb
Diagnoses a failed GreptimeDB fuzz CI job by pulling its GitHub Actions logs and fuzz artifacts, then matching the evidence to the local source code.
More from FastLED/FastLED
All 23 skills in this repoCI Fix
FastLED/FastLED
Scan all CI builds and tests, find failures, fetch error logs, and fix the code.
Driver Review
FastLED/FastLED
Review and implement hardware driver code — DMA safety, interrupt correctness, timing constraints, peripheral register usage, channel drivers, and peripheral mock implementations.
Embedded Debug
FastLED/FastLED
Firmware crash analysis, stack trace decoder, and register dump interpreter for ESP32/ARM/AVR platforms.
Esp32 Log Triage
FastLED/FastLED
Parse and classify ESP32 serial log output to identify FastLED-related errors, RMT/I2S/SPI driver faults, timing violations, RTOS issues, and crash signatures.
Memory Audit
FastLED/FastLED
Audit embedded code for stack overflow risks, heap fragmentation, static allocation patterns, and memory leaks.
Platform Port
FastLED/FastLED
Guide porting FastLED to new MCU platforms, including int.h types, clockless drivers, SPI implementations, and platform detection.
Related
Works with
Categories
Questions about Gh Debug
What does Gh Debug do?
Debug GitHub Actions build failures by fetching and analyzing workflow logs. Gh Debug is an agent skill from FastLED/FastLED. Debug GitHub Actions build failures by fetching and analyzing workflow logs.
When should I use Gh Debug?
Gh Debug fits situations like: CI/CD pipelines fail and you need to identify the root cause; tasks that involve CI/CD; tasks that involve Root cause analysis.
How do I install Gh Debug in Claude Code?
Run `npx skills add FastLED/FastLED --skill gh-debug -a claude-code`. Or copy the skill folder (.claude/skills/gh-debug in FastLED/FastLED) into .claude/skills/gh-debug in your project. Claude Code loads it when a task matches its description.
How do I install Gh Debug in Codex?
Run `npx skills add FastLED/FastLED --skill gh-debug -a codex`. Or copy the skill folder (.claude/skills/gh-debug in FastLED/FastLED) into .agents/skills/gh-debug in your project. Codex loads it when a task matches its description.
Can I use Gh Debug 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 FastLED/FastLED --skill gh-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gh-debug, .gemini/skills/gh-debug, .github/skills/gh-debug and .opencode/skills/gh-debug in your project.
What does Gh Debug need to run?
Going by SKILL.md and its folder, Gh Debug needs the command-line tools its instructions call (gh and uv). Our summary lists: Python 3.
Does Gh Debug access the network?
SKILL.md contains no URLs. Its commands use gh and uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Gh Debug 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 Gh Debug use?
Gh Debug 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 Gh Debug use?
About 427 tokens (SKILL.md is roughly 1.7k 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 Gh Debug?
Skills that share tags, products or a category with Gh Debug: CI Failure Triage and Repair (Chachamaru127/claude-code-harness, 3.2k stars), Megatron-LM CI Failure Triage (NVIDIA/Megatron-LM, 18k stars), GitHub Actions Failure Analysis (ykdojo/claude-code-tips, 10k stars) and Spend Watch (aeonfun/aeon, 767 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Gh Debug?
FastLED (a GitHub organization) maintains it in FastLED/FastLED, which has 7,505 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 8, 2026.
Source: FastLED/FastLED on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.