🔁
AI EngineeringPython

Error Recovery

by aden-hive

Error Recovery is an AI Engineering skill for Claude Code, published by aden-hive in hive.

10.9K stars5.7K forkson aden-hive/hiveAdded 2026/08/15Repository updated 2026/08/13
agentagent-frameworkagent-skillsanthropicautomationautonomous-agentsclaudeharnessharness-engineeringhuman-in-the-loopopenaipythonself-hostedself-improving
Install in seconds
Install Error Recovery
Copy Error Recovery into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/aden-hive/hive/tree/main/core/framework/skills/_default_skills/error-recovery ~/.claude/skills/error-recovery

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/aden-hive/hive.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
core/framework/skills/_default_skills/error-recovery/SKILL.md in aden-hive/hive
Installs to
~/.claude/skills/error-recovery
Collection
One of 24 skills cataloged from this repository
Category
AI Engineering2451 skills

What Error Recovery does

Error Recovery guides an agent through a decision tree for tool call failures: retry transient errors once, fix and retry structural ones, or escalate if blocking. It switches tools after repeated failures and logs failed tasks to a database.

Error Recovery is cataloged under AI Engineering on DirSkills. Error Recovery comes from a repository tagged agent, agent-framework, agent-skills, anthropic and automation.

Documentation

README

Operational Protocol: Error Recovery

When a tool call fails:

  1. Diagnose — classify the failure as transient (network blip, rate limit, timeout) or structural (wrong selector, missing auth, invalid schema, permission denied).

  2. Decide:

    • Transient → retry once.
    • Structural + fixable → fix the input and retry.
    • Structural + unfixable → record the failure and move to the next item.
    • Blocking all progress → escalate.
  3. Adapt — if the same tool has failed {{max_retries_per_tool}}+ times in a row, stop using it and find an alternative approach.

Never silently drop a failed item. If the item is a task in the colony queue, write the failure to the DB instead of an in-memory buffer:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Error Recovery

  • What else does aden-hive publish alongside Error Recovery?

    Error Recovery is one of 24 skills that DirSkills catalogs from aden-hive/hive, the repository it ships in. Its siblings there include Background Job Control, Browser Edge Cases and Chart Creation Foundations. Each one is a separate skill with its own page in this directory, installs the same way Error Recovery does, and is maintained by aden-hive in that same repository. The rest of the collection is listed on the aden-hive/hive page.

  • How does Error Recovery compare to other AI Engineering skills?

    Error Recovery ranks #373 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Error Recovery against them. Open each page to compare what they document and how they install.

More from aden-hive/hive

Error Recovery is one of 24 skills cataloged on DirSkills from aden-hive/hive.

See all 24 skills
2w ago

Background Job Control

Background Job Control manages long-running terminal jobs using start, poll, wait, and signal tools. Use it before launching builds, deploys, streaming logs, or taking over auto-backgrounded processes from terminal_exec.
Automation
10.9K5.7K
🔍
2w ago

Browser Edge Cases

Browser Edge Cases provides a standard operating procedure for debugging browser automation failures on complex websites. Use it when browser tools fail on LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
Automation
10.9K5.7K
📊
2w ago

Chart Creation Foundations

Chart Creation Foundations teaches the one-tool embedding contract for rendering BI/financial-grade ECharts and Mermaid charts that appear live in chat and save as high-DPI PNGs. Use it whenever chart_* tools are available to avoid chartjunk and missing downloads.
Data
10.9K5.7K
📋
2w ago

Colony Progress Tracker

Colony Progress Tracker claims tasks, records step progress, and verifies SOP gates in a shared SQLite queue. Use when your spawn message includes db_path and colony_id fields.
Automation
10.9K5.7K
🧠
2w ago

Context Preservation

Context Preservation proactively extracts critical values from tool results into working notes before automatic context pruning destroys them. Use it when an agent must retain URLs, API fields, IDs, and analysis conclusions across long tasks.
AI Engineering
10.9K5.7K
🔍
2w ago

Filesystem Search

Filesystem Search teaches agents when to use terminal_rg, terminal_glob, and terminal_exec for filesystem search: content grep with ripgrep, filename globs, and predicate queries for mtime/size/type.
AI Engineering
10.9K5.7K