What problem does it solve? Investigating a reported bug and turning it into an actionable, well-scoped issue is time-consuming and often skipped, leaving maintainers with vague reports. This Skill automates the triage workflow: it explores the codebase to find the root cause and files a GitHub issue that a downstream agent or human can implement directly. ## Core Features & Use Cases - Root Cause Investigation: Explores the codebase (via subagents or manual search) to trace the failing code path, review related tests, and check recent changes. - Two-Role Label Taxonomy: Assigns a category label (bug or enhancement) and a state label (e.g. needs-triage, ready-for-agent) following a canonical triage state machine. - TDD Fix Plan Generation: Produces ordered RED-GREEN test cycles that assert on observable behavior rather than implementation details, so the plan survives refactors. - Use Case: A user reports "the export button silently fails on empty datasets." The Skill investigates the export code path, identifies the missing empty-state handling, and creates a ready-for-agent GitHub issue with a TDD fix plan via gh issue create. ## Quick Start Ask the agent to triage the bug you are seeing and file a GitHub issue with a fix plan.
