Agent skill

Self Healing CI

by pskoett in pskoett/pskoett-ai-skills

CI-only self-healing workflow using gh-aw (GitHub Agentic Workflows) for active runtime recovery on pull requests and scheduled runs.

No licenceAuto-check passedDevelopment

Install Self Healing CI

skills CLI
$ npx skills add pskoett/pskoett-ai-skills --skill self-healing-ci -a claude-code

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

GitHub CLI
$ gh skill install pskoett/pskoett-ai-skills self-healing-ci --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/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/self-healing-ci .claude/skills/self-healing-ci && 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
self-healing-ci
GitHub stars
315
Token cost
~2.2k tokens
SKILL.md length
826 words
Files
2 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
None found

At a glance

CI-only self-healing workflow using gh-aw (GitHub Agentic Workflows) for active runtime recovery on pull requests and scheduled runs.

  • Works in 4 steps: GitHub Actions enabled for the repository → GitHub CLI authenticated in the workflow… → gh-aw installed for authoring/validation → …
  • : you want headless heal-loop execution in CI/scheduled pipelines
  • SKILL.md covers Install, Purpose, Context Limitation (Important) and Prerequisites, plus 7 more sections
  • Calls gh, pnpm and npx

What it does

Self Healing CI is an agent skill from pskoett/pskoett-ai-skills. CI-only self-healing workflow using gh-aw (GitHub Agentic Workflows) for active runtime recovery on pull requests and scheduled runs. When a CI check fails (test, build, lint, deploy, scan), this skill diagnoses the failure from CI logs, proposes a verified patch as a PR comment or follow-up commit, and commits a HEAL entry to .learnings/HEALS.md. Verify-before-persist discipline preserved: a HEAL is only verified if a re-run check passes in the same workflow; otherwise it ships as pending-verify for human…

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

It sits in Development, covering Pull requests and Linting and formatting. It works with GitHub.

When your agent uses it

  • : you want headless heal-loop execution in CI/scheduled pipelines
  • You want recurring failure patterns captured automatically
  • You want PRs that surface non-obvious environmental / tooling fixes without human triage

Example prompts

  • “/self-healing-ci”

Requirements

  • Node.js

Workflow steps

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

  1. GitHub Actions enabled for the repository
  2. GitHub CLI authenticated in the workflow (gh auth status)
  3. gh-aw installed for authoring/validation
  4. .learnings/HEALS.md committed to the repo (or created on first run; see references/workflow-example.md for the bootstrap pattern)

What it can do on your machine

Read from SKILL.md and the folder at commit 5a836dc. 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
    • pnpm
    • npx
    • cargo

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

  • Network

    No URLs in SKILL.md. Its commands use gh, pnpm and npx, 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

Self Healing CI loads about 2.2k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 247 tokens; SKILL.md has 826 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~247
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.9k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 826 words (~2,178 tokens).

“CI-only variant of self-healing. Runs the diagnose → patch → verify → file loop headlessly against pull-request and scheduled workflow events.”

— opening of SKILL.md by pskoett
name
self-healing-ci

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in skills/self-healing-ci of pskoett/pskoett-ai-skills.

  • SKILL.md
  • references/workflow-example.md

Open the folder on GitHubat commit 5a836dc

Compare with similar skills

Self Healing CI 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.

Self Healing CI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Self Healing CI this skillpskoett/pskoett-ai-skills315—~2.2kAutomated safety check: PassNone
Create PRRLinf/RLinf5.5k—~2.2kAutomated safety check: PassApache-2.0
Code Reviewnteract/semiotic2.7k—~1.5kAutomated safety check: PassApache-2.0
Debug Os Failure On GitHubstrands-agents/box315—~1.3kAutomated safety check: NotesApache-2.0
Codex Merge PRtbhb/vale-ai-tells117—~3kAutomated safety check: PassMIT
Handsontable Pull Request Workflowhandsontable/handsontable22k—~3.1kAutomated safety check: PassCustom licence

