debug-issue

Analyzes timeline and debug metadata to isolate earliest failing signal for issue triage.

43|2|Updated Jan 25, 2024
One-click install
npx skills add https://github.com/glowingkitty/OpenMates --skill debug-issue-glowingkitty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-issue
Source: https://github.com/glowingkitty/OpenMates/tree/main/.agents/skills/debug-issue
Command: npx skills add https://github.com/glowingkitty/OpenMates --skill debug-issue-glowingkitty

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers investigate a user-submitted issue by correlating timeline and debug metadata to pinpoint the first anomaly and guide a minimal code fix.

Core Features & Use Cases

  • Forensic triage with trace correlation: Delegates to an issue-forensics subagent to run targeted debug.py issue --timeline checks, correlate browser↔backend events, and identify the first anomaly.
  • Root-cause hypothesis and actionable suspects: Produces structured JSON including first_anomaly, root_cause_hypothesis, suspect_files, and relevant reproduction steps plus recent related commits.
  • Optional encryption/sync invariant tracing: If the symptom suggests an encryption/decryption/chat sync fault, it triggers an encryption-flow-tracer pass to localize the broken invariant.

Quick Start

Launch the skill with the issue identifier you want to investigate, then use the returned suspect files and hypothesis to apply a minimal fix and confirm it with the provided debug cleanup command.

Frequently Asked Questions about debug-issue

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

FAQPage Schema
How do I find the root cause of a production incident using timeline debug metadata?

To find the root cause of a production incident, this skill analyzes timeline debug metadata to correlate browser and backend events, isolating the earliest failing signal. It delegates to an issue-forensics subagent to pinpoint the first anomaly and generate a structured hypothesis.

How do I triage chat sync or encryption issues using debug timeline forensics?

To triage chat sync or encryption issues, the skill runs debug timeline forensics and optionally triggers an encryption-flow-tracer pass. This localizes broken invariants and returns a structured JSON output containing the root cause hypothesis and suspect files.

Can I identify suspect files and recent commits for an issue without manual git blame?

Yes, you can identify suspect files and recent commits without manual git blame because the skill automates issue triage. It returns structured JSON containing suspect files, relevant reproduction steps, and recent related commits to guide your fix.

What is the best way to implement a minimal corrective patch after issue triage?

The best way to implement a minimal corrective patch is to use the structured JSON output from the issue triage. You apply fixes to the identified suspect files based on the root cause hypothesis, then confirm the fix with the provided debug cleanup command.

Does issue triage work with both frontend and backend event correlation?

Yes, issue triage works with both frontend and backend event correlation. The investigation process correlates browser and backend events from timeline debug metadata to isolate the earliest failing signal across general backend and frontend symptom patterns.