report-writer

Convert validated security findings into structured HackerOne vulnerability reports.

11|1|Updated May 4, 2026
One-click install
npx skills add https://github.com/dreadnode/capabilities --skill report-writer-dreadnode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: report-writer
Source: https://github.com/dreadnode/capabilities/tree/main/capabilities/web-security/skills/report-writer
Command: npx skills add https://github.com/dreadnode/capabilities --skill report-writer-dreadnode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bug bounty hunters and security researchers often waste time formatting vulnerability reports to meet HackerOne's strict requirements, leading to triage delays, rejected submissions, or missed impact details that reduce bounty payouts.

Core Features & Use Cases

  • Pre-Report Validation Gate: Ensures only reproduced, escalated, in-scope findings with passed preflight checks are submitted, avoiding wasted effort on invalid reports.
  • Standardized Formatting: Auto-structures reports with required CVSS 4.0 and 3.1 blocks, H1 weakness type mappings, and clear PoC steps with proxy screenshot markers.
  • Use Case: After validating an SSRF vulnerability with the exploit-verifier skill, use this tool to generate a fully compliant report that includes all required evidence, impact justification, and root cause recommendations in the correct H1 format.

Quick Start

Use the report-writer skill to convert my validated SSRF finding for the /api/export endpoint into a structured HackerOne report.

Frequently Asked Questions about report-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I format a HackerOne vulnerability report to avoid triage delays?

To avoid triage delays, a HackerOne vulnerability report must include standardized PoC formatting, CVSS 4.0 and 3.1 scoring blocks, evidence quality rules, and proper weakness type mapping. Structuring these elements correctly ensures triagers can quickly validate the finding.

What is required in a bug bounty report for HackerOne submission?

A bug bounty report for HackerOne submission requires reproduced findings, confidence trace IDs, CVSS 4.0 and 3.1 blocks, clear PoC steps with proxy screenshot markers, impact justification, and H1 weakness type mapping to pass validation gates.

How do I generate a compliant HackerOne report after validating a security finding?

To generate a compliant HackerOne report after validating a security finding, you convert the escalated, in-scope finding into a structured format that enforces evidence quality, impact justification, and root cause recommendations to prevent submission rejections.

Does my vulnerability report need both CVSS 4.0 and 3.1 scoring for HackerOne?

Yes, including both CVSS 4.0 and 3.1 scoring blocks in your vulnerability report is required for HackerOne compliance. Providing both scores alongside H1 weakness type mapping ensures the report meets standardized formatting and impact justification requirements.

Why does my bug bounty report get rejected during HackerOne triage?

Bug bounty reports get rejected during HackerOne triage due to missing pre-report validation, insufficient evidence quality, lack of impact justification, or incorrect PoC formatting. Bypassing preflight checks on non-reproduced or out-of-scope findings also causes wasted effort and rejection.

Can I submit an unreproduced security finding to HackerOne?

No, you should not submit an unreproduced security finding to HackerOne. A pre-report validation gate enforces that only reproduced, escalated, in-scope findings with passed preflight checks are submitted to avoid wasted effort and invalid reports.