Agent skill

CI Fix

by warpdotdev in warpdotdev/oz-skills

Diagnose and fix GitHub Actions CI failures. An agent skill from warpdotdev/oz-skills.

MITAuto-check passedDevelopment

Install CI Fix

skills CLI
$ npx skills add warpdotdev/oz-skills --skill ci-fix -a claude-code

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

GitHub CLI
$ gh skill install warpdotdev/oz-skills ci-fix --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/warpdotdev/oz-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ci-fix .claude/skills/ci-fix && 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
ci-fix
GitHub stars
825
Token cost
~790 tokens
SKILL.md length
273 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and fix GitHub Actions CI failures. An agent skill from warpdotdev/oz-skills.

  • Works in 6 steps: Locate the Failing Run → Extract Failure Logs → Identify Root Cause → …
  • Needs diagnosis
  • SKILL.md covers Prerequisites, Workflow, Safety Notes and Deliverable
  • Calls gh and git

What it does

CI Fix is an agent skill from warpdotdev/oz-skills. Diagnose and fix GitHub Actions CI failures. Inspects workflow runs and logs, identifies root causes, implements minimal fixes, and pushes to a fix branch. Use when CI is failing, red, broken, or needs diagnosis.

Its SKILL.md is about 790 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 Development, covering Failing and flaky tests, Root cause analysis and CI/CD. It works with GitHub Actions. The licence is MIT.

When your agent uses it

  • Needs diagnosis
  • Tasks that involve Failing and flaky tests
  • Tasks that involve Root cause analysis

Example prompts

  • “/ci-fix”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Locate the Failing Run
  2. Extract Failure Logs
  3. Identify Root Cause
  4. Implement the Fix
  5. Push to Fix Branch
  6. Verify the Fix

What it can do on your machine

Read from SKILL.md and the folder at commit 6c08c49. 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
    • git

    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 git, 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

CI Fix loads about 790 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 273 words of instructions outside code blocks.

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

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 warpdotdev/oz-skills at commit 6c08c49, republished under its MIT licence (© warpdotdev). 273 words, ~790 tokens.

