Agent skill

GitHub Actions Run And Fix

by openteams-lab in openteams-lab/openteams

OpenTeams skill for manually starting a GitHub Actions workflow, watching its execution, diagnosing failures, rerunning transient failed jobs, repairing code or configuration errors, and dispatching…

Apache-2.0Auto-check passedDevOps & Cloud

Install GitHub Actions Run And Fix

skills CLI
$ npx skills add openteams-lab/openteams --skill github-actions-run-and-fix -a claude-code

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

GitHub CLI
$ gh skill install openteams-lab/openteams github-actions-run-and-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/openteams-lab/openteams.git skills-src && mkdir -p .claude/skills && cp -r skills-src/assets/skills/github-actions-run-and-fix .claude/skills/github-actions-run-and-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
github-actions-run-and-fix
GitHub stars
629
Token cost
~923 tokens
SKILL.md length
437 words
Files
2 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

OpenTeams skill for manually starting a GitHub Actions workflow, watching its execution, diagnosing failures, rerunning transient failed jobs, repairing code or configuration errors, and dispatching…

  • Works in 8 steps: Confirm the repository, workflow name or… → Start and watch a workflow with the… → To inspect an existing run, use bash… → …
  • Tasks that involve CI/CD
  • SKILL.md covers OpenTeams context, Required tool, Workflow and Safety boundaries
  • Runs Shell scripts from its folder; calls gh, bash and brew; reaches github.com

What it does

