What do I need to use Bug Report?

What's wrong; Steps to reproduce; Environment; Evidence.

Is Bug Report free to use?

Yes — run it free in the browser playground (no API key needed for the sponsored trial, or bring any provider key), or install it into Claude Code, Cursor, ChatGPT and more via npx pm-claude-skills. MIT-licensed and open source.

Bug Report

Q: How do I know the Bug Report output is good?

The skill verifies itself against its own quality checks: The title is specific enough to identify the bug at a glance; Steps reproduce from a known starting state and note frequency (consistent vs. intermittent); Expected vs. actual are both explicit and the actual is the observable failure; Environment (versions, role, data) is captured — the usual reason a bug "can't be reproduced".

🔵 Stable🕐 updated 2026-06-30 🔷 SkillSpec L3 pm-qa

Write a clear, reproducible bug report that gets fixed fast. Use when asked to write a bug report, file a defect, report an issue, or turn 'it's broken' into an actionable ticket. Produces a structured report — a precise title, steps to reproduce, expected vs. actual, environment, severity/priority, and evidence — so a developer can reproduce and fix it without a back-and-forth.

▶ Run it free — no key needed 📝 Grade your existing draft View SKILL.md ↗

What to give it

▸What's wrong — what you did, what happened, and what you expected instead.

▸Steps to reproduce — the exact sequence (and whether it's consistent or intermittent).

▸Environment — device, OS, browser/app version, account/role, and any relevant data state.

▸Evidence — screenshots, a screen recording, console/network errors, logs, request IDs.

✅ The bar it holds itself to

Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.

✓The title is specific enough to identify the bug at a glance

✓Steps reproduce from a known starting state and note frequency (consistent vs. intermittent)

✓Expected vs. actual are both explicit and the actual is the observable failure

✓Environment (versions, role, data) is captured — the usual reason a bug "can't be reproduced"

✓Severity (impact) is separated from priority (urgency)

✓Observed facts are kept separate from suspected cause; evidence is referenced

⚠️ What it refuses to do

Do not write "doesn't work" — state the exact action, expectation, and observed failure

Do not omit environment/version — it's the top reason bugs aren't reproducible

Do not merge expected and actual into one sentence — keep them distinct

Do not present a guessed cause as fact — label hypotheses

Do not bundle several bugs in one report — one defect per ticket

Install

npx pm-claude-skills add --agent claude   # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp

Related skills

🔌 Embed this skill

Drop this on your blog, docs, or site — it renders a "Run this skill" card:

<div data-pm-skill="bug-report"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>

💬 Discussion

Bug Report is one of 750 open-source professional AI agent skills — all SkillSpec L3. Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog