Loading...
Loading...
Set up automated CI failure detection and fixing using Claude Code. Use when you want to create a GitHub Actions workflow that automatically analyzes workflow failures, applies fixes for common issues, and opens issues for complex problems.
npx skill4agent add laurigates/claude-plugins github-workflow-auto-fix| Use this skill when... | Use something else when... |
|---|---|
| Setting up auto-fix workflow for a repo | Fixing a single PR's checks ( |
| Customizing which workflows trigger auto-fix | Inspecting workflow runs manually ( |
| Understanding the auto-fix pattern | Writing new workflows from scratch ( |
find .github/workflows -maxdepth 1 -name 'github-workflow-auto-fix.yml'find .github/workflows -maxdepth 1 -name '*.yml' -type fgh secret list$ARGUMENTS--setup.github/workflows/--workflows <names>--dry-run.github/workflows/github-workflow-auto-fix.ymlname:CLAUDE_CODE_OAUTH_TOKEN--workflows--setup.github/workflows/github-workflow-auto-fix.ymlname: Auto-fix Workflow Failures
on:
workflow_run:
workflows:
# List monitored workflows here
- "CI"
- "Lint"
types: [completed]
concurrency:
group: auto-fix-${{ github.event.workflow_run.head_branch }}
cancel-in-progress: false
permissions:
contents: write
pull-requests: write
issues: write
actions: read
id-token: write
jobs:
auto-fix:
if: >-
github.event.workflow_run.conclusion == 'failure' &&
github.event.workflow_run.actor.type != 'Bot' &&
github.event.workflow_run.head_branch != 'main' &&
github.event.workflow_run.head_branch != 'master'
runs-on: ubuntu-latest
steps:
- name: Checkout failed branch
uses: actions/checkout@v4
with:
ref: ${{ github.event.workflow_run.head_branch }}
fetch-depth: 0
- name: Gather failure context
id: context
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
RUN_ID="${{ github.event.workflow_run.id }}"
gh run view "$RUN_ID" --log-failed 2>&1 | tail -500 > .auto-fix-failed-logs.txt
gh run view "$RUN_ID" --json conclusion,status,name,headBranch,headSha,jobs > .auto-fix-run-summary.json
PR_NUMBER=$(gh pr list --head "${{ github.event.workflow_run.head_branch }}" --json number --jq '.[0].number' 2>/dev/null || echo "")
echo "pr_number=$PR_NUMBER" >> "$GITHUB_OUTPUT"
echo "run_id=$RUN_ID" >> "$GITHUB_OUTPUT"
RECENT_FIX=$(git log --oneline -5 --format='%s' | grep -c 'fix:.*resolve CI failure' || true)
echo "recent_fix_count=$RECENT_FIX" >> "$GITHUB_OUTPUT"
- name: Skip if already attempted
if: steps.context.outputs.recent_fix_count != '0'
run: echo "::notice::Skipping - recent auto-fix commit exists"
- name: Analyze and fix with Claude
if: steps.context.outputs.recent_fix_count == '0'
uses: anthropics/claude-code-action@v1
with:
claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
direct_prompt: |
<analysis-and-fix-prompt>
additional_permissions: |
Read
Write
Edit
Grep
Glob
Bash(git *)
Bash(gh *)workflow_run (failure)
|
v
Gather logs & context
|
v
Claude analyzes failure
|
+---+---+
| |
v v
Fixable Complex/External
| |
v v
Fix & Open issue
push with analysis
| |
v v
Comment Comment on PR
on PR linking issue| Guard | Purpose |
|---|---|
| Prevent bot-triggered loops |
| Never auto-fix main branch directly |
| Recent fix check | Skip if auto-fix already attempted |
| Concurrency group | One auto-fix per branch at a time |
| Limit Claude's iteration count |
| Requirement | How to set up |
|---|---|
| Repository secret with Claude Code OAuth token |
| Included in workflow permissions |
| Included in workflow permissions |
| For creating issues on complex failures |
| Context | Command |
|---|---|
| Check recent failures | |
| Get failed logs | |
| Run summary | |
| Find associated PR | |
| List workflow names | |