report-writer — Claude Code skill: security reports and installation
report-writer turns vulnerability findings into bug bounty submissions, penetration test reports, or technical write-ups. Use it when findings need clear evidence, impact, and remediation.
no license ★ 1,298 updated 2026-06-12
npx skills add H-mmer/pentest-agents --skill report-writer -a claude-codeWhat report-writer does
The skill structures security findings as a bug bounty submission, a penetration test report, or a technical write-up. It covers impact, reproduction steps, remediation, and supporting references. OWASP, CWE, and CVE identifiers can be included where relevant.
Before drafting, it calls for reviewing related disclosed reports with search_writeups and get_writeup, then reading rules/mistakes.md. Report sections cover the affected host, vulnerable component, test account, CVSS details, and supporting material. That means a useful draft depends on concrete evidence and details about the finding.
For bug bounty submissions, the instructions name CVSS 4.0, while the version depends on the platform: HackerOne uses 3.1 in the guidance. The skill also cautions against presenting unverified scope as confirmed and against assigning CWE-200 as the primary weakness.
What it helps with
- turn a vulnerability finding into a bug bounty submission
- organize penetration test findings by severity
- document impact and exact reproduction steps
- draft a technical account of a vulnerability disclosure
Example prompts for the agent
- Turn this finding into a bug bounty submission with reproduction steps and impact.
- Build a penetration test report from
findings/, ordered by severity. - Write a technical account of this vulnerability and include a remediation recommendation.
How to install report-writer
1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill report-writer -a claude-code2Manually: put the files in place
~/.claude/skills/agent-report-writer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agent-report-writer/
1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill report-writer -a codex2Manually: put the files in place
.agents/skills/agent-report-writer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill report-writer -a cursor2Manually: put the files in place
.cursor/skills/agent-report-writer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install H-mmer/pentest-agents providers/cursor/.cursor/skills/agent-report-writer2Manually: put the files in place
.github/skills/agent-report-writer/SKILL.md1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill report-writer -a gemini-cli2Platform CLI
gemini skills install https://github.com/H-mmer/pentest-agents --path providers/cursor/.cursor/skills/agent-report-writerManually: put the files in place
.devin/skills/agent-report-writer/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about report-writer
How do I install report-writer in Claude Code?
Run npx skills add H-mmer/pentest-agents --skill agent-report-writer -a claude-code. The skill file is at ~/.claude/skills/agent-report-writer/SKILL.md.
What does report-writer do?
It formats vulnerability findings as bug bounty submissions, penetration test reports, or technical write-ups. Reports cover impact, reproduction, and suggested fixes.
What evidence should I prepare for a vulnerability report?
Prepare details about the affected component, reproducible test steps, and supporting material. The report structure includes PoC references, screenshots, and the test account.