skills.rest
andrew-t-james
andrew-t-jamesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

bugreport

Creates a structured bug report with product, steps, evidence, and severity.

Updated Jul 3, 2025
Search Tags:#evidence#linear#issue-tracking#repro-steps#bugreport#field-engineer
One-click install
npx skills add https://github.com/andrew-t-james/dotfiles --skill bugreport-andrew-t-james
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bugreport
Source: https://github.com/andrew-t-james/dotfiles/tree/main/dot_claude/skills/bugreport
Command: npx skills add https://github.com/andrew-t-james/dotfiles --skill bugreport-andrew-t-james

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables quick capture of structured bug reports that include product context, reproduction steps, evidence, severity, and environment, so engineers can triage and assign issues faster.

Core Features & Use Cases

  • Ask questions one at a time and gather consistent details without requiring a git repo.
  • Generate a Linear issue when Linear MCP is available, or output a ready-to-paste Markdown report otherwise.
  • Map severity to standard priorities and collect evidence, steps, and environment for rapid triage.

Quick Start

Run the bugreport skill to begin capturing a structured bug report from a field engineer.

Frequently Asked Questions about bugreport

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

FAQPage Schema
How do I capture structured bug reports with reproduction steps and severity without accessing a git repo?▼

You can capture structured bug reports without a git repo by running a one-question-at-a-time flow that gathers product context, reproduction steps, evidence, severity, and environment details for immediate triage.

Can I create a Linear issue directly from a bug report?▼

Yes, you can create a Linear issue directly from a bug report when the Linear MCP integration is available, automatically mapping severity to standard priorities for immediate assignment.

What is the best way to format a bug report for manual entry into an issue tracker?▼

The best way to format a bug report for manual entry is to generate a ready-to-paste Markdown document containing product context, reproduction steps, evidence, and severity when Linear integration is unavailable.

How does a one-question-at-a-time bug report flow help field engineers?▼

A one-question-at-a-time bug report flow helps field engineers by guiding them through capturing consistent product context, environment, and reproduction steps without requiring technical knowledge of the codebase.

Does bugreport work without a Linear integration or repository?▼

Yes, bugreport works without a Linear integration or repository by outputting a formatted Markdown report with all captured details ready for manual entry into any issue-tracking system.

What severity and priority mapping is included in a structured bug report?▼

Structured bug reports include severity levels mapped to standard issue priorities, ensuring engineers can immediately triage and assign issues without needing additional clarification.

Related Skills

Explore More Software Engineering Skills→
acta0724acta0724

board

Retrieves Linear project issues grouped by status into a Kanban-style board with priority mapping.

Community
Intermediate
officebeatsofficebeats
8

bug-chaser

Triage bug reports into engineering tickets with validated reproduction steps.

Community
Advanced
qsdrqsqsdrqs
3

debugger

Reproduce software issues and collect logs to verify root causes.

Community
Advanced
CENKSSSCENKSSS

bug-reporting-excellence

Create structured bug reports with severity assessment and automated triage.

Community
Advanced