# report-writer

The report-writer subagent for Claude Code compiles vulnerability findings into reports for pentests, bounty submissions, and technical writeups.

- subagent · `type=agent` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop) · ★ 1298 repo stars
- Author: H-mmer
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/H-mmer/pentest-agents/tree/HEAD/.claude/agents/report-writer.md
- Updated: 2026-06-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/report-writer

## What it does

This subagent takes a list of vulnerabilities and generates structured reports for bug bounty platforms, penetration tests, or public disclosure. Before writing, it searches for similar closed reports via the `writeup-search` MCP tool to check how titles are phrased, what CVSS vectors were accepted, and what remediation wording worked. This increases acceptance rate.

The subagent reads `rules/mistakes.md` to avoid common pitfalls: no CWE-200 as primary CWE (too generic), no HackerOne titles over 80 characters, file paths verified with `ls` before insertion. Requirements: file reading, Markdown writing, `ls` and `grep` execution. Reports must include Summary, Host, Endpoints, Steps, Impact, Remediation, CVSS with per-metric justification, CWE and CAPEC. Without access to vulnerability sources, nothing to generate.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/report-writer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/report-writer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/report-writer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/H-mmer/pentest-agents/tree/HEAD/.claude/agents/report-writer.md

## When to use it
- compile pentest report from findings with risk-sorted sections
- write HackerOne or Bugcrowd submission following platform template
- generate writeup with CVSS justification and CWE for public disclosure
- verify CVSS vector and CWE before submission to avoid CWE-200
- find similar closed report and extract remediation phrasing

## Example prompts
- Build a bounty report from findings in `findings/` for HackerOne, CVSS 3.1
- Write a pentest report with executive summary and risk matrix from `vulns/`
- Create a technical writeup for the IDOR issue in `reports/drafts/idor-notes.md`

## Similar
- [bug-bounty-report-writing](https://affpapa.org/en/nevibecode/skills/bug-bounty-report-writing.md) — skill · 290 installs
- [report](https://affpapa.org/en/nevibecode/commands/sachin-sharma-report.md) — command · ★ 16193 repo stars
- [hackerone](https://affpapa.org/en/nevibecode/skills/hackerone.md) — skill · 348 installs
- [pentestcompanion-workspace](https://affpapa.org/en/nevibecode/skills/pentestcompanion-workspace.md) — skill · 539 installs
- [risk-scorer](https://affpapa.org/en/nevibecode/agents/risk-scorer.md) — subagent · ★ 2482 repo stars
- [pentest-toolkit-pro-html](https://affpapa.org/en/nevibecode/skills/pentest-toolkit-pro-html.md) — skill · 344 installs

From the same set: [h-mmer/pentest-agents](https://affpapa.org/en/nevibecode/by/h-mmer/pentest-agents.md) — 43 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
