
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- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads failure-recovery automatically when relevant.
- 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
system-prompt-structure
owl-listener/ai-design-skills
Anatomy of effective system prompts — role, context, constraints, format.
guardrail-design
owl-listener/ai-design-skills
Defining behavioral boundaries — what the AI should and shouldn't do.
constraint-specification
owl-listener/ai-design-skills
Defining output format, length, tone, and content boundaries within prompts.
generative-ui
owl-listener/ai-design-skills
Designing interfaces where AI generates UI components dynamically.
conversation-patterns
owl-listener/ai-design-skills
Turn-taking, repair sequences, grounding, and dialogue structure for human-AI interaction.
progressive-disclosure
owl-listener/ai-design-skills
Revealing AI capability gradually to match user mental models.
Popular other skills
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.
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.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.