Zhtw Verify
sysprog21/zhtw-mcp
How a zhtw-mcp change is validated - make check as the gate, the generated tables and the ruleset normalization that have to be current before it passes, the formatter chain in scripts/indent.sh…
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…
Install Self Healing
$ npx skills add pskoett/pskoett-ai-skills --skill self-healing -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pskoett/pskoett-ai-skills self-healing --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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 .claude/skills/self-healing && rm -rf skills-srcUse ~/.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/
Install the "self-healing" agent skill from https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-healing into .claude/skills/self-healing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-healing", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-healingType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pskoett/pskoett-ai-skills --skill self-healing -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pskoett/pskoett-ai-skills self-healing --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/self-healing .agents/skills/self-healing && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "self-healing" agent skill from https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-healing into .agents/skills/self-healing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-healing", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pskoett/pskoett-ai-skills --skill self-healing -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pskoett/pskoett-ai-skills self-healing --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/self-healing .cursor/skills/self-healing && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "self-healing" agent skill from https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-healing into .cursor/skills/self-healing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-healing", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pskoett/pskoett-ai-skills.git --path skills/self-healing--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pskoett/pskoett-ai-skills --skill self-healing -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pskoett/pskoett-ai-skills self-healing --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/self-healing .gemini/skills/self-healing && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "self-healing" agent skill from https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-healing into .gemini/skills/self-healing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-healing", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pskoett/pskoett-ai-skills self-healingInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pskoett/pskoett-ai-skills --skill self-healing -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/self-healing .github/skills/self-healing && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "self-healing" agent skill from https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-healing into .github/skills/self-healing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-healing", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pskoett/pskoett-ai-skills --skill self-healing -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pskoett/pskoett-ai-skills self-healing --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/self-healing .opencode/skills/self-healing && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "self-healing" agent skill from https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-healing into .opencode/skills/self-healing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-healing", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
self-healing- GitHub stars
- 314
- Token cost
- ~5.3k tokens
- SKILL.md length
- 2,230 words
- Files
- 24 (incl. scripts, references)
- Skills in repo
- 24
- Repo updated
- First seen
- Licence
- None found
At a glance
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…
- Works in 5 steps: Tool failure (command / test / build /… → Missing capability / tool gap → Environment issue → …
- On missing tooling
- SKILL.md covers What this skill is for, Relationship to self-improvement, The Heal Loop and When to trigger, plus 10 more sections
- Calls npm, nvm and pyenv
What it does
Self Healing is an agent skill from 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 with proof. Use whenever a command, test, build, or lint fails or exits non-zero; on missing tooling, dependency/lockfile mismatch, wrong runtime version, venv or permission errors, port conflicts, dirty git state, or a missing .env; when the agent needs a helper or one-off script that doesn't exist yet; when an…
Its SKILL.md is about 5.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 31 other files, including scripts and reference files (for example `evals/benchmark-iteration-1.json`, `evals/benchmark-iteration-1.md` and `evals/evals.json`).
It sits in Development, covering Dependency management, Rate limiting and Linting and formatting. It works with Model Context Protocol and Git.
When your agent uses it
- On missing tooling
- Dependency/lockfile mismatch
- Wrong runtime version
- Permission errors
Example prompts
- “/self-healing”
Requirements
- Python 3
- Node.js
Workflow steps
5 steps, taken from the step headings in SKILL.md.
- Tool failure (command / test / build / lint)
- Missing capability / tool gap
- Environment issue
- External service / API change
- About-to-retry-the-same-broken-approach
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
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
npmnvmpyenv
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
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
Self Healing loads about 5.3k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 249 tokens; SKILL.md has 2,230 words of instructions outside code blocks.
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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:3
onflicts, dirty git state, or a missing `.env`; when the agent needs a helper or one-off script that doesn't exist yet; - NoteMentions a .env fileSKILL.md:105
git state blocking a checkout; missing `.env` (copy from `.env.example` and surface gaps).
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
Without a licence we can't republish the file, so here is its outline and opening line. It has 2,230 words (~5,332 tokens).
“Active runtime recovery for coding agents. When something breaks, run the loop: diagnose → patch → verify → file. Leave behind a reusable, verified artifact instead of a swept-under-the-rug failure.”
- name
- self-healing
Files
SKILL.md and 23 other files (scripts, references) in skills/self-healing of pskoett/pskoett-ai-skills.
- SKILL.md
- evals/benchmark-iteration-1.json
- evals/benchmark-iteration-1.md
- evals/evals.json
- evals/fixtures/abandoned-heal/recent-flake.log
- evals/fixtures/abandoned-heal/src/Card.test.tsx
- evals/fixtures/abandoned-heal/src/Card.tsx
- evals/fixtures/branch-rename/README.md
- evals/fixtures/lockfile-mismatch/package.json
- evals/fixtures/lockfile-mismatch/pnpm-lock.yaml
- evals/fixtures/lockfile-mismatch/recent-error.log
- evals/fixtures/recurring-heal/.learnings/HEALS.md
- evals/fixtures/recurring-heal/pyproject.toml
- … and 11 more
Open the folder on GitHubat commit 5a836dc
Compare with similar skills
Self Healing 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Self Healing this skillpskoett/pskoett-ai-skills | 314 | — | ~5.3k | Automated safety check: Notes | None | |
| Zhtw Verifysysprog21/zhtw-mcp | 488 | — | ~2.8k | Automated safety check: Pass | MIT | |
| OpenStoryline Install HelperFireRedTeam/FireRed-OpenStoryline | 3.5k | — | ~1.5k | Automated safety check: Notes | Apache-2.0 | |
| Zed Configwcygan/dotfiles | 196 | — | ~930 | Automated safety check: Pass | None | |
| Code Design Rationale Investigatorcursor/plugins | 10k | 9 repos | ~2.6k | Automated safety check: Pass | None | |
| Saleor Commit Workflowsaleor/saleor | 23k | — | ~575 | Automated safety check: Pass | BSD-3-Clause |
Similar skills
OpenStoryline Install Helper
FireRedTeam/FireRed-OpenStoryline
Installs, repairs and starts a local source checkout of FireRed-OpenStoryline, from prerequisites and a venv to resources, config and the MCP and web servers.
Zed Config
wcygan/dotfiles
Zed editor configuration expert. An agent skill from wcygan/dotfiles.
- Official
Code Design Rationale Investigator
cursor/plugins
Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.
Saleor Commit Workflow
saleor/saleor
Commits changes in the Saleor codebase and works through pre-commit hook failures from ruff, mypy, the GraphQL schema check and the migrations check.
Graph-Based Bug Tracing
tirth8205/code-review-graph
Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.
More from pskoett/pskoett-ai-skills
All 24 skills in this repoSelf Improvement
pskoett/pskoett-ai-skills
Captures learnings, errors, corrections, and feature requests to enable continuous improvement.
Self Improvement
pskoett/pskoett-ai-skills
Captures learnings, errors, corrections, and feature requests to enable continuous improvement.
Skill Tester
pskoett/pskoett-ai-skills
Validates all interactive skills in this repo against the Agent Skills spec, project conventions, and structural requirements.
Skill Tester CI
pskoett/pskoett-ai-skills
Validates all CI skills in this repo. An agent skill from pskoett/pskoett-ai-skills.
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.
Eval Creator CI
pskoett/pskoett-ai-skills
[Beta] CI-only eval regression runner using gh-aw (GitHub Agentic Workflows).
Related
Works with
Categories
Questions about Self Healing
What does Self Healing do?
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…. Self Healing is an agent skill from pskoett/pskoett-ai-skills.md with proof.
When should I use Self Healing?
Self Healing fits situations like: on missing tooling; dependency/lockfile mismatch; wrong runtime version; permission errors.
How do I install Self Healing in Claude Code?
Run `npx skills add pskoett/pskoett-ai-skills --skill self-healing -a claude-code`. Or copy the skill folder (skills/self-healing in pskoett/pskoett-ai-skills) into .claude/skills/self-healing in your project. Claude Code loads it when a task matches its description.
How do I install Self Healing in Codex?
Run `npx skills add pskoett/pskoett-ai-skills --skill self-healing -a codex`. Or copy the skill folder (skills/self-healing in pskoett/pskoett-ai-skills) into .agents/skills/self-healing in your project. Codex loads it when a task matches its description.
Can I use Self Healing 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 -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, .gemini/skills/self-healing, .github/skills/self-healing and .opencode/skills/self-healing in your project.
What does Self Healing need to run?
Going by SKILL.md and its folder, Self Healing needs the command-line tools its instructions call (npm, nvm and pyenv). Our summary lists: Python 3; Node.js.
Does Self Healing access the network?
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
Is Self Healing safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Self Healing use?
No licence was found for Self Healing or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Self Healing use?
About 5.3k tokens (SKILL.md is roughly 21k 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 5.7k tokens, read only when the agent opens those files.
What are the alternatives to Self Healing?
Skills that share tags, products or a category with Self Healing: Zhtw Verify (sysprog21/zhtw-mcp, 488 stars), OpenStoryline Install Helper (FireRedTeam/FireRed-OpenStoryline, 3.5k stars), Zed Config (wcygan/dotfiles, 196 stars) and Code Design Rationale Investigator (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Self Healing?
pskoett (a GitHub user) maintains it in pskoett/pskoett-ai-skills, which has 314 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.