bug-capture

Convert user bug reports into detailed GitHub issues with evidence and diagnosis.

228|68|Updated Sep 27, 2023
One-click install
npx skills add https://github.com/SwitchbackTech/compass-calendar --skill bug-capture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-capture
Source: https://github.com/SwitchbackTech/compass-calendar/tree/main/.agents/skills/bug-capture
Command: npx skills add https://github.com/SwitchbackTech/compass-calendar --skill bug-capture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture a real bug as a GitHub issue with enough evidence for a later agent to fix it quickly: workflow, screenshot evidence, diagnosis, likely fix, and verification path.

Core Features & Use Cases

  • Gather reporter context (description, reproduction steps, environment state, logs, and attached screenshots) and translate it into a structured GitHub issue.
  • Diagnose and summarize the problem without altering product code, including confidence levels and reproduction status.
  • Publish a high-context issue with workflow details, evidence, diagnosis, a likely fix, and a verification path for QA and engineering teams.

Quick Start

Draft a GitHub issue from a bug report by providing evidence, context, reproduction steps, and a proposed fix.

Frequently Asked Questions about bug-capture

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

FAQPage Schema
How do I turn bug reports into high-context GitHub issues?

To generate GitHub issues from bug reports, provide reporter context, reproduction steps, environment state, and logs. The skill translates this input into a structured issue featuring diagnosis, a likely fix, and a verification path.

What evidence is needed to create a reproducible bug issue for software engineering?

Generating a reproducible bug issue requires gathering evidence like screenshots, logs, reproduction steps, and environment state. This high-context information enables accurate diagnosis and establishes a clear verification path for engineering teams.

Can I use bug reports from customer support channels to generate GitHub issues?

Yes, you can process bug reports from customer support channels to generate GitHub issues. The skill collects descriptions and environment state from these channels to produce high-context issues for QA and engineering workflows.

Does generating a GitHub issue from a bug report alter product code?

Generating a GitHub issue from a bug report does not alter product code. It strictly diagnoses and summarizes the problem, including confidence levels and reproduction status, to prepare a high-context issue for later resolution.

What is the best way to document reproduction steps and diagnosis for a GitHub issue?

The best way to document reproduction steps and diagnosis is to articulate the reproducible bug into a structured format. This includes evidence collection, environment state, likely fix, and verification path within the GitHub issue.