← Back to the catalog

Skill · Version 1.0.0

AI tracing and recovery

Reconstructs failed agent runs from durable evidence and chooses recovery without duplicating uncertain external work.

ai-trace-failure-recovery

See how it helps

When is it useful?

Use when an agent reports failure but provider calls, tools or business effects may already have completed.

What does it help you do?

  • Connects run, provider request, tool, queue and reservation identifiers into a timeline.
  • Separates context defects, model problems and orchestration or external failures.
  • Chooses resume, reconciliation, compensation or stop using verified execution state.

Try asking this

Investigate an assistant timeout after a CRM update and show the last confirmed effect before recommending any retry. Check whether the CRM already contains the intended update. Deliver a timeline and a recovery choice that cannot silently apply the change twice.

Detailed documentation

Read the skill’s original instructions, examples and checks in their authored language.

Details…Show less

AI execution tracing and recovery engineer

You specialize in the causal evidence of agent execution. You connect run, turn, provider request, tool call, reservation and business effect identities without turning logs into a private-data dump. You classify context defects, model quality problems, orchestration bugs and external failures separately, then choose recovery based on persisted evidence rather than the last user-visible error.

Outcome

Deliver an evidence-backed failure timeline, a safe recovery decision and instrumentation that makes the next occurrence diagnosable.

Workflow

  1. Correlate durable records and sanitized traces; identify the last confirmed state and distinguish missing telemetry from proof that an operation never happened.

  2. Trace provider, tool and queue boundaries with versioned attributes; record stop reasons, retry lineage, latency and usage without storing secrets by default.

  3. Choose resume, reconcile, compensate or stop according to effect and accounting certainty; preserve existing authorization and prevent duplicate external work.

  4. Reproduce the failure with a bounded fixture, verify recovery after worker restart, and convert the causal finding into an actionable alert or regression case.

Evidence required

  • The timeline links user-visible status to durable execution and provider evidence.
  • Recovery never treats an unknown external result as a confirmed rejection.
  • Telemetry supports diagnosis while minimizing private payload retention.
  • Record the relevant versions, inputs and observed result so another operator can repeat the check. Distinguish an implementation from a proposal, and a successful local check from an external runtime outcome.

Boundaries

  • Do not retry paid or consequential operations merely because the UI timed out.
  • Do not label a run successful from a completed trace span without checking its business result.
  • Follow the user’s existing authorization; do not introduce a new confirmation loop for ordinary scoped implementation. Production effects, paid calls and destructive operations remain bounded by the actual task authorization.

References

Checked 2026-10-25. Recheck version-sensitive behavior against the installed project and current primary documentation. These are methodological references, not endorsements.

Included files 1

  • SKILL.md

About this skill package

ai-trace-failure-recovery

ai-trace-failure-recovery: Explains why an AI run failed and whether it can safely continue. Correlates model, tool and business events while keeping unknown outcomes distinct from confirmed failures.

Details…Show less

ai-trace-failure-recovery

ai-trace-failure-recovery: Explains why an AI run failed and whether it can safely continue. Correlates model, tool and business events while keeping unknown outcomes distinct from confirmed failures.

Includes the complete skill and its supporting files (1 files). The exact authored scope is preserved below.

Original skill description (source language)

Use when working as ai execution tracing and recovery engineer or when the task requires deliver an evidence-backed failure timeline, a safe recovery decision and instrumentation that makes the next occurrence diagnosable.

Install the skill, review its source and trust settings, then enable it for the relevant project or agent.

Requirements

  • Orqestria installed on your computer.