Agent skill

Bug Reporting

by naodeng in naodeng/awesome-qa-skills

A skill your agent uses when you need to write clear, reproducible bug reports with steps, environment details, and evidence; triggers include bug reporting and defect reporting.

Custom licenceAuto-check passedTesting & QA

Install Bug Reporting

skills CLI
$ npx skills add naodeng/awesome-qa-skills --skill bug-reporting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install naodeng/awesome-qa-skills bug-reporting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/naodeng/awesome-qa-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/en/testing-types/bug-reporting .claude/skills/bug-reporting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bug-reporting
GitHub stars
245
Token cost
~617 tokens
SKILL.md length
296 words
Files
39 (incl. scripts, references)
Skills in repo
22
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses when you need to write clear, reproducible bug reports with steps, environment details, and evidence; triggers include bug reporting and defect reporting.

  • Works in 4 steps: Read and follow the main prompt listed… → Add only project context that changes… → If input is incomplete, return a usable… → …
  • You need to write clear
  • SKILL.md covers When to Use, Workflow, Core Constraints and Progressive Disclosure, plus 2 more sections
  • Reproducible bug reports with steps

What it does

Bug Reporting is an agent skill from naodeng/awesome-qa-skills. Use this skill when you need to write clear, reproducible bug reports with steps, environment details, and evidence; triggers include bug reporting and defect reporting.

Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. The skill folder holds 43 other files, including scripts and reference files (for example `README.md`, `agents/openai.yaml` and `evals/cases/basic-success.yaml`).

It sits in Testing & QA, covering QA and bug reports. The repository describes itself as: Awesome QA Skills is an open-source AI-native Quality Engineering skill system that helps engineering teams reason about, design, execute, evaluate, and continuously improve…

When your agent uses it

  • You need to write clear
  • Reproducible bug reports with steps
  • Environment details
  • Triggers include bug reporting and defect reporting

Example prompts

  • “/bug-reporting”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read and follow the main prompt listed under Progressive disclosure (coverage, structure, quality bar).
  2. Add only project context that changes the result: scope, environment, constraints, risks, dependencies, expected deliverable.
  3. If input is incomplete, return a usable first draft and explicitly mark assumptions and gaps.
  4. Default to Markdown; switch formats only when the user asks.

What it can do on your machine

Read from SKILL.md and the folder at commit 52c4eaf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bug Reporting loads about 617 tokens when it runs, and up to ~1k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 296 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~617
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 296 words (~617 tokens).

“Chinese version: See the corresponding Chinese skill.”

— opening of SKILL.md by naodeng, Custom licence
name
bug-reporting

Read the full SKILL.md on GitHub

Files

SKILL.md and 38 other files (scripts, references) in skills/en/testing-types/bug-reporting of naodeng/awesome-qa-skills.

  • SKILL.md
  • README.md
  • agents/openai.yaml
  • evals/cases/basic-success.yaml
  • evals/cases/edge-incomplete-input.yaml
  • evals/cases/edge-risk-priority.yaml
  • evals/eval.yaml
  • output-formats.md
  • output-templates/template-csv.csv
  • output-templates/template-excel.tsv
  • output-templates/template-json.json
  • output-templates/template-markdown.md
  • output-templates/template-word.md
  • output-templates/template-xmind.md
  • prompts/bug-reporting.md
  • quick-start.md
  • … and 23 more

Open the folder on GitHubat commit 52c4eaf

Compare with similar skills

