bug-report

Generates structured Jira defect tickets with reproduction steps, severity, and traceability fields.

5|2|Updated May 19, 2026
One-click install
npx skills add https://github.com/civitas-cerebrum/achilles --skill bug-report-civitas-cerebrum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-report
Source: https://github.com/civitas-cerebrum/achilles/tree/main/skills/bug-report
Command: npx skills add https://github.com/civitas-cerebrum/achilles --skill bug-report-civitas-cerebrum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a bug report that developers can act on without follow-up questions is hard: missing environment details, vague actual results, and inconsistent severity ratings slow down triage and fixes. This Skill turns raw evidence (screenshots, logs, test output) into a complete, standardized defect ticket. ## Core Features & Use Cases - Evidence-first extraction: Pulls failure details from screenshots, recordings, console logs, and failing assertions before asking the user anything, then collects all missing fields in a single message. - Structured ticket template: Produces a full Jira-ready report with summary, environment, device/browser, numbered reproduction steps, expected vs actual results, attachments, severity, priority, and traceability fields (Finding ID, journey, build/commit, reproduction test). - Severity and priority guidance: Suggests severity from concrete rules (crash/data loss → Critical, cosmetic → Low) and pre-fills priority from the bug-discovery severity × journey-tier matrix, always requiring user confirmation. - Use Case: After an automated test run flags a failing login flow, hand the assertion output and screenshot to the agent and receive a pre-filled, confirmation-gated bug ticket with verbatim error messages and credential-store references instead of plaintext secrets. ## Quick Start Ask the agent to file a bug report for the failing checkout flow using the attached screenshot and console log.

Frequently Asked Questions about bug-report

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

FAQPage Schema
How do I write a good bug report for Jira?

A good Jira bug report includes a location-based summary, third-person description, environment URL, device and browser versions, numbered reproduction steps starting from app launch, separate expected and actual results, attachments, and severity and priority. This Skill pre-fills all of these fields from your evidence and asks for confirmation before finalizing.

How to write steps to reproduce a bug?

Steps to reproduce should start from zero, meaning app launch or page load, and assume the reader has no prior context. Number each action sequentially and end with an observation step describing what happens, so any developer can recreate the defect without follow-up questions.

What is the difference between severity and priority in bug reports?

Severity measures how badly the bug breaks the system, while priority measures how urgently it needs fixing. A crash in a rarely used area can be high severity but low priority, and a homepage typo during a campaign can be low severity but high priority.

Can I include test account credentials in a bug ticket?

Never paste plaintext passwords, API keys, or tokens into a ticket body, attachment, or comment. Reference the credential store or the .env key name instead, such as STAGING_QA_USER / STAGING_QA_PASSWORD, so developers look up the secret from the named source.

What should the actual result section of a bug report contain?

The actual result should state exactly what happened using objective facts, quoting error messages verbatim and referencing specific file names. Avoid subjective phrases like "it's broken" and never mix the actual result with the expected behavior.