| name | report-bug |
| description | Automatically generate and post detailed bug reports to GitHub Issues for the active project repository. This skill should be used when documenting bugs discovered during development, creating professionally formatted GitHub Issues with reproduction steps, technical insights, and recommended E2E tests. |
Report Bug Skill
Automatically generate comprehensive, professional bug reports and post them directly to the GitHub repository associated with the current working directory.
Purpose
This skill automates the creation of detailed bug reports that include:
- Clear, concise issue titles
- Step-by-step reproduction instructions
- Technical analysis and root cause insights
- Recommended E2E test specifications
- Professional formatting suitable for team collaboration
When to Use This Skill
Use this skill when:
- Documenting a bug discovered during development or testing
- Creating a GitHub Issue to track a problem
- Generating a professional bug report with reproduction steps
- Providing E2E test recommendations for verification
- Ensuring consistent bug reporting standards across the team
Workflow
1. Repository Detection
Detect the Git repository in the current working directory:
- Extract the repository owner and name from the remote origin URL
- Validate that the repository is a GitHub repository
- Handle both HTTPS and SSH remote URL formats
2. Bug Report Generation
Create a comprehensive bug report following this structure:
Issue Title: Clear, concise summary (max 80 characters)
Issue Body:
## Summary
[Clear description of the issue including what went wrong and expected behavior]
[First step to reproduce]
[Second step to reproduce]
[Third step to reproduce]
...
: [Operating system and version]
: [Browser or Node.js version]
: [Application or package version]
: [Affected component/module/file]
: [Critical/High/Medium/Low]
: [Scope of impact]
[Detailed technical analysis from the debugging session, explaining why the bug occurs]
[Specific files, functions, and line numbers where the issue manifests]
[Description of how this bug affects users and system behavior]
[Other components or systems that may be impacted]
