report-writing

Writes impact-first bug bounty reports for HackerOne, Bugcrowd, Intigriti, and Immunefi with CVSS scoring.

1|Updated Aug 21, 2026
One-click install
npx skills add https://github.com/marcboggs/BMAD-AppSec-Orchestrator --skill report-writing-marcboggs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: report-writing
Source: https://github.com/marcboggs/BMAD-AppSec-Orchestrator/tree/main/.claude/skills/report-writing
Command: npx skills add https://github.com/marcboggs/BMAD-AppSec-Orchestrator --skill report-writing-marcboggs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Security researchers often lose payouts because their vulnerability reports are vague, theoretical, or poorly structured, causing triagers to downgrade or dismiss valid findings. This Skill turns a validated finding into a platform-ready report with proven impact, exact reproduction steps, and correct severity scoring. ## Core Features & Use Cases - Platform-Specific Templates: Provides ready-to-use report structures for HackerOne, Bugcrowd, Intigriti, and Immunefi, including VRT mapping and severity-request paragraphs. - CVSS 3.1 and 4.0 Scoring: Includes quick-scoring tables, typical scores by bug class, and a severity decision guide to justify Critical/High/Medium/Low ratings. - Title and Impact Formulas: Enforces a concrete title formula and bans theoretical language like "could potentially" so every claim is backed by demonstrated proof. - Use Case: After confirming an IDOR on /api/users/{id}/orders with two test accounts, use this Skill to produce a HackerOne report with the exact HTTP request, victim response JSON, CVSS 6.5 vector, and a one-line remediation. ## Quick Start Write a HackerOne report for my validated IDOR finding on the orders endpoint using the report-writing skill.

Frequently Asked Questions about report-writing

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

FAQPage Schema
How do I write a bug bounty report for HackerOne?▼

Structure the report as Summary, Vulnerability Details, Steps to Reproduce, Impact, and Recommended Fix. Lead with the exact impact in the first sentence, include copy-paste-ready HTTP requests, and attach a screenshot showing the attacker's session receiving victim data.

How to write a good bug bounty report title?▼

Use the formula: [Bug Class] in [Exact Endpoint] allows [attacker role] to [impact] [victim scope]. For example, "IDOR in /api/v2/invoices/{id} allows authenticated user to read any customer's invoice data" instead of vague titles like "IDOR vulnerability found".

What is the difference between Bugcrowd VRT and CVSS severity?▼

Bugcrowd maps findings to its Vulnerability Rating Taxonomy with default priorities, while CVSS computes a numeric score from exploitability metrics. They disagree roughly 30% of the time, so file a severity-request paragraph citing the CVSS vector and the matching VRT entry when the default rates lower.

How do I calculate CVSS 3.1 score for an IDOR finding?▼

A typical IDOR reading other users' PII scores 6.5 Medium with vector AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N. Raise severity if the IDOR allows writes or deletes, affects all users, or requires no victim interaction.

Why do bug bounty reports get marked as not applicable?▼

Reports get N/A when they claim theoretical impact using phrases like "could potentially" without demonstrating the attack end-to-end. Either show the full exploit chain with request and response evidence, or downgrade the severity claim to match what was actually proven.

When should I use a red team report template instead of a bug bounty template?▼

Use the red team template when the engagement is an external red team assessment rather than a bug bounty program. Red team reports use a different structure (Subject, Observations, Description, Impact, Recommendation, PoC) aimed at client stakeholders instead of platform triagers.