gza-task-debug

Diagnose gza task failures by analyzing logs, loops, and baselines.

11|1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/mhawthorne/gza --skill gza-task-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gza-task-debug
Source: https://github.com/mhawthorne/gza/tree/main/src/gza/skills/gza-task-debug
Command: npx skills add https://github.com/mhawthorne/gza --skill gza-task-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly identify why a gza task fails by analyzing logs, detecting agent loops, comparing baselines, and delivering actionable recommendations.

Core Features & Use Cases

  • Analyze task logs to surface root causes and patterns.
  • Detect repetitive loops and potential thrashing in task execution.
  • Compare current task metrics against recent baselines to quantify drift.
  • Output a structured diagnosis and recommended next steps for remediation.

Quick Start

Provide the task ID of a failed or max_turns task to generate a diagnostic report.

Frequently Asked Questions about gza-task-debug

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

FAQPage Schema
How do I diagnose why a gza task fails using logs?

To diagnose gza task failures, analyze task logs, detect repetitive agent loops, and compare current metrics against recent baselines. This process surfaces root causes and patterns from logs, diffs, and cost metrics to deliver a structured diagnosis.

How do I detect agent loops and thrashing in task execution?

Detect agent loops and thrashing in task execution by analyzing task logs for repetitive patterns. This diagnostic approach identifies cyclical behaviors that cause tasks to fail or hit max_turns limits, surfacing the root cause of the execution failure.

What is the best way to compare task metrics against baselines to quantify drift?

The best way to quantify metric drift is to compare current task metrics against recent baselines. By fetching baseline statistics and evaluating differences in logs and cost metrics, you can accurately measure performance drift and identify anomalies.

Can I use Python tooling to fetch task details and git branch information for diagnostics?

Yes, you can use Python-based tooling to fetch task details, baseline statistics, and git branch information. This approach gathers the necessary execution context to produce a structured diagnosis with recommended remediation steps.

Why does my gza task hit max_turns without completing?

A gza task hits max_turns without completing due to repetitive loops or thrashing in task execution. Analyzing logs and comparing task metrics against baselines surfaces these execution patterns, identifying the root cause of the incomplete run.

What do I need to generate a diagnostic report for a failed task?

To generate a diagnostic report for a failed task, you need to provide the task ID of the failed or max_turns task. This input triggers log analysis, loop detection, and baseline comparison to output actionable remediation recommendations.