self-healing SKILL.md skillA

self-healing from tekkiiiii/the-agency is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tekkiiiii/the-agency/self-healing@git:20261007.04729ed

Pins git:20261007.04729ed in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tekkiiiii/the-agency
Path
skills/self-healing/SKILL.md
Versions recorded
2
Latest version
git:20261007.04729ed, committed Oct 7, 2026
First version recorded
May 8, 2026
Size
2,458 bytes
Repository stars
6
License
none declared

Use when a script, build or command fails, a stack trace appears, or the user says "it's broken", "this isn't working", "I'm getting an error", "fix this". Runs a root-cause loop (triage, two attempts, then escalates to superpowers-systematic-debugging); never patches without investigation.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Self-Healing Workflow Skill

## Core Philosophy

Quick wins for superficial issues (missing deps, typos, wrong paths).
If the issue persists after 2 attempts, escalate to `superpowers-systematic-debugging`.
Never apply patches without investigating root cause — triage first, then escalate.

## Diagnostic Loop
```
Error encountered
      ↓
1. Read full error message carefully
2. Identify error type (see categories below)
3. Attempt 1 fix strategy
4. Re-run / re-test
5. If still failing → try one more strategy (attempt 2)
6. After 2 failed attempts → invoke `superpowers-systematic-debugging`
   - Summarize what was tried and what happened
   - Pass the root cause hypothesis forward
```

## Error Categories & Fix Strategies

### Dependency / Import Errors
1. Check if package is installed (`pip list`, `npm list`)
2. Install missing package with correct version
3. Check for name conflicts or deprecated packages

### Permission / Path Errors
1. Verify file/directory exists
2. Check read/write permissions
3. Use absolute paths instead of relative

### Type / Runtime Errors
1. Add defensive type checks
2. Log intermediate values to trace the issue
3. Add null/undefined guards
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tekkiiiii/the-agency/self-healing@sha256:f3b07b6eae26c3b3

The line at the top of this page pins the label git:20261007.04729ed, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_idxbttfpide2j6q3.svg)](https://markdownregistry.com/a/art_idxbttfpide2j6q3)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between May 8, 2026 and Oct 7, 2026, about one every 152 days.

versioncommittedcommitsizeaudit
git:20261007.04729ed latest2026-10-07 04729ed 2,458 BA view · diff
git:20260508.65c1b0b2026-05-08 65c1b0b 3,530 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2458 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tekkiiiii/the-agency · 6 stars · license none declared · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_idxbttfpide2j6q3
GET https://markdownregistry.com/api/v1/resolve?ref=tekkiiiii/the-agency/self-healing
GET https://markdownregistry.com/api/v1/blob/f3b07b6eae26c3b326a9462c0ebf0ec5da0e5bd2b857ae25d8472248a9a44b4f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from tekkiiiii/the-agency

CLAUDE.md CLAUDE.md file
tekkiiiii/the-agency · CLAUDE.md
git:20261020.f5c49ca · audit A · 6 stars
dept-resume SKILL.md skill
tekkiiiii/the-agency · agents-archive/dept-sunset-2026-10-08/skills/dept-resume/SKILL.md · Read dept-state.md and spawn a Dept Head with a lean briefing. Department-operations parallel of /pd-resume.
v1.0.0 · audit A · 6 stars
dept-save-state SKILL.md skill
tekkiiiii/the-agency · agents-archive/dept-sunset-2026-10-08/skills/dept-save-state/SKILL.md · Write dept-state.md and member-roster.md at end of department session. Department-operations parallel of /save-state.
v1.0.0 · audit A · 6 stars
dept-status SKILL.md skill
tekkiiiii/the-agency · agents-archive/dept-sunset-2026-10-08/skills/dept-status/SKILL.md · Read-only department status digest. No spawns. Shows active coords, pipelines, open issues, and incoming tasks.
v1.0.0 · audit A · 6 stars
dept-wrap SKILL.md skill
tekkiiiii/the-agency · agents-archive/dept-sunset-2026-10-08/skills/dept-wrap/SKILL.md · Freeze department state at session end. Writes dept-state.md, updates member-roster.md, archives scratch files…
v1.0.0 · audit A · 6 stars
room-manager-digest SKILL.md skill
tekkiiiii/the-agency · agents-archive/dept-sunset-2026-10-08/skills/room-manager-digest/SKILL.md · Use on /room-manager-digest, a 12h cron, or when a dept head wants a fresh report. Reads each dept room's rolling.md…
git:20261009.e24f09d · audit A · 6 stars
room-manager SKILL.md skill
tekkiiiii/the-agency · agents-archive/dept-sunset-2026-10-08/skills/room-manager/SKILL.md · Use on /room-manager, every 10 minutes as a background loop, or when new room activity is suspected (handoff file…
git:20261009.e24f09d · audit A · 6 stars
obsidian-vault SKILL.md skill
tekkiiiii/the-agency · agents-archive/rev001-curator-2026-10-12/skills/obsidian-vault/SKILL.md · Use to forward decisions, project learnings, skill creations and generated assets to the Obsidian vault, and to read it…
git:20261013.24ed2e2 · audit A · 6 stars
_hidden SKILL.md skill
tekkiiiii/the-agency · scripts/tests/fixtures/jev/router-skills/_hidden/SKILL.md · underscore dirs are never routable
git:20261014.27c93aa · audit B · 6 stars
content-polish SKILL.md skill
tekkiiiii/the-agency · scripts/tests/fixtures/jev/router-skills/content-polish/SKILL.md · Polish drafted content to publish-ready in one pass; English and Vietnamese.
git:20261014.27c93aa · audit B · 6 stars
frontend SKILL.md skill
tekkiiiii/the-agency · scripts/tests/fixtures/jev/router-skills/frontend/SKILL.md · Use when building frontend UIs: "build a landing page", "make a dashboard", "write a React component". Not for…
git:20261014.27c93aa · audit B · 6 stars
nested-skill SKILL.md skill
tekkiiiii/the-agency · scripts/tests/fixtures/jev/router-skills/frontend/nested-skill/SKILL.md · nested dirs are out of the depth-1 universe
git:20261014.27c93aa · audit B · 6 stars

Every file in tekkiiiii/the-agency

Browse by kind, by grade A, or by owner.