report-writing

Generates platform-specific bug bounty report templates with CVSS scoring and severity guidance.

Updated May 29, 2026
One-click install
npx skills add https://github.com/hhjkjkjk/Claude-skills --skill report-writing-hhjkjkjk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: report-writing
Source: https://github.com/hhjkjkjk/Claude-skills/tree/main/skills/report-writing
Command: npx skills add https://github.com/hhjkjkjk/Claude-skills --skill report-writing-hhjkjkjk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing bug bounty reports that triagers accept and pay out on is hard: vague titles, theoretical impact claims, and wrong severity ratings get reports closed as N/A or downgraded. This Skill provides proven report templates, scoring formulas, and tone guidelines for HackerOne, Bugcrowd, Intigriti, and Immunefi. ## Core Features & Use Cases - Platform-Specific Templates: Ready-to-use report structures for HackerOne, Bugcrowd, Intigriti, and Immunefi, each matching that platform's triager expectations and severity mechanisms. - CVSS 3.1 and 4.0 Scoring: Quick-reference scoring tables, typical scores by bug class, and a severity decision guide mapping findings to Critical/High/Medium/Low. - Impact-First Writing Rules: Title formulas, downgrade counters for disputing triager pushback, a 60-second pre-submit checklist, and a strict ban on theoretical language like "could potentially". - Use Case: After validating an IDOR finding on a HackerOne program, use this Skill to produce a complete report with a specific title, copy-paste-ready reproduction steps, a justified CVSS score, and a concrete remediation suggestion. ## Quick Start Write a HackerOne report for my validated IDOR finding on the /api/users/{id}/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?▼

Use the HackerOne template structure: 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 copy-paste-ready request and response evidence.

What CVSS score should I assign to an IDOR finding?▼

An IDOR exposing PII typically scores 6.5 Medium (AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N), while IDOR allowing write or delete operations scores around 7.5 High. Raise severity if the finding exposes PII at scale, enables account takeover, or requires no victim interaction.

How is a Bugcrowd report different from a HackerOne report?▼

Bugcrowd reports are structured around VRT categories with a severity-request paragraph, Expected vs Actual behavior, and severity justification, while HackerOne uses a narrative Summary-Steps-Impact-Fix flow. Bugcrowd severity defaults to the VRT mapping but can be contested with a grounded CVSS-based request.

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

Reports get closed when impact is claimed theoretically with phrases like "could potentially" instead of demonstrated end-to-end, when reproduction steps are incomplete, or when severity is overclaimed relative to the evidence. Demonstrate the attack with two test accounts and paste the actual response showing the impact.

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. CVSS 4.0 replaces Scope with Subsequent System impact metrics and adds Attack Requirements; include the full vector string starting with CVSS:4.0/ so triagers cannot dispute the score.