MCPInstall

failure-recovery

What happens when an agent fails — retry, fallback, escalate, or graceful degradation.

Installs
129
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/owl-listener/ai-design-skills --skill failure-recovery
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads failure-recovery automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Failure Recovery

Agents fail. Networks time out, models hallucinate, tools error, and edge cases surprise. Failure recovery design determines whether a failure becomes a dead end or a graceful detour.

Failure Types in Multi-Agent Systems

  • Agent failure: A single agent crashes, times out, or produces invalid output
  • Handoff failure: Context is lost or corrupted during transfer between agents
  • Coordination failure: Agents conflict, deadlock, or produce inconsistent results
  • Resource failure: External tools, APIs, or data sources are unavailable
  • Cascading failure: One agent's failure causes downstream agents to fail

Recovery Strategies

  • Retry: Try the same operation again. Works for transient errors (network timeouts, rate limits). Set a retry limit to avoid infinite loops.
  • Fallback: Switch to an alternative approach. A different agent, a simpler method, or a cached result.
  • Escalation: Pass the problem to a more capable agent or to a human. Used when the failure is beyond the current agent's ability to resolve.
  • Graceful degradation: Deliver a partial result rather than nothing. Tell the user what worked and what didn't.
  • Compensation: Undo the effects of a partially completed workflow before retrying or escalating.

Designing Recovery Paths

For each point in the workflow where failure is possible:

  • What could fail? List the failure modes
  • What's the first recovery strategy? Usually retry for transient errors
  • What's the fallback? If retry fails, what's the alternative?
  • When do you escalate? After how many retries or what type of failure?
  • What does the user see? Transparent about the failure or silently recovered?
  • What's the worst case? If all recovery fails, what's the graceful degradation?

User Experience of Failures

  • Invisible recovery: The system retries or falls back without the user noticing. Best for minor, quickly resolved failures.
  • Transparent recovery: The system tells the user something went wrong and how it's handling it. "This is taking longer than usual — trying an alternative approach."
  • Participatory recovery: The system asks the user to help. "I couldn't access your calendar. Can you check the connection?"
  • Honest failure: The system tells the user it can't complete the task and explains why. Offers alternatives.

Design Artefacts

  • Failure mode inventory per agent and per handoff
  • Recovery strategy specifications (retry limits, fallback paths, escalation triggers)
  • Cascading failure analysis
  • User experience specifications for each failure scenario
  • Recovery testing protocols

FAQ

What does the failure-recovery skill do?

What happens when an agent fails — retry, fallback, escalate, or graceful degradation.

How do I install failure-recovery?

Run npx skills add https://github.com/owl-listener/ai-design-skills --skill failure-recovery in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/failure-recovery/ (personal) or .claude/skills/failure-recovery/ (project).

Which AI agents can use failure-recovery?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is failure-recovery safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains failure-recovery?

It is published by owl-listener in owl-listener/ai-design-skills. It has 129 recorded installs.

More from owl-listener/ai-design-skills

View all →

system-prompt-structure

owl-listener/ai-design-skills

Anatomy of effective system prompts — role, context, constraints, format.

AI & Agents456 installs

guardrail-design

owl-listener/ai-design-skills

Defining behavioral boundaries — what the AI should and shouldn't do.

392 installs

constraint-specification

owl-listener/ai-design-skills

Defining output format, length, tone, and content boundaries within prompts.

AI & Agents375 installs

generative-ui

owl-listener/ai-design-skills

Designing interfaces where AI generates UI components dynamically.

Frontend & Design335 installs

conversation-patterns

owl-listener/ai-design-skills

Turn-taking, repair sequences, grounding, and dialogue structure for human-AI interaction.

328 installs

progressive-disclosure

owl-listener/ai-design-skills

Revealing AI capability gradually to match user mental models.

319 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs