| name | Error-State Recovery |
| description | Wraps command execution in a self-healing loop. Uses heuristics to auto-fix common errors (missing deps, locked files) or escalates to the Agent with structured error context. |
| version | 1.0.0 |
| author | Antigravity Skills Library |
| created | "2026-01-16T00:00:00.000Z" |
| leverage_score | 5/5 |
SKILL-006: Error-State Recovery
Overview
Agents often fail due to transient or trivial errors (e.g., missing Python module, locked file, timeout). This skill provides a Invoke-Recoverable wrapper that catches these errors, attempts to apply known fixes, and retries the operation.
Trigger Phrases
run with recoveryauto-fix <command>try hard <command>
Inputs
| Parameter | Type | Required | Default | Description |
|---|
--command | string | Yes | - | The command to execute |
--retries | int | No | 3 | Max retry attempts |
--heuristics | switch | No | True | Enable heuristic auto-fixes (pip, npm, mkdir) |
Outputs
- Success: Standard output of the command.
- Failure:
ERROR_STATE.json containing the stack trace, context, and failed fix attempts.
Supported Heuristics
- Python
ModuleNotFoundError: Auto-runs pip install <module>.
- DirectoryNotFound: Auto-runs
mkdir -p.
- File Locked: Waits 2s and retries.
- CLI Missing: Checks standard paths for tool (e.g.,
forge, dotnet).
Preconditions
- PowerShell 7+
Implementation
See invoke_recovery.ps1.
Integration
.\skills\06_error_recovery\invoke_recovery.ps1 -Command "python hunt.py" -Retries 3
