cs-issue-report

Guides structured bug reporting through five questions and produces a reproducible issue report document.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/wildlily1021/XW_Software --skill cs-issue-report-wildlily1021
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cs-issue-report
Source: https://github.com/wildlily1021/XW_Software/tree/main/.agents/skills/cs-issue-report
Command: npx skills add https://github.com/wildlily1021/XW_Software --skill cs-issue-report-wildlily1021

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When users report bugs verbally, key details like reproduction steps, expected versus actual behavior, and severity often get lost or mixed with premature root-cause guesses. This Skill turns a vague complaint into a structured, traceable {slug}-report.md file that downstream root-cause analysis can rely on. ## Core Features & Use Cases - Five-question guided intake: Asks about symptoms, reproduction steps, expected vs actual behavior, environment, and severity one at a time, with ambiguity checks that force concrete answers. - Fast-track triage: Reads the relevant code early to decide whether the issue qualifies for a quick fix path (single root cause, 1-2 line change) or needs the standard full-report workflow. - Structured report generation: Produces a Markdown issue report with YAML frontmatter (doc_type, severity, summary, tags) and explicit exit criteria before handoff to the analysis phase. - Use Case: A user says "the submit button sometimes shows a blank popup." The Skill walks them through reproduction conditions, records expected vs actual behavior separately, assigns a P1 severity, and writes a confirmed issue report ready for root-cause analysis. ## Quick Start Tell the assistant "I found a bug, help me file an issue" and describe the symptom you observed.

Frequently Asked Questions about cs-issue-report

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

FAQPage Schema
How do I write a good bug report with an AI assistant?▼

Describe the observed symptom first, then answer guided questions about reproduction steps, expected versus actual behavior, environment, and severity one at a time. The assistant records only observable phenomena and produces a structured Markdown report with frontmatter.

What information should a reproducible bug report contain?▼

A reproducible bug report needs the concrete symptom, minimal reproduction steps with frequency, expected behavior stated separately from actual behavior, environment details like module and relevant files, and a severity level from P0 to P3.

When should a bug skip full analysis and go straight to a fix?▼

A bug qualifies for a fast-track fix when reading the code reveals a single obvious root cause at a specific file and line, the change is one or two small edits, and there is no cross-module impact risk. Otherwise it follows the standard reporting path.

Why should bug reports avoid root-cause speculation?▼

Root-cause guesses recorded in the report bias the later analysis phase toward wrong leads. The report should note user suspicions only as clues, while actual root causes are confirmed by reading code in a separate analysis stage.

What if a bug cannot be reproduced consistently?▼

Unstable reproduction is a valid answer. Record the known trigger conditions and approximate reproduction rate, or state that it was observed once under specific circumstances, rather than inventing unreliable steps.