GitHub Actions Run And Fix is an agent skill from openteams-lab/openteams. OpenTeams skill for manually starting a GitHub Actions workflow, watching its execution, diagnosing failures, rerunning transient failed jobs, repairing code or configuration errors, and dispatching the workflow again until it passes or the retry limit is reached.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/workflow-run.sh`).

It sits in DevOps & Cloud, covering CI/CD. It works with GitHub Actions and GitHub. The repository describes itself as: Plan, Build, and Ship — with a team of AI agents instead of one. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve CI/CD

Example prompts

  • “Use the github-actions-run-and-fix skill to openteam skill for manually starting a GitHub Actions workflow, watching its execution, diagnosing…”
  • “/github-actions-run-and-fix”

Requirements

  • A Bash shell

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the repository, workflow name or file, git ref, workflow inputs, and target environment. If any deployment target or input is…
  2. Start and watch a workflow with the bundled script from this skill directory
  3. To inspect an existing run, use bash scripts/workflow-run.sh --run-id . For a clearly transient failure, use --run-id --rerun-failed once.
  4. When a run fails, read the summary and failed-step logs emitted by the script. Inspect the relevant workflow and reproduce the failing…
  5. Classify the failure
  6. Review the diff, commit only related files, and push normally. Never force-push. Dispatch again only when a push does not already trigger…
  7. Repeat for at most three repair iterations, including at most one no-change rerun for the same failure signature.
  8. Report the workflow, run URLs, root cause, reruns, files changed, local verification, pushed commit, and final conclusion.

What it can do on your machine

Read from SKILL.md and the folder at commit ebee9de. 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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • bash
    • brew
    • winget

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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

GitHub Actions Run And Fix loads about 923 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 437 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from openteams-lab/openteams at commit ebee9de, republished under its Apache-2.0 licence (© openteams-lab). 437 words, ~923 tokens.

Download SKILL.mdSave it as .claude/skills/github-actions-run-and-fix/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
github-actions-run-and-fix
description
OpenTeams skill for manually starting a GitHub Actions workflow, watching its execution, diagnosing failures, rerunning transient failed jobs, repairing code or configuration errors, and dispatching the workflow again until it passes or the retry limit is reached.

Run and Fix a GitHub Actions Workflow

Use this skill for workflows that support workflow_dispatch, or for inspecting and rerunning a known Actions run.

OpenTeams context

This skill is designed specifically for use by OpenTeams members. OpenTeams input prompts should include this marker to make the message source explicit:

text
[OPENTEAMS_SOURCE=openteams]

Treat the marker as a source hint, not a security boundary. Its absence does not block the workflow; continue when the surrounding session context clearly comes from OpenTeams.

Required tool

At the start, check whether GitHub CLI is installed and authenticated:

bash
command -v gh >/dev/null 2>&1 && gh auth status

If gh is missing, stop and tell the user to install GitHub CLI. Offer the relevant command without installing it automatically:

  • macOS: brew install gh
  • Windows: winget install --id GitHub.cli
  • Linux: follow https://github.com/cli/cli/blob/trunk/docs/install_linux.md

Then ask the user to run gh auth login. Never request, print, or persist their token.

Workflow

  1. Confirm the repository, workflow name or file, git ref, workflow inputs, and target environment. If any deployment target or input is ambiguous, ask before dispatching.

  2. Start and watch a workflow with the bundled script from this skill directory:

    bash
    bash scripts/workflow-run.sh \
      --workflow <workflow-file-or-name> \
      --ref <branch-or-tag> \
      --field key=value

    Repeat --field for multiple inputs. Add --repo OWNER/REPO when the repository cannot be inferred.

  3. To inspect an existing run, use bash scripts/workflow-run.sh --run-id <id>. For a clearly transient failure, use --run-id <id> --rerun-failed once.

  4. When a run fails, read the summary and failed-step logs emitted by the script. Inspect the relevant workflow and reproduce the failing command locally when practical.

  5. Classify the failure:

    • Runner, network, rate-limit, cache-service, or temporary external outage: rerun failed jobs once without editing code.
    • Code, test, lint, type, build, dependency, or deterministic configuration failure: make the smallest relevant fix and validate it locally.
    • Missing permission, secret, approval, protected environment, billing, or unavailable production resource: stop and report the required human action.
  6. Review the diff, commit only related files, and push normally. Never force-push. Dispatch again only when a push does not already trigger the required workflow.

  7. Repeat for at most three repair iterations, including at most one no-change rerun for the same failure signature.

  8. Report the workflow, run URLs, root cause, reruns, files changed, local verification, pushed commit, and final conclusion.

Show full SKILL.md (76 more words)Show less

Safety boundaries

  • Ask before starting a production deployment, destructive workflow, rollback, database migration, infrastructure mutation, or workflow with unclear inputs.
  • Ask before changing .github/workflows/**, authentication, permissions, secrets, deployment configuration, or infrastructure.
  • Do not invent workflow inputs. List available workflows with gh workflow list and inspect the selected YAML when necessary.
  • Do not claim success until the target GitHub Actions run finishes successfully. If blocked, return the run URL and exact failed job or required user action.

© openteams-lab, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in assets/skills/github-actions-run-and-fix of openteams-lab/openteams.

  • SKILL.md
  • scripts/workflow-run.sh

Open the folder on GitHubat commit ebee9de

Compare with similar skills

GitHub Actions Run And 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.

GitHub Actions Run And Fix compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
GitHub Actions Run And Fix this skillopenteams-lab/openteams629—~923Automated safety check: PassApache-2.0
Nushellccusage/ccusage19k—~938Automated safety check: PassCustom licence
Make GitHub Actions Workflowdotnet/efcore15k—~2.1kAutomated safety check: PassMIT
AI News RadarLearnPrompt/ai-news-radar1.8k—~2.5kAutomated safety check: NotesMIT
Clawsweeperopenclaw/openclaw392k—~3kAutomated safety check: PassMIT
ONNX Runtime CI Managementmicrosoft/onnxruntime22k—~4.1kAutomated safety check: PassMIT

Similar skills

  • Nushell

    ccusage/ccusage

    Guides ccusage Nushell scripts. An agent skill from ccusage/ccusage.

    19k GitHub stars~938 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Official

    Create GitHub Actions workflows for CI, automation, or PR management.

    15k GitHub stars~2.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • AI News Radar

    LearnPrompt/ai-news-radar

    A skill your agent uses when working on AI News Radar, 24 小时 AI 更新雷达, AI 更新雷达, 伯乐Skill, or Scout Skill: finding high-signal AI/tech sources, adding RSS/OPML/GitHub feeds, checking source health…

    1.8k GitHub stars~2.5k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Clawsweeper

    openclaw/openclaw

    A skill your agent uses for all ClawSweeper work: OpenClaw issue/PR sweep reports, repair jobs, cloud fix PRs, @clawsweeper maintainer mention commands, trusted ClawSweeper-reviewed…

    392k GitHub stars~3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • ONNX Runtime CI Management

    microsoft/onnxruntime

    Official

    Triggers, re-runs and unblocks the CI checks on an ONNX Runtime pull request, after diagnosing whether a failure is transient or needs a code change.

    22k GitHub stars~4.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • 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 today
    DevOps & CloudAuto-check passed

More from openteams-lab/openteams

  • Brainstorming

    openteams-lab/openteams

    OpenTeams-only workflow skill. An agent skill from openteams-lab/openteams.

    629 GitHub stars~2.2k tokensUpdated 5 days ago
    Auto-check passed
  • Code Guidelines

    openteams-lab/openteams

    OpenTeams-only workflow skill. An agent skill from openteams-lab/openteams.

    629 GitHub stars~711 tokensUpdated 5 days ago
    Auto-check passed
  • GitHub PR Actions Fix

    openteams-lab/openteams

    OpenTeams skill for watching GitHub Actions checks after a pull request is submitted or updated, inspecting failures, making the smallest safe code fix, validating locally, pushing to the PR branch…

    629 GitHub stars~878 tokensUpdated 5 days ago
    Auto-check passed
  • Planning Mode

    openteams-lab/openteams

    A skill your agent uses when the user asks to break down a goal into a clear, executable, reviewable task plan using WBS, dependencies, milestones, RACI, risk register, and plan review.

    629 GitHub stars~1.6k tokensUpdated 5 days ago
    Auto-check passed
  • Using Git Worktrees

    openteams-lab/openteams

    A skill your agent uses when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools, git…

    629 GitHub stars~3k tokensUpdated 5 days ago
    Auto-check passed
  • Writing Plans

    openteams-lab/openteams

    OpenTeams-only workflow skill. An agent skill from openteams-lab/openteams.

    629 GitHub stars~1.3k tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about GitHub Actions Run And Fix

What does GitHub Actions Run And Fix do?

OpenTeams skill for manually starting a GitHub Actions workflow, watching its execution, diagnosing failures, rerunning transient failed jobs, repairing code or configuration errors, and dispatching…. GitHub Actions Run And Fix is an agent skill from openteams-lab/openteams. OpenTeams skill for manually starting a GitHub Actions workflow, watching its execution, diagnosing failures, rerunning transient failed jobs, repairing code or configuration errors, and dispatching the workflow again until it passes or the retry limit is reached.

When should I use GitHub Actions Run And Fix?

GitHub Actions Run And Fix fits situations like: tasks that involve CI/CD.

How do I install GitHub Actions Run And Fix in Claude Code?

Run `npx skills add openteams-lab/openteams --skill github-actions-run-and-fix -a claude-code`. Or copy the skill folder (assets/skills/github-actions-run-and-fix in openteams-lab/openteams) into .claude/skills/github-actions-run-and-fix in your project. Claude Code loads it when a task matches its description.

How do I install GitHub Actions Run And Fix in Codex?

Run `npx skills add openteams-lab/openteams --skill github-actions-run-and-fix -a codex`. Or copy the skill folder (assets/skills/github-actions-run-and-fix in openteams-lab/openteams) into .agents/skills/github-actions-run-and-fix in your project. Codex loads it when a task matches its description.

Can I use GitHub Actions Run And 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 openteams-lab/openteams --skill github-actions-run-and-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/github-actions-run-and-fix, .gemini/skills/github-actions-run-and-fix, .github/skills/github-actions-run-and-fix and .opencode/skills/github-actions-run-and-fix in your project.

What does GitHub Actions Run And Fix need to run?

Going by SKILL.md and its folder, GitHub Actions Run And Fix needs a shell for the scripts in its folder and the command-line tools its instructions call (gh, bash, brew and winget). Our summary lists: A Bash shell.

Does GitHub Actions Run And Fix access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is GitHub Actions Run And 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does GitHub Actions Run And Fix use?

GitHub Actions Run And Fix is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does GitHub Actions Run And Fix use?

About 923 tokens (SKILL.md is roughly 3.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 GitHub Actions Run And Fix?

Skills that share tags, products or a category with GitHub Actions Run And Fix: Nushell (ccusage/ccusage, 19k stars), Make GitHub Actions Workflow (dotnet/efcore, 15k stars), AI News Radar (LearnPrompt/ai-news-radar, 1.8k stars) and Clawsweeper (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains GitHub Actions Run And Fix?

openteams-lab (a GitHub organization) maintains it in openteams-lab/openteams, which has 629 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 4, 2026.

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