bug-reproduction-brief
Turn a vague, intermittent, or environment-specific bug report into a minimal evidence-backed reproduction before proposing a fix.
Profile →npx skills add github/awesome-copilot --skill bug-reproduction-brief --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Bug Reproduction Brief Use this skill when a bug report is incomplete, intermittent, environment-specific, or mixed with an assumed cause. The goal is to prove the smallest observable failure before diagnosis or repair begins. ## 1. Record the observed failure Capture the exact error, incorrect output, timestamp, affected route or command, and the smallest known input. Preserve relevant logs without secrets or personal data. Label second-hand descriptions as unverified. ## 2. Identify the environment Record only facts you can inspect: - repository and commit; - runtime and package-manager versions; - operating system or container; - dependency lockfile; - relevant feature flags; - whether the target is local, test, staging, or production. Never guess credentials or production configuration. ## 3. Separate expected from actual behaviour Write two explicit observable statements: ```text Expected: [observable result] Actual: [observable result, including status or error] ``` Do not put the suspected cause in either statement. ## 4. Reduce the reproduction Start from the reported path, then remove unrelated data, services, and steps one at a time. Keep the smallest fixture that still
- 1. Record the observed failure
- 2. Identify the environment
- 3. Separate expected from actual behaviour
- 4. Reduce the reproduction
- 5. Prove repeatability
- 6. Stop before repair
- Output
- Safety boundaries
- Example prompt
- Source and licence
What does the bug-reproduction-brief skill do?
Turn a vague, intermittent, or environment-specific bug report into a minimal evidence-backed reproduction before proposing a fix.
How do I install it?
Run `npx skills add github/awesome-copilot --skill bug-reproduction-brief --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.