About

Imported from mjcramerz/codex-home (home/plugins/cache/codex-home/github/1.0.0/skills/ci-github-actions-fix/SKILL.md). Install upstream with npx skills add mjcramerz/codex-home --skill ci-github-actions-fix. Copyright stays with the author.

CI-GitHub Actions Fix

Name: ci-github-actions-fix
Author: mjcramerz

Use this skill when

a GitHub PR has failing checks and you need root cause + safe remediation.
a workflow is flaky/intermittent and you need evidence before proposing fixes.

Inputs

repo: repository path (default .)
pr: PR number or URL (optional; current-branch PR by default)
gh authentication with access to checks and workflow logs

Scope and boundaries

Do not treat external providers as actionable GitHub Actions failures.
Do not broad-rerun unrelated workflows to “green” CI.
Keep fixes minimal and scoped to the failing cause.

Workflow

Verify gh auth and resolve the target PR.
Run scripts/inspect_pr_checks.py first (--json optional), then use manual gh fallback only if fields/logs are unavailable.
Isolate failing workflow/job, capture the smallest useful snippet, and include check name + run URL.
Separate external/non-GitHub-Actions checks from actionable workflow failures.
Propose a minimal, reversible fix plan; implement after approval.
Re-run the narrowest checks and confirm status via gh pr checks.

Manual fallback commands

gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow
gh run view <run_id> --json name,workflowName,conclusion,status,url,event,headBranch,headSha
gh run view <run_id> --log
gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" > <path>

Agent orchestration

Delegate log collection and inventory only.
Keep diagnosis, fix strategy, and risk sign-off centralized.

Validation and testing

Bound log size/time (--max-lines, --context) and avoid noisy full-log dumps.
Confirm reproducibility before editing and capture the failing command/check identifier.
Run only the checks required to prove the fix, then re-check status with gh pr checks.

Outputs

Failure summary with evidence (check, run URL, snippet).
Minimal fix plan with impact/risk notes.
Verification notes showing before/after check state.

References

scripts/inspect_pr_checks.py
$CODEX_HOME/docs/workflows/github-actions.md
$CODEX_HOME/docs/workflows/ci-cd.md
Use skill ci-github-actions.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/mjcramerz-codex-home-ci-github-actions-fix/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

mjcramerz-codex-home-ci-github-actions-fix.ocm.jsonjson

{
  "ocm": "1",
  "id": "mjcramerz-codex-home-ci-github-actions-fix",
  "kind": "skill",
  "name": "ci-github-actions-fix",
  "description": "Debug failing GitHub Actions checks by inspecting PR statuses and logs with gh, then propose and implement fixes after approval. Use when the user asks why GitHub PR CI failed or wants failing Actions checks fixed.",
  "publisher": "mjcramerz",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "github",
      "gh",
      "ci",
      "actions",
      "debugging"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Debug failing GitHub Actions checks by inspecting PR statuses and logs with gh, then propose and implement fixes after approval. Use when the user asks why GitHub PR CI failed or wants failing Actions checks fixed."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/mjcramerz/codex-home",
      "path": "home/plugins/cache/codex-home/github/1.0.0/skills/ci-github-actions-fix/SKILL.md",
      "ref": "03d0b59b253570405077056fb3c93e1a4f57c8cd",
      "url": "https://github.com/mjcramerz/codex-home/blob/03d0b59b253570405077056fb3c93e1a4f57c8cd/home/plugins/cache/codex-home/github/1.0.0/skills/ci-github-actions-fix/SKILL.md",
      "key": "mjcramerz/codex-home/home/plugins/cache/codex-home/github/1.0.0/skills/ci-github-actions-fix/SKILL.md"
    }
  },
  "instructions": "# CI-GitHub Actions Fix\n\n## Use this skill when\n- a GitHub PR has failing checks and you need root cause + safe remediation.\n- a workflow is flaky/intermittent and you need evidence before proposing fixes.\n\n## Inputs\n- `repo`: repository path (default `.`)\n- `pr`: PR number or URL (optional; current-branch PR by default)\n- `gh` authentication with access to checks and workflow logs\n\n## Scope and boundaries\n- Do not treat external providers as actionable GitHub Actions failures.\n- Do not broad-rerun unrelated workflows to “green” CI.\n- Keep fixes minimal and scoped to the failing cause.\n\n## Wor",
  "cost": {
    "context_tokens": 545
  }
}

Fetch it by URL: GET /api/v1/registry/mjcramerz-codex-home-ci-github-actions-fix/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.