report-bug

Generate bug reports from raw descriptions using project context and defaults.

1|Updated Jul 5, 2026
One-click install
npx skills add https://github.com/stoodder/materia --skill report-bug-stoodder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: report-bug
Source: https://github.com/stoodder/materia/tree/main/plugins/materia/skills/report-bug
Command: npx skills add https://github.com/stoodder/materia --skill report-bug-stoodder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, CLAUDE.md, MATERIA.md, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of reporting bugs by automatically generating detailed bug reports from minimal input, saving time and reducing errors.

Core Features & Use Cases

  • Bug Report Generation: Drafts a complete bug report with default values, minimizing manual input and ensuring comprehensive information.
  • Project Context Awareness: Uses project-specific context (e.g., CLAUDE.md, glossary, surface-map) to provide relevant defaults and accurate reports.
  • Interactive Confirmation: Allows operators to confirm or adjust the report before finalizing and opening a pull request.

Quick Start

Use the /materia:report-bug <description text> command to generate a bug report for a specific issue.

Frequently Asked Questions about report-bug

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

FAQPage Schema
How do I generate a bug report from a raw description in Git?

You can generate a bug report from a raw description by using project context from CLAUDE.md and MATERIA.md to automatically fill defaults. The system drafts comprehensive issue tracking documentation suitable for quality assurance workflows.

What project context is needed to automate bug reporting?

Automating bug reporting requires project context from CLAUDE.md, MATERIA.md, and Git integration. This context provides the necessary glossary and surface-map data to ensure the generated bug report contains accurate default values.

Does this automated bug reporting workflow require Git?

Yes, this automated bug reporting workflow requires Git integration to function properly. It also requires MATERIA.md documentation to analyze project context and generate comprehensive issue tracking reports from minimal input.

Can I review and adjust a generated bug report before creating a pull request?

Yes, you can review and adjust the generated bug report through interactive confirmation before finalizing. This allows operators to modify the default values and ensure the issue tracking documentation is accurate before opening a pull request.

What is the best way to streamline issue tracking for quality assurance workflows?

The best way to streamline issue tracking for quality assurance is to generate bug reports from minimal input using project context awareness. This approach minimizes manual data entry and reduces errors by leveraging defaults from CLAUDE.md and Git.