coach: Skill for Claude Code

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]

## Reproduction Steps

1. [First step to reproduce]
2. [Second step to reproduce]
3. [Third step to reproduce]
   ...

## Environment

- **OS**: [Operating system and version]
- **Browser/Runtime**: [Browser or Node.js version]
- **Version**: [Application or package version]

## Technical Details

- **Component**: [Affected component/module/file]
- **Severity**: [Critical/High/Medium/Low]
- **Affected Users**: [Scope of impact]

## Findings and Insights

### Root Cause Analysis

[Detailed technical analysis from the debugging session, explaining why the bug occurs]

### Code Locations

[Specific files, functions, and line numbers where the issue manifests]

### Potential Impact

[Description of how this bug affects users and system behavior]

### Dependencies Affected

[Other components or systems that may be impacted]

## Recommended E2E Test

```typescript
describe('Bug Fix Verification', () => {
  it('should [expected behavior after fix]', async () => {
    // Arrange: Set up test conditions
    // Act: Execute the action that previously triggered the bug
    // Assert: Verify the bug is fixed
  })
})
```