qa-debugging

Apply structured debugging workflows to reproduce production bugs locally.

73|16|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/vasilyu1983/AI-Agents-public --skill qa-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-debugging
Source: https://github.com/vasilyu1983/AI-Agents-public/tree/main/frameworks/claude-code-kit/framework/skills/qa-debugging
Command: npx skills add https://github.com/vasilyu1983/AI-Agents-public --skill qa-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides practical debugging workflows, logging strategies, and root-cause analysis patterns.

Core Features & Use Cases

  • Troubleshooting playbooks: Structured steps for crashes, slowness, and distributed issues.
  • Logging & tracing: Structured logs and OpenTelemetry practices.
  • Templates: Copy-paste debugging templates and runbooks.

Quick Start

Apply a structured debugging workflow to reproduce a production bug in a local environment.

Frequently Asked Questions about qa-debugging

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

FAQPage Schema
How do I debug a production bug in a local environment?

Debugging production bugs locally involves reproducing the issue using structured logging and distributed tracing data from your production environment. Apply a systematic workflow: collect logs and traces, isolate the failure conditions, reproduce locally, then validate your fix against the same traces to confirm root cause.

What's the best way to structure logging for troubleshooting?

Structured logging captures key context—timestamps, request IDs, error states—in machine-readable format, enabling faster root-cause analysis across your application. Use consistent field naming, correlation IDs for distributed requests, and log levels that distinguish between informational events and actionable errors.

How do I troubleshoot performance issues and slowness in production?

Performance troubleshooting combines profiling data, distributed traces, and structured logs to identify bottlenecks. Collect execution timings, resource usage, and call graphs; correlate slow transactions with infrastructure metrics to pinpoint whether slowness originates in application code, databases, or external services.

Can I use OpenTelemetry for debugging across multiple services?

OpenTelemetry enables distributed tracing and structured logging across microservices and languages. Instrument your services to emit traces and metrics; correlate events across service boundaries using trace IDs, giving you end-to-end visibility into distributed system failures and latency.

What's the difference between debugging locally versus production incidents?

Local debugging reproduces failures in a controlled environment with full access to code and tools. Production incident debugging relies on logs, traces, and observability data collected live, requiring root-cause analysis from incomplete information and faster resolution under operational pressure.

Do I need error tracking tools for effective debugging workflows?

Error tracking aggregates exceptions, stack traces, and occurrence patterns across deployments, accelerating triage and identifying systemic issues. Combined with structured logging and distributed tracing, it provides the observability foundation for both reactive debugging and proactive monitoring.