pua-debugging

Enforce root-cause analysis and verification for debugging failures.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/zjh08177/agent-harness --skill pua-debugging-zjh08177
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pua-debugging
Source: https://github.com/zjh08177/agent-harness/tree/main/skills/pua-debugging
Command: npx skills add https://github.com/zjh08177/agent-harness --skill pua-debugging-zjh08177

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams and individuals overcome repeated debugging failures by enforcing proactive ownership, methodical diagnosis, and verifiable resolutions.

Core Features & Use Cases

  • Proactive discovery: expand investigations beyond the first error to uncover root causes.
  • Systematic workflow: apply a repeatable five-step debugging approach with evidence gathering and verification.
  • End-to-end ownership: verify fixes, check for related issues, and communicate outcomes.

Quick Start

Validate a failing task by performing an end-to-end debugging cycle and reporting a verified resolution.

Frequently Asked Questions about pua-debugging

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

FAQPage Schema
How do I systematically debug recurring failures instead of just fixing the first error?

Systematic debugging requires enforcing proactive ownership and root-cause analysis. You must gather evidence, create minimal reproductions, and perform cross-checks to uncover the true source of failures rather than addressing surface symptoms.

What is the best way to ensure a verified fix for code and configuration failures?

To ensure a verified fix, apply end-to-end ownership throughout your debugging workflow. This means validating resolutions through thorough verification and checking for related issues across code, configuration, and deployment workflows before declaring completion.

How do I perform root-cause analysis when a deployment failure occurs?

Root-cause analysis for deployment failures involves proactive discovery and expanding investigations beyond the initial error. You must gather evidence, establish a minimal reproduction, and perform cross-checks across data workflows to isolate the origin.

Can I apply a repeatable debugging workflow to both code and data pipeline issues?

Yes, you can apply a repeatable five-step debugging workflow to both code and data pipeline issues. This systematic approach enforces evidence gathering and proactive verification across diverse environments to achieve verifiable resolutions.

Why do my debugging fixes repeatedly fail after deployment?

Debugging fixes fail when teams lack end-to-end ownership and declare completion prematurely. Resolving this requires thorough validation, cross-checks, and verifying the fix against a minimal reproduction before deployment to ensure the root cause is eliminated.

Does systematic debugging require checking for related issues after finding a root cause?

Yes, systematic debugging requires checking for related issues after finding a root cause. Proactive discovery means expanding investigations beyond the first error to ensure comprehensive diagnosis and verifying that related configurations or data workflows are unaffected.