pua-debugging

Apply a five-step diagnostic process to resolve stubborn task failures.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When tasks fail repeatedly or you are about to give up, this Skill provides a structured, proactive approach to debugging, preventing stagnation and encouraging owner-driven resolution.

Core Features & Use Cases

  • Proactively push through failures with a structured debugging workflow that prioritizes end-to-end ownership.
  • Apply a five-step diagnostic method: observe error signals, search for root causes, inspect relevant code, verify environment assumptions, and invert hypotheses to validate solutions.
  • Use cases include flaky CI failures, intermittent API errors, and configuration drift where established fixes must be verified across related modules.

Quick Start

Describe the failure scenario and immediately begin the five-step debugging workflow to drive an end-to-end 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 intermittent API errors and flaky CI failures?

Systematically debug intermittent API errors and flaky CI failures by applying a structured five-step diagnostic workflow: observe error signals, search root causes, inspect code, verify environment assumptions, and invert hypotheses. This enforces end-to-end ownership for durable resolution.

What is the best way to troubleshoot configuration drift across related modules?

The best way to troubleshoot configuration drift is using a proactive diagnostic method that verifies environment assumptions and validates fixes across related modules. This ensures established corrections hold up end-to-end rather than just patching isolated symptoms.

Why does my task keep failing repeatedly and how can I push through stagnation?

Tasks keep failing repeatedly when root causes remain unverified. Push through stagnation by adopting a proactive debugging workflow that enforces owner accountability, inspects relevant code, and inverts hypotheses to validate solutions end-to-end.

Can I use a structured debugging workflow for complex incident response scenarios?

Yes, you can use this structured debugging workflow for complex incident response scenarios. It applies a five-step diagnostic process to observe signals, search root causes, and verify fixes end-to-end while maintaining owner accountability across teams.

When should I invert hypotheses to validate a debugging solution?

Invert hypotheses to validate a debugging solution after observing error signals, searching root causes, inspecting code, and verifying environment assumptions. This final step confirms the fix end-to-end and prevents regression in flaky pipelines or configuration drift.

Does proactive troubleshooting require specific dependencies or environment setup?

No specific dependencies are required. Proactive troubleshooting relies on a systematic five-step workflow that enforces owner accountability, making it applicable directly to software debugging, incident response, and complex configuration issues across existing pipelines.