skunexus-bug-hunt

Investigate bug reports into evidence-backed verdicts with proposed fixes and acceptance criteria.

Updated Jul 14, 2026
One-click install
npx skills add https://github.com/SkuNexus-Devs/skunexus-ai --skill skunexus-bug-hunt-skunexus-devs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skunexus-bug-hunt
Source: https://github.com/SkuNexus-Devs/skunexus-ai/tree/main/skills/skunexus-bug-hunt
Command: npx skills add https://github.com/SkuNexus-Devs/skunexus-ai --skill skunexus-bug-hunt-skunexus-devs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Bug reports often arrive ambiguous, and jumping straight to a fix risks solving the wrong problem. This Skill turns a Jira bug ticket or a chat-described misbehavior into a developer-approved investigation document with an evidence-backed verdict, so downstream planning and implementation work from a confirmed diagnosis instead of a guess. ## Core Features & Use Cases - Structured intake and interview: Fetches and distills Jira tickets via the Atlassian MCP, then runs a focused clarifying interview to pin down expected behavior, actual behavior, and a concrete reproduction anchor. - Static evidence-based investigation: Traces the causal path through backend code, builds the platform mental model via the skunexus-docs-c7 skill, and performs git archaeology (log, blame) to distinguish defects from deliberate behavior. - Four explicit verdicts with handoff: Produces one of confirmed bug (with proposed fix and testable acceptance bullets), feature change request, works as designed, or cannot confirm statically, each routed to the right downstream skill after explicit developer approval. - Use Case: A QA engineer files "orders are stuck in status Y" as PHG-456. Say "investigate PHG-456" and the Skill distills the ticket, interviews you, traces the state machine code, and delivers an approved investigation.md with a proposed fix and acceptance criteria ready for the implementation skill. ## Quick Start Ask the AI to investigate PHG-456 and produce an evidence-backed verdict in an investigation document.

Frequently Asked Questions about skunexus-bug-hunt

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

FAQPage Schema
How do I investigate a Jira bug ticket with Claude Code?

Say something like "investigate PHG-456" and the Skill fetches the ticket via the Atlassian MCP, distills it into a bug summary, interviews you to pin down the symptom, then traces the code and git history. It finishes with an investigation.md containing a verdict you must explicitly approve.

How to investigate a bug that has no Jira ticket?

Describe the issue directly in chat, including any suspected fix. The Skill asks whether a ticket exists, and if not, asks for a short slug to name the .ai/<slug>/ folder, then runs the same interview and static investigation workflow.

Does the bug investigation run code or database queries?

No, the investigation is strictly static: it reads code, builds the platform model via skunexus-docs-c7, and does git archaeology. Runtime facts become precise checks for the developer to run, such as a SQL query or log pull, whose results return as evidence.

What happens after the bug investigation is approved?

The handoff depends on the verdict: a trivial confirmed bug goes to skunexus-backend-implement, a complex one to skunexus-backend-plan, a change request to skunexus-jira-prd, and works-as-designed ends with no build. The Skill never implements or plans itself.

When should I not use the bug investigation workflow?

Do not use it for scoping a feature (use skunexus-jira-prd), implementing an already-diagnosed fix (skunexus-backend-implement), planning an agreed fix (skunexus-backend-plan), or pure how-does-X-work curiosity with nothing broken (skunexus-docs-c7).