report-writing

Writes impact-first bug bounty reports with platform templates and CVSS scoring.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/inventashif/helpful-code-sidekick --skill report-writing-inventashif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: report-writing
Source: https://github.com/inventashif/helpful-code-sidekick/tree/main/scripts/hackerai/skills/bughunter/report-writing
Command: npx skills add https://github.com/inventashif/helpful-code-sidekick --skill report-writing-inventashif

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Security researchers often lose payouts because their vulnerability reports are vague, theoretical, or formatted wrong for the platform. This Skill turns a validated finding into a submission-ready report that triagers can act on quickly. ## 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 Scoring & Severity Guidance: Includes CVSS 3.1 and CVSS 4.0 quick-scoring tables, typical scores by bug class, and a severity decision guide from Critical to Low. - Tone & Quality Controls: Enforces impact-first writing, a title formula, downgrade counters for triager pushback, and a 60-second pre-submit checklist that bans theoretical language like "could potentially". - Use Case: After confirming an IDOR on /api/users/{id}/orders with two test accounts, use this Skill to produce a HackerOne report with exact HTTP requests, a CVSS 6.5 vector string, quantified impact, and a concrete remediation snippet. ## 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 it as Summary, Vulnerability Details with CVSS score, Steps to Reproduce with exact HTTP requests, Impact, and Recommended Fix. Lead with the concrete impact in the first sentence and include the raw request and response showing the bug.

What is a good bug bounty report title format?

Use the formula: [Bug Class] in [Exact Endpoint/Feature] 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".

How do I calculate a CVSS 3.1 score for a vulnerability report?

Pick values for Attack Vector, Attack Complexity, Privileges Required, User Interaction, Scope, and Confidentiality/Integrity/Availability impacts, then combine them into a vector string. Typical references: IDOR reading PII scores 6.5 Medium, SSRF reaching cloud metadata scores 9.1 Critical.

What is the difference between Bugcrowd VRT and CVSS severity?

Bugcrowd maps findings to its Vulnerability Rating Taxonomy with default priorities, which can disagree with CVSS about 30% of the time. When CVSS rates higher, file a severity-request paragraph citing the CVSS vector and the matching VRT entry in the first body section.

Why do bug bounty reports get rejected as not applicable?

Reports get marked 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 real request/response evidence or downgrade the severity claim to match what you actually proved.

When should I use CVSS 4.0 instead of CVSS 3.1?

Use CVSS 4.0 when the target program requires it, as some newer programs adopted it after its November 2023 release. Include the full vector string starting with CVSS:4.0/AV: so triagers cannot dispute the scoring.