What is the recommended structure for a bug report?

The skill follows a strict format: Title, Environment, Severity, Steps to Reproduce, Expected Behavior, Actual Behavior, and Additional Context.

How does it handle bug tracking locally?

It uses a structured directory system (bugs/) with a sequential naming convention (BUG-001) to keep your project's defect documentation organized.

How does this skill help developers fix bugs faster?

It ensures every report contains essential technical context, including environment details and exact reproduction steps, which eliminates the time wasted on clarifying vague reports.

Can I use this for production environment issues?

Yes, the template includes specific sections for environment data (OS, version, browser) to ensure the bug is documented within its specific context.

Professional Bug Reporting

Name: Professional Bug Reporting
Author: jkappers

byjkappers

0•

セキュリティとテスト

Generates structured, actionable bug reports with precise reproduction steps and standardized severity classifications.

This skill equips Claude with a rigorous framework for documenting software defects, ensuring that engineering teams receive the exact technical context needed to reproduce and fix issues. By enforcing a standardized structure—including environment details, impact-based severity levels, and clear expected vs. actual behavior—it eliminates the ambiguity and 'it works on my machine' friction often found in defect tickets. It is an essential tool for QA engineers and developers who want to maintain a high-quality project backlog and streamline the communication loop between testing and development.

主な機能

010 GitHub stars

02Standardized templates for environment, severity, and reproduction steps

03Guided creation of numbered, objective reproduction sequences

04Categorized impact assessment (Critical, High, Medium, Low)

05Automated bug ID tracking and organized directory management

06Anti-pattern detection to prevent vague or combined reports

ユースケース

01Creating high-quality GitHub issues or Jira tickets during manual testing

02Converting messy user feedback into professional technical defect reports

03Maintaining a local repository of known issues with a standardized naming convention

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jkappers/claude-code-software-delivery-plugin writing-bugs

For use in Claude.ai and ChatGPT

Download Skill