report-bug

Interview the user and file a structured bug issue on the GitHub tracker.

20|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reddb-io/red-skills --skill report-bug-reddb-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: report-bug
Source: https://github.com/reddb-io/red-skills/tree/main/plugins/dev/skills/engineering/report-bug
Command: npx skills add https://github.com/reddb-io/red-skills --skill report-bug-reddb-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Capturing a bug on the project tracker usually means stopping your work, remembering repro details, and writing a well-formed issue by hand. This Skill runs a short structured interview, mines the current conversation for error messages and context, and files a complete type:bug issue via the GitHub CLI without leaving the terminal. ## Core Features & Use Cases - Guided bug interview: Asks one numbered question at a time to fill every field of the issue template, including severity branches and reproduction steps. - Conversation seeding: When invoked with no argument, scans recent conversation context for stack traces, failing commands, and file paths to pre-fill the symptom. - Disciplined filing: Creates the issue with gh issue create using exactly the type:bug and needs-triage labels, sanitizes secrets from the body, and hands off to /triage for prioritization. - Use Case: You hit a crash mid-session and say "this is broken — file it". The Skill extracts the error from the conversation, asks a few clarifying questions, and opens a labeled issue with a clean title and full repro context. ## Quick Start Ask the assistant to report a bug describing the symptom you observed, then answer the follow-up questions and confirm to file the issue.

Frequently Asked Questions about report-bug

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

FAQPage Schema
How do I file a GitHub issue from the command line?▼

Use the GitHub CLI with gh issue create, passing a title, body, and labels. This Skill builds the title and body from an interview, then runs gh issue create with the type:bug and needs-triage labels, passing the body via heredoc to preserve newlines.

How to write a good bug report with reproduction steps?▼

A good bug report states what happened, what should happen, numbered reproduction steps, environment context, and severity. This Skill interviews you field by field and writes unknown or no clean repro yet instead of inventing details you cannot supply.

Can I report a bug without leaving my chat session?▼

Yes. Invoke the skill with a symptom or no argument at all; it mines the recent conversation for error messages, stack traces, and file paths, asks only for missing fields, and files the issue through gh without opening a browser.

Does this skill set priority or assign labels automatically?▼

No. It applies exactly two labels, type:bug and needs-triage, and never guesses priority. Routing, priority assignment, and agent-readiness labels are owned by the separate triage skill, which it suggests running afterward.

What happens if the bug labels do not exist in the repository?▼

If type:bug or needs-triage are missing, such as in a fresh checkout, the skill stops and tells you to run the setup skill first rather than creating the issue with incorrect or missing labels.