Bug Reporting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bug Reporting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bug Reporting this skillnaodeng/awesome-qa-skills245—~617Automated safety check: PassCustom licence
Reproduce Chat Statesdifferent-ai/openwork24k—~673Automated safety check: PassCustom licence
Dynamo Jira TicketDynamoDS/Dynamo2k—~1.1kAutomated safety check: PassApache-2.0
Minimal Run And Auditlllllllama/RigorPilot-Skills4972 repos~691Automated safety check: PassMIT
Moav E2EMotherofallVPNs/MoaV448—~1.9kAutomated safety check: NotesMIT
Anchor Reprolynxlangya/techne1051 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • Reproduce Chat States

    different-ai/openwork

    Fires known chat states in the running OpenWork desktop app, such as provider errors, retries and tool steps, so you can check how each renders.

    24k GitHub stars~673 tokensUpdated today
    Testing & QAAuto-check passed
  • Dynamo Jira Ticket

    DynamoDS/Dynamo

    Create structured Jira tickets for Dynamo from bug reports, failing tests, or feature requests.

    2k GitHub stars~1.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Minimal Run And Audit

    lllllllama/RigorPilot-Skills

    Rigor Run skill for README-first deep learning repo reproduction.

    497 GitHub starsUsed in 2 repos~691 tokens
    Testing & QAAuto-check passed
  • Moav E2E

    MotherofallVPNs/MoaV

    Run and debug MoaV's end-to-end tests — real protocol connectivity (client-test.sh) and the moav CLI smoke test — against a LIVE server, via the self-hosted e2e workflow or a local test VPS.

    448 GitHub stars~1.9k tokensUpdated today
    Testing & QAAuto-check: notes
  • Anchor Repro

    lynxlangya/techne

    Reproduce a behavioral bug before fixing it, record the failing probe, and verify the fix with the same probe.

    105 GitHub starsUsed in 1 repo~1.2k tokens
    Testing & QAAuto-check passed
  • Creating A Coral Task

    Human-Agent-Society/CORAL

    Author a new CORAL task — the three pieces that must line up (task.yaml, seed/, a packaged grader/), the coral init → coral validate → smoke-test loop, and how to pick a grader pattern (stdout…

    1k GitHub stars~2.2k tokensUpdated 29 days ago
    Testing & QAAuto-check passed

More from naodeng/awesome-qa-skills

All 22 skills in this repo
  • Accessibility Testing

    naodeng/awesome-qa-skills

    A skill your agent uses when you need to design accessibility testing against WCAG, keyboard navigation, and assistive technology scenarios; triggers include accessibility testing and a11y testing.

    245 GitHub stars~665 tokensUpdated 12 days ago
    Auto-check passed
  • API Test Bruno

    naodeng/awesome-qa-skills

    A skill your agent uses when you need to parse multi-format API definitions and generate Bruno collections for executable regression; triggers include Bruno collections and Bruno API testing.

    245 GitHub stars~663 tokensUpdated 12 days ago
    Auto-check passed
  • API Test Pytest

    naodeng/awesome-qa-skills

    A skill your agent uses when you need to parse multi-format API definitions and generate Pytest API automation; triggers include Pytest API tests and API automation with Pytest.

    245 GitHub stars~655 tokensUpdated 12 days ago
    Auto-check passed
  • API Test Restassure

    naodeng/awesome-qa-skills

    A skill your agent uses when you need to parse multi-format API definitions and generate Rest Assured Java test classes; triggers include Rest Assured, RestAssured, and Java API automation.

    245 GitHub stars~658 tokensUpdated 12 days ago
    Auto-check passed
  • API Test Supertest

    naodeng/awesome-qa-skills

    A skill your agent uses when you need to parse multi-format API definitions and generate executable Supertest scripts; triggers include Supertest, Node.js API testing, and Supertest automation.

    245 GitHub stars~659 tokensUpdated 12 days ago
    Auto-check passed
  • API Testing

    naodeng/awesome-qa-skills

    A skill your agent uses when you need to design API test plans or cases for REST, GraphQL, or gRPC interfaces; triggers include API testing and API test cases.

    245 GitHub stars~636 tokensUpdated 12 days ago
    Auto-check passed

Categories

Questions about Bug Reporting

What does Bug Reporting do?

A skill your agent uses when you need to write clear, reproducible bug reports with steps, environment details, and evidence; triggers include bug reporting and defect reporting. Bug Reporting is an agent skill from naodeng/awesome-qa-skills. Use this skill when you need to write clear, reproducible bug reports with steps, environment details, and evidence; triggers include bug reporting and defect reporting.

When should I use Bug Reporting?

Bug Reporting fits situations like: you need to write clear; reproducible bug reports with steps; environment details; triggers include bug reporting and defect reporting.

How do I install Bug Reporting in Claude Code?

Run `npx skills add naodeng/awesome-qa-skills --skill bug-reporting -a claude-code`. Or copy the skill folder (skills/en/testing-types/bug-reporting in naodeng/awesome-qa-skills) into .claude/skills/bug-reporting in your project. Claude Code loads it when a task matches its description.

How do I install Bug Reporting in Codex?

Run `npx skills add naodeng/awesome-qa-skills --skill bug-reporting -a codex`. Or copy the skill folder (skills/en/testing-types/bug-reporting in naodeng/awesome-qa-skills) into .agents/skills/bug-reporting in your project. Codex loads it when a task matches its description.

Can I use Bug Reporting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add naodeng/awesome-qa-skills --skill bug-reporting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bug-reporting, .gemini/skills/bug-reporting, .github/skills/bug-reporting and .opencode/skills/bug-reporting in your project.

What does Bug Reporting need to run?

SKILL.md names no scripts, command-line tools or credentials: Bug Reporting is instructions for the agent only.

Does Bug Reporting access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bug Reporting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bug Reporting use?

Bug Reporting has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Bug Reporting use?

About 617 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 428 tokens, read only when the agent opens those files.

What are the alternatives to Bug Reporting?

Skills that share tags, products or a category with Bug Reporting: Reproduce Chat States (different-ai/openwork, 24k stars), Dynamo Jira Ticket (DynamoDS/Dynamo, 2k stars), Minimal Run And Audit (lllllllama/RigorPilot-Skills, 497 stars) and Moav E2E (MotherofallVPNs/MoaV, 448 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bug Reporting?

naodeng (a GitHub user) maintains it in naodeng/awesome-qa-skills, which has 245 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on September 26, 2026.

Source: naodeng/awesome-qa-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.