Download SKILL.mdSave it as .claude/skills/ci-fix/SKILL.md (or your agent's skills folder).
name
ci-fix
description
Diagnose and fix GitHub Actions CI failures. Inspects workflow runs and logs, identifies root causes, implements minimal fixes, and pushes to a fix branch. Use when CI is failing, red, broken, or needs diagnosis.
license
MIT

CI Fix

Diagnose CI failures and implement fixes with minimal, targeted diffs. Pushes fixes to a dedicated branch without creating PRs.

Prerequisites

Verify GitHub CLI authentication before proceeding:

bash
gh auth status

If not authenticated, instruct the user to run gh auth login first.

Workflow

1. Locate the Failing Run

Determine the failing workflow run. If working on a PR branch:

bash
gh pr view --json statusCheckRollup --jq '.statusCheckRollup[] | select(.conclusion == "FAILURE")'

If working from a branch or run ID:

bash
gh run list --branch <branch> --status failure --limit 5
gh run view <run-id> --verbose
2. Extract Failure Logs

Pull logs from failed steps to identify the root cause:

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

For deeper inspection:

bash
gh run view <run-id> --log --job <job-id>
gh run download <run-id> -D .artifacts/<run-id>
3. Identify Root Cause

Analyze logs for common failure patterns:

  • Build/compilation errors: Missing dependencies, type errors, syntax issues
  • Test failures: Assertion failures, timeouts, flaky tests
  • Linting/formatting: Style violations, unused imports
  • Environment issues: Missing secrets, permissions, resource limits

Prefer the smallest fix that resolves the issue. Deterministic code fixes are better than workflow plumbing changes.

4. Implement the Fix

Make minimal, scoped changes matching the repository's existing style:

  • Fix only what's broken—avoid unrelated refactoring
  • Keep changes to the failing job/step when possible
  • If modifying workflow files, preserve existing permissions and avoid expanding token access
5. Push to Fix Branch

Create or update a dedicated fix branch:

bash
git checkout -b ci-fix/<original-branch>
git add -A
git commit -m "fix: resolve CI failure in <job-name>

Co-Authored-By: Warp <agent@warp.dev>"
git push -u origin ci-fix/<original-branch>

If the fix branch already exists, update it:

bash
git checkout ci-fix/<original-branch>
git pull origin <original-branch>
# make fixes
git commit -m "fix: <description>

Co-Authored-By: Warp <agent@warp.dev>"
git push
6. Verify the Fix

Trigger CI on the fix branch and monitor:

bash
gh run list --branch ci-fix/<original-branch> --limit 1
gh run watch <new-run-id> --exit-status

To rerun only failed jobs:

bash
gh run rerun <run-id> --failed

Safety Notes

  • Avoid pull_request_target unless explicitly requested—it can expose secrets to untrusted code
  • Keep workflow permissions: minimal; don't broaden access to make tests pass
  • For flaky tests, prefer deterministic fixes over blind reruns

Deliverable

After fixing, provide a brief summary:

  • Failing run: Link or ID
  • Root cause: What broke and why
  • Fix: What changed
  • Verification: New run link showing green status

© warpdotdev, 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/ci-fix of warpdotdev/oz-skills.

Open the folder on GitHubat commit 6c08c49

Compare with similar skills

CI Fix 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.

CI Fix compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
CI Fix this skillwarpdotdev/oz-skills825—~790Automated safety check: PassMIT
CI Failure Triage and RepairChachamaru127/claude-code-harness3.2k1 repos~1.1kAutomated safety check: NotesMIT
GreptimeDB Fuzz CI Failure InvestigationGreptimeTeam/greptimedb6.7k—~4.4kAutomated safety check: PassApache-2.0
Megatron-LM CI Failure TriageNVIDIA/Megatron-LM18k—~1.6kAutomated safety check: PassApache-2.0
CI Triagecanton-network/splice118—~1.4kAutomated safety check: PassApache-2.0
Analyze Test Runmicrosoft/GitHub-Copilot-for-Azure255—~2.5kAutomated safety check: PassMIT

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
  • 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.

    6.7k GitHub stars~4.4k tokensUpdated 3 days ago
    Testing & QAAuto-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 yesterday
    DevOps & CloudAuto-check passed
  • CI Triage

    canton-network/splice

    Triage a failed splice GitHub Actions job (cn-test-failures ref) into a reproducible evidence packet - fetch job log and artifact, isolate the flagged lines, check the known flake families for…

    118 GitHub stars~1.4k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Analyze Test Run

    microsoft/GitHub-Copilot-for-Azure

    Official

    Analyze a GitHub Actions integration test run and produce a skill invocation report with failure root-cause issues.

    255 GitHub stars~2.5k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Fix CI

    ccusage/ccusage

    Diagnoses and fixes failing GitHub Actions checks with gh. An agent skill from ccusage/ccusage.

    19k GitHub stars~487 tokensUpdated today
    DevelopmentAuto-check passed

More from warpdotdev/oz-skills

All 13 skills in this repo
  • SEO Aeo Audit

    warpdotdev/oz-skills

    Optimize for search engine visibility, ranking, and AI citations.

    825 GitHub stars~4.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Web Accessibility Audit

    warpdotdev/oz-skills

    Audit web applications for WCAG accessibility compliance. An agent skill from warpdotdev/oz-skills.

    825 GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Webapp Testing

    warpdotdev/oz-skills

    Test local web applications with Playwright. An agent skill from warpdotdev/oz-skills.

    825 GitHub stars~914 tokensUpdated 1 mo ago
    Auto-check passed
  • GitHub Bug Report Triage

    warpdotdev/oz-skills

    Triage GitHub bug reports for actionability. An agent skill from warpdotdev/oz-skills.

    825 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Analysis Artifacts

    warpdotdev/oz-skills

    Generate reproducible analysis artifacts — SQL queries, Python visualizations, and summary tables — as you work through a BigQuery data analysis.

    825 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Create Pull Request

    warpdotdev/oz-skills

    Create a GitHub pull request following project conventions. An agent skill from warpdotdev/oz-skills.

    825 GitHub stars~2.6k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about CI Fix

What does CI Fix do?

Diagnose and fix GitHub Actions CI failures. An agent skill from warpdotdev/oz-skills. CI Fix is an agent skill from warpdotdev/oz-skills. Diagnose and fix GitHub Actions CI failures.

When should I use CI Fix?

CI Fix fits situations like: needs diagnosis; tasks that involve Failing and flaky tests; tasks that involve Root cause analysis.

How do I install CI Fix in Claude Code?

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

How do I install CI Fix in Codex?

Run `npx skills add warpdotdev/oz-skills --skill ci-fix -a codex`. Or copy the skill folder (.agents/skills/ci-fix in warpdotdev/oz-skills) into .agents/skills/ci-fix in your project. Codex loads it when a task matches its description.

Can I use CI Fix 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 warpdotdev/oz-skills --skill ci-fix -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ci-fix, .gemini/skills/ci-fix, .github/skills/ci-fix and .opencode/skills/ci-fix in your project.

What does CI Fix need to run?

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

Does CI Fix access the network?

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

Is CI Fix 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 CI Fix use?

CI Fix is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does CI Fix use?

About 790 tokens (SKILL.md is roughly 3.2k 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 CI Fix?

Skills that share tags, products or a category with CI Fix: CI Failure Triage and Repair (Chachamaru127/claude-code-harness, 3.2k stars), GreptimeDB Fuzz CI Failure Investigation (GreptimeTeam/greptimedb, 6.7k stars), Megatron-LM CI Failure Triage (NVIDIA/Megatron-LM, 18k stars) and CI Triage (canton-network/splice, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains CI Fix?

warpdotdev (a GitHub organization) maintains it in warpdotdev/oz-skills, which has 825 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on August 15, 2026.

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