# bug-bounty-report-writing

bug-bounty-report-writing guides agents in drafting vulnerability submissions with verified impact and reproduction steps with CVSS scoring. Useful before sending bug reports to bounty programs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 290 installs
- Author: securityskills
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/securityskills/skills/tree/HEAD/bug-bounty/bug-bounty-report-writing/SKILL.md
- Updated: 2026-08-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bug-bounty-report-writing

## What it does

The skill organizes vulnerability disclosures into a clean structure for triage teams. It enforces an asset-focused title, calculated CVSS vectors, reproduction steps, and remediation guidance. Speculative claims about remote execution without clear paths are flagged immediately.

Evidence handling follows strict privacy practices. Any exposed personal details must be redacted from request logs and screenshots before submission. It also warns against common submission mistakes, such as submitting automated scanner dumps or claiming high severity for self-XSS.

Reports must cover a single flaw. Vulnerability chains are allowed only when individual steps have no impact on their own.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add securityskills/skills --skill bug-bounty-report-writing -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bug-bounty-report-writing/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bug-bounty-report-writing/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add securityskills/skills --skill bug-bounty-report-writing -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bug-bounty-report-writing/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add securityskills/skills --skill bug-bounty-report-writing -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bug-bounty-report-writing/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install securityskills/skills bug-bounty/bug-bounty-report-writing/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/bug-bounty-report-writing/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add securityskills/skills --skill bug-bounty-report-writing -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/securityskills/skills --path bug-bounty/bug-bounty-report-writing
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bug-bounty-report-writing/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add securityskills/skills --skill bug-bounty-report-writing -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/securityskills/skills/tree/HEAD/bug-bounty/bug-bounty-report-writing/SKILL.md

## When to use it
- structure reproduction steps so triage teams verify them quickly
- calculate the CVSS score with a complete vector string
- draft clear remediation advice for the asset owner
- redact personal data from proof-of-concept logs and images

## Example prompts
- Help me draft a bug report for a stored XSS issue in the support ticket form
- Generate the CVSS vector string and articulate the exact security impact
- Turn these raw HTTP request logs into clean reproduction steps

## Similar
- [report](https://affpapa.org/en/nevibecode/commands/sachin-sharma-report.md) — command · ★ 16193 repo stars
- [pentest-agents-bug-bounty-framework](https://affpapa.org/en/nevibecode/skills/pentest-agents-bug-bounty-framework.md) — skill · 1300 installs
- [bug-bounty](https://affpapa.org/en/nevibecode/skills/bug-bounty.md) — skill · 682 installs
- [api-fuzzing-bug-bounty](https://affpapa.org/en/nevibecode/skills/api-fuzzing-bug-bounty.md) — skill · 139 installs
- [report-writer](https://affpapa.org/en/nevibecode/agents/report-writer.md) — subagent · ★ 1298 repo stars
- [Bug Bounty Intelligence](https://affpapa.org/en/nevibecode/mcp/bug-bounty-intelligence.md) — MCP server · ★ 11 repo stars

From the same set: [securityskills/skills](https://affpapa.org/en/nevibecode/by/securityskills/skills.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
