debug-run-transcript-maintainer

Reconstruct Rudder agent run transcripts to diagnose execution failures.

280|30|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Undertone0809/rudder --skill debug-run-transcript-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-run-transcript-maintainer
Source: https://github.com/Undertone0809/rudder/tree/main/.agents/skills/maintainer/debug-run-transcript-maintainer
Command: npx skills add https://github.com/Undertone0809/rudder --skill debug-run-transcript-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you debug Rudder agent runs by reconstructing what actually happened across transcripts, run logs, and execution traces so you can pinpoint the first failure point rather than guessing from partial summaries.

Core Features & Use Cases

  • Reconstructs the execution story: diagnoses failures using run-intelligence evidence, transcript outlines, and fallback log reconstruction.
  • Handles partial identifiers and batch audits: supports full run IDs, ID prefixes, and “recent runs” requests at org/runtime/time-window scope.
  • Evidence-first debugging: keeps root-cause evidence separate from product-fix proof, helping you avoid claiming a fix works without lifecycle verification.

Quick Start

Use this skill when you want to understand why a Rudder agent run failed by providing a run ID, a run ID prefix, or a recent-run timeframe and asking for the first clear failure point with evidence.

Frequently Asked Questions about debug-run-transcript-maintainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a Rudder agent run failure from an execution transcript?

Debug a Rudder agent run failure by reconstructing the execution transcript from run-intelligence or filesystem evidence to pinpoint the first failure point. It applies evidence-based failure classification to separate root-cause diagnosis from fix proof.

Can I audit multiple recent agent runs in a single batch?

Yes, you can audit recent agent runs in a single batch. Provide a timeframe with org, runtime, or time-window scope, and the tool will analyze cancellations, runtime failures, and empty transcripts across that specified range.

How do I find the root cause of a Rudder agent cancellation with only a partial run ID?

Find the root cause of a cancellation using a partial run ID prefix. The tool handles partial identifiers and applies prioritized source selection with safe fallback behavior to reconstruct logs and identify the first clear failure point.

What is the best way to diagnose empty or zero-outline transcripts in agent runs?

The best way to diagnose empty transcripts is evidence-first debugging. It reconstructs the execution story from fallback logs and run-intelligence evidence to classify tool-call or stdout/stderr issues without guessing from partial summaries.

Why does my agent run debugging claim a fix works without lifecycle verification?

Debugging claims fail without lifecycle verification when root-cause evidence is mixed with fix proof. This tool keeps them separate, ensuring you avoid claiming a fix works and instead rely on clear output with evidence-based failure classification.

Do I need a full run ID to trace tool-call failures in a Rudder agent run?

No, a full run ID is not required to trace tool-call failures. You can use a run ID prefix or a recent-run timeframe to reconstruct the execution transcript and diagnose runtime failures from the best available evidence.