| name | hackerone |
| description | HackerOne bug bounty automation - parses scope CSVs, deploys parallel pentesting agents per asset, validates PoCs, and generates platform-ready submission reports. |
HackerOne Bug Bounty
Automates: scope parsing → parallel testing per asset → PoC validation → submission reports.
Quick start
- Input: HackerOne program URL or scope CSV.
- Parse scope and program guidelines.
- Spawn one coordinator per eligible asset (parallel).
- Each coordinator runs the standard engagement flow (see
skills/coordination/SKILL.md).
- Validate PoCs, generate HackerOne-formatted reports.
Scope CSV format
Expected columns:
identifier — asset URL/domain.
asset_type — URL, WILDCARD, API, CIDR.
eligible_for_submission — must be true.
max_severity — critical / high / medium / low.
instruction — asset-specific notes.
Parse with tools/csv_parser.py. Filter for eligible_for_submission=true.
Agent deployment
One coordinator per asset, spawned in parallel:
coordinator_role = Read("skills/coordination/SKILL.md")
Agent(prompt=f"{coordinator_role}\n\nTARGET: {asset_url}\nSCOPE: {program_guidelines}\nOUTPUT_DIR: ...",
run_in_background=True)
10 assets → 10 parallel coordinators (~2-4 h vs 20-40 h sequential). Each coordinator follows skills/coordination/SKILL.md and reference/role-matrix.md.
PoC validation
Every finding requires:
poc.py — executable exploit script.
poc_output.txt — timestamped execution proof.
workflow.md — manual repro steps if applicable.
- Evidence screenshots / HTTP captures / video.
Use the standard engagement-thoroughness validator + finding validators (see skills/coordination/reference/validator-role.md). The HackerOne PoC contract is a superset of the standard finding contract.
Submission report format
Required sections per HackerOne standard:
- Summary (2-3 sentences).
- Severity (CVSS v3.1 + business impact).
- Steps to Reproduce (numbered, clear).
- Visual Evidence.
- Impact (realistic attack scenario).
- Remediation (actionable fixes).
Validate with tools/report_validator.py.
Output structure
Standard OUTPUT_DIR (skills/coordination/reference/output-discipline.md) plus a per-asset reports/submissions/ containing the platform-ready markdown.
{OUTPUT_DIR}/
├── findings/
├── reports/
│ ├── submissions/
│ │ ├── H1_CRITICAL_001.md
│ │ └── H1_HIGH_001.md
│ └── SUBMISSION_GUIDE.md
├── recon/
├── logs/
└── artifacts/
Program selection
High-value: new programs (< 30 days), fast response (< 24 h), high bounties, large attack surface. Avoid: slow response (> 1 week), low bounties, restrictive scope.
Submission checklist
Common rejections (preempt)
| Rejection | Prevention |
|---|
| Out of Scope | Verify eligible_for_submission=true and asset-type match |
| Cannot Reproduce | Include poc.py + poc_output.txt; engagement-thoroughness validator catches missing artifacts |
| Duplicate | Search disclosed reports before submission; submit quickly |
| Insufficient Impact | Document realistic attack scenario in the report |
Tools
tools/csv_parser.py — parse HackerOne scope CSVs.
tools/report_validator.py — validate report completeness.
skills/coordination/SKILL.md — coordinator scaffold.
Usage
/hackerone <program_url_or_csv_path>