Similar skills

  • Create PR

    RLinf/RLinf

    Open a GitHub pull request for RLinf, or fix an existing one — checks the PR title against Conventional Commits, writes a precise description that follows .github/PULLREQUESTTEMPLATE.md, and lints…

    5.5k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Code Review

    nteract/semiotic

    Review Semiotic pull requests for behavioral bugs, regressions, contract drift, and missing evidence.

    2.7k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Debug Os Failure On GitHub

    strands-agents/box

    Debug a CI failure on an OS you are not on (you are on Linux, it fails on macos-latest, or the reverse) without opening a pull request per attempt.

    315 GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check: notes
  • Codex Merge PR

    tbhb/vale-ai-tells

    Squash merge a pull request. An agent skill from tbhb/vale-ai-tells.

    117 GitHub stars~3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Handsontable Pull Request Workflow

    handsontable/handsontable

    Walks through opening a pull request in the Handsontable monorepo: branch naming, pre-flight checks, the PR template, draft creation and the PR-first changelog flow.

    22k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Reviewdog

    AgentSecOps/SecOpsAgentKit

    Automated code review and security linting integration for CI/CD pipelines using reviewdog.

    220 GitHub starsUsed in 1 repo~3k tokens
    DevelopmentAuto-check passed

More from pskoett/pskoett-ai-skills

All 24 skills in this repo
  • Self Improvement

    pskoett/pskoett-ai-skills

    Captures learnings, errors, corrections, and feature requests to enable continuous improvement.

    315 GitHub stars~5k tokensUpdated 6 days ago
    Auto-check passed
  • Self Improvement

    pskoett/pskoett-ai-skills

    Captures learnings, errors, corrections, and feature requests to enable continuous improvement.

    315 GitHub stars~5.4k tokensUpdated 6 days ago
    Auto-check passed
  • Self Healing

    pskoett/pskoett-ai-skills

    Active runtime recovery for coding agents: when something breaks mid-task, diagnose the root cause, write a fix, VERIFY by re-running the broken thing, then file a HEAL- entry to .learnings/HEALS.md…

    315 GitHub stars~5.3k tokensUpdated 6 days ago
    Auto-check: notes
  • Skill Tester

    pskoett/pskoett-ai-skills

    Validates all interactive skills in this repo against the Agent Skills spec, project conventions, and structural requirements.

    315 GitHub stars~1.3k tokensUpdated 6 days ago
    Auto-check passed
  • Skill Tester CI

    pskoett/pskoett-ai-skills

    Validates all CI skills in this repo. An agent skill from pskoett/pskoett-ai-skills.

    315 GitHub stars~845 tokensUpdated 6 days ago
    Auto-check passed
  • Context Decay

    pskoett/pskoett-ai-skills

    Revalidate persistent agent knowledge by classifying why it can become stale and how quickly it changes, then retain, revise, externalize, or retire it.

    315 GitHub stars~3.3k tokensUpdated 6 days ago
    Auto-check passed

Works with

Categories

Questions about Self Healing CI

What does Self Healing CI do?

CI-only self-healing workflow using gh-aw (GitHub Agentic Workflows) for active runtime recovery on pull requests and scheduled runs. Self Healing CI is an agent skill from pskoett/pskoett-ai-skills. CI-only self-healing workflow using gh-aw (GitHub Agentic Workflows) for active runtime recovery on pull requests and scheduled runs.

When should I use Self Healing CI?

Self Healing CI fits situations like: : you want headless heal-loop execution in CI/scheduled pipelines; you want recurring failure patterns captured automatically; you want PRs that surface non-obvious environmental / tooling fixes without human triage.

How do I install Self Healing CI in Claude Code?

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

How do I install Self Healing CI in Codex?

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

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

What does Self Healing CI need to run?

Going by SKILL.md and its folder, Self Healing CI needs the command-line tools its instructions call (gh, pnpm, npx and cargo). Our summary lists: Node.js.

Does Self Healing CI access the network?

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

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

No licence was found for Self Healing CI or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Self Healing CI use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Self Healing CI?

Skills that share tags, products or a category with Self Healing CI: Create PR (RLinf/RLinf, 5.5k stars), Code Review (nteract/semiotic, 2.7k stars), Debug Os Failure On GitHub (strands-agents/box, 315 stars) and Codex Merge PR (tbhb/vale-ai-tells, 117 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Self Healing CI?

pskoett (a GitHub user) maintains it in pskoett/pskoett-ai-skills, which has 315 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 5, 2026.

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