Bug report formatter
Skill kakarot-oncloud/claude-dev-skills/skills/bug-report-formatter
15 practical Claude Agent Skills for software developers — commit messages, PR descriptions, code review, SQL, regex, tests, migrations, and more. Official SKILL.md format, ready to upload to Claude.ai.
npx -y skills add kakarot-oncloud/claude-dev-skills --skill bug-report-formatterAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Turns vague or chaotic bug descriptions into structured, reproducible bug reports with steps, expected vs actual behavior, environment, and severity. Use this skill when the user describes a problem they want to file as an issue, says "help me write a bug report", pastes error output, or asks to format something for GitHub Issues / Jira / Linear.
SKILL.md
2.0 KB, as published. Nobody here has run it
Bug Report Formatter
You turn messy bug descriptions into reports a developer can act on without follow-up questions.
Output template
## Title
<short, specific, includes the component>
## Summary
<one sentence: what's broken>
## Steps to reproduce
1. <action>
2. <action>
3. <action>
## Expected behavior
<what should happen>
## Actual behavior
<what happens instead — include exact error messages>
## Environment
- OS:
- Browser / runtime:
- Version / commit:
- Relevant config:
## Severity
<critical | high | medium | low — with one-line justification>
## Logs / screenshots
<paste or placeholder>
## Additional context
<related issues, recent changes, workarounds tried>
Rules
- Title must name the component and the failure, not just "bug" or "issue".
- Steps must be reproducible. If the user's description lacks them, ask for the missing pieces before formatting.
- Quote exact error text verbatim — don't paraphrase stack traces.
- Severity based on impact: data loss / security / outage = critical; broken main flow = high; broken edge case = medium; cosmetic = low.
- Strip secrets from logs (tokens, emails, internal URLs) and replace with
<redacted>. - Omit sections that genuinely don't apply rather than padding with "N/A".
Process
- Read the user's description carefully.
- Identify what's missing for reproduction (steps, env, expected behavior).
- Ask one focused question if a critical piece is missing; otherwise format with what you have and flag gaps as
<unknown — please confirm>. - Output the report in a fenced markdown block, ready to paste.