debug-triage

Captures failing test/build output and git/env state into a structured triage bundle with report.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/matthabermehl/generation-b-kids-books --skill debug-triage-matthabermehl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-triage
Source: https://github.com/matthabermehl/generation-b-kids-books/tree/main/.codex/skills/debug-triage
Command: npx skills add https://github.com/matthabermehl/generation-b-kids-books --skill debug-triage-matthabermehl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, node, npm, python, pip, go, rustc, bash, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the collection of reproducible evidence when tests, builds, or agents fail, turning ad-hoc debugging into a mechanical triage process that teams can act on immediately.

Core Features & Use Cases

  • Reproducible Command Capture: Records the exact failing command and separates stdout and stderr for reliable reproduction.
  • Repository & Env Snapshot: Captures git status, diffs, recent commits, and a system environment snapshot (node, python, go, rustc, etc.).
  • Structured Triage Output: Produces a timestamped triage bundle with a human-friendly triage_report.md containing a minimal hypothesis and next experiments.
  • Use Case: Use when a CI job or local test script fails intermittently or when an agent loops without progress to quickly gather all evidence needed for root-cause analysis.

Quick Start

Run the triage script with the failing command to create a timestamped bundle and triage_report.md, for example: bash .codex/skills/debug-triage/scripts/triage.sh "bash scripts/agent/test.sh".

Frequently Asked Questions about debug-triage

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

FAQPage Schema
How do I generate a reproducible triage report when my CI build or tests fail?

Capture failing test and build outputs to generate a reproducible diagnostic triage bundle by running the triage script with your failing command. It records exact stdout, stderr, git diffs, and environment snapshots into a timestamped bundle with a triage_report.md for root-cause analysis.

What is the best way to capture git status and environment snapshots when debugging a failing command?

The best way to capture git status and environment snapshots when debugging a failing command is using an automated triage script. It collects repository state, system environment variables, and command outputs into a structured bundle for reliable reproduction and root-cause analysis.

Can I use this triage script to debug local test scripts and intermittent CI failures?

Yes, you can use this triage script to debug local test scripts and intermittent CI failures. It captures exact failing command outputs, repository state, and environment snapshots for both local and CI environments to ensure reliable reproduction of intermittent issues.

Do I need specific dependencies like node, python, or go installed to run the triage bundle generator?

You need bash to execute the triage script, while dependencies like node, python, go, and rustc are automatically detected and recorded in the environment snapshot. This ensures the diagnostic bundle captures all relevant system information for accurate reproduction.

Why does my agent process loop without progress and how do I collect evidence for root-cause analysis?

When an agent process loops without progress, running the triage script collects evidence for root-cause analysis by capturing exact command output, git repository state, and environment snapshots. This mechanical triage approach forms hypotheses and defines next experiments to break the loop.