write-report
SkillSecurityWrite a disclosure-quality bug bounty report for a finding, matching the HackerOne report format used in this repo's corpus. Use when the user has a vulnerability and wants it written up — "write a report for this", "draft a HackerOne submission", "turn this finding into a report". Produces title, summary, steps to reproduce, impact, severity, and remediation, few-shot styled on real disclosed reports.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the write-report skill
What this skill tells your AI
The instructions your AI receives, as published by bugbountywithmarco/bugbounty-disclosed-reports in .claude/skills/write-report/SKILL.md and read by ahel’s review.
Draft a clear, triager-friendly bug bounty report that matches the structure of
the disclosed reports in reports/.
Workflow
-
Collect the finding details from the user / conversation: target asset, vuln class, where it lives, how to trigger it, what the impact is, any PoC artifacts (requests, responses, screenshots). Ask only for what's genuinely missing.
-
Find a style/structure exemplar. Pull 2–3 strong same-class reports to match tone and detail level:
python3 .claude/skills/_lib/search_reports.py "<vuln class>" --severity high,critical --full --limit 8Read one or two in full to mirror how good reports phrase impact and steps.
-
Write the report in this structure (Markdown):
# <Concise, specific title: vuln + where + impact> ## Summary What the bug is, where, and why it matters — in 2–4 sentences. ## Steps To Reproduce 1. Numbered, exact, copy-pasteable. Include full HTTP requests in code blocks, concrete URLs/params, and account/role pre-conditions. 2. ... ## Proof of Concept Requests/responses, payloads, or a short script. (Use the `poc` skill to build.) ## Impact Concrete attacker capability and blast radius. Tie to business risk. Note pre-conditions and whether it's one-click / unauthenticated / cross-account. ## Severity Proposed rating + CVSS vector (use the `severity` skill to calibrate). ## Remediation Specific, actionable fix(es).
Rules
- Be precise and reproducible: a triager must be able to follow the steps verbatim.
- Lead the title and summary with impact, not mechanism.
- No exaggeration — claim only what the PoC demonstrates; state pre-conditions.
- Keep it self-contained. Redact real secrets/PII from any captured artifacts.
- Don't fabricate steps or responses you haven't actually established.
Signals
- GitHub stars
- 113
- Forks
- 32
- Last commit
- Jul 2026
Advanced
- Catalog kind
- skill
- Gateway key
write-report- Source
- github.com/bugbountywithmarco/bugbounty-disclosed-reports