Share
## https://sploitus.com/exploit?id=F43CC900-78DC-5B73-B05D-6CC0FAF47A8A
# vuln-templates
Curated, well-documented vulnerability report templates for every common bug class. Includes PoC scaffolds, impact language, and remediation guidance. Write professional bug bounty reports in seconds.
## Features
- **15+ bug class templates** โ IDOR, XSS, SSRF, RCE, SQLi, Auth bypass, and more
- **Auto-fill CLI** โ Fill in target, endpoint, and parameters interactively
- **Impact language** โ Pre-written severity descriptions aligned with CVSS
- **PoC scaffolds** โ Ready-to-fill proof-of-concept sections
- **Remediation** โ Developer-friendly fix recommendations
- **Platform-aware** โ Outputs formatted for HackerOne, Bugcrowd, or plain Markdown
- **Customizable** โ Add your own templates
## Installation
```bash
pip install vuln-templates
```
Or from source:
```bash
git clone https://github.com/D3wier/vuln-templates.git
cd vuln-templates
pip install -e .
```
## Quick Start
```bash
# List available templates
vuln-templates list
# Generate a report interactively
vuln-templates generate idor
# Generate with pre-filled values
vuln-templates generate xss \
--target "https://app.example.com" \
--endpoint "/api/v1/comments" \
--param "body" \
--severity high
# Output to file
vuln-templates generate ssrf -o report.md
# Copy to clipboard
vuln-templates generate sqli | pbcopy
```
## Available Templates
| Template | Bug Class | Severity Range |
|----------|-----------|----------------|
| `idor` | Insecure Direct Object Reference | Medium โ Critical |
| `xss-reflected` | Reflected Cross-Site Scripting | Low โ High |
| `xss-stored` | Stored Cross-Site Scripting | Medium โ Critical |
| `xss-dom` | DOM-based XSS | Low โ High |
| `ssrf` | Server-Side Request Forgery | Medium โ Critical |
| `sqli` | SQL Injection | High โ Critical |
| `rce` | Remote Code Execution | Critical |
| `auth-bypass` | Authentication Bypass | High โ Critical |
| `privilege-escalation` | Privilege Escalation | High โ Critical |
| `info-disclosure` | Information Disclosure | Low โ High |
| `csrf` | Cross-Site Request Forgery | Low โ High |
| `open-redirect` | Open Redirect | Low โ Medium |
| `race-condition` | Race Condition | Medium โ High |
| `path-traversal` | Path Traversal / LFI | Medium โ Critical |
| `business-logic` | Business Logic Flaw | Medium โ Critical |
## Template Structure
Each template includes:
```markdown
## Summary
[One-line description of the vulnerability]
## Severity
[CVSS score and justification]
## Affected Endpoint
[URL, method, parameters]
## Steps to Reproduce
1. [Step-by-step reproduction]
2. ...
## Proof of Concept
[Code, curl commands, or screenshots]
## Impact
[What an attacker can do โ real-world consequences]
## Remediation
[How to fix it โ developer-friendly guidance]
```
## Custom Templates
Add your own templates to `~/.vuln-templates/`:
```markdown
---
name: my-template
class: Custom Bug Class
severity_range: Medium - High
fields:
- target
- endpoint
- param
- payload
---
## Summary
{{class}} vulnerability in {{target}} at {{endpoint}}...
```
## License
MIT License โ see [LICENSE](LICENSE)