Report Generation Technique
Goal: produce professional penetration test reports that meet industry standards and satisfy both technical and executive audiences.
When this technique applies
- Need to compile pentest findings into a structured report.
- Writing executive summaries or detailed technical findings.
- Creating attack narratives or remediation guidance.
Initial triage
Before writing, classify the deliverable and the evidence maturity so the report structure matches the engagement outcome.
- Starting state: are you producing an executive summary, a full technical report, an interim findings memo, or a single-finding writeup?
- First questions: who is the audience, what evidence is already validated, what findings are report-ready, and what methodology/scope context must be stated up front?
- Immediate actions: sort findings by severity and confidence, identify missing proof or remediation details, and build the report skeleton before prose.
- Tool-family direction: this technique mostly coordinates evidence and structure; pull from the relevant technique/tool outputs rather than inventing new tooling here.
- Escalation rule: do not polish narrative before confirming evidence quality, scope statements, and remediation ownership.
Boundary with other skills
- Evidence production: the relevant offensive or analysis technique should already have produced validated findings and artifacts.
- Writing support: use
behaviours/evidence-before-claims/ and behaviours/verification-before-completion/ logic when a finding is not yet report-ready.
Report structure
1. Cover page
[CLASSIFICATION LEVEL]
Penetration Test Report
[ENGAGEMENT TITLE]
Client: [CLIENT NAME]
Assessment Dates: [START DATE] -- [END DATE]
Report Date: [REPORT DATE]
Assessor(s): [ASSESSOR NAME(S)]
Report Version: 1.0
Distribution: [DISTRIBUTION LIST]
2. Executive summary
- Written for non-technical leadership (C-suite, board members, risk committee).
- 1-2 pages maximum.
- Overall risk rating with justification.
- Key statistics: total findings by severity, systems tested, critical issues.
- Top 3-5 findings summarized in business impact terms.
- Strategic recommendations (business decisions, not technical fixes).
- Comparison to previous assessment if applicable.
3. Scope and methodology
- Systems, networks, and applications in scope (with IP ranges, URLs).
- Explicitly stated exclusions.
- Testing approach and methodology (PTES, OWASP, custom).
- Testing window and any constraints.
- Tools used (with versions).
- Limitations encountered during testing.
4. Findings summary table
| ID |
Finding |
Severity |
CVSS |
Affected Systems |
Status |
Sorted by severity (Critical to Informational).
5. Detailed findings
Each finding:
### [ID] -- Finding Title
**Severity**: Critical | High | Medium | Low | Informational
**CVSS**: X.X (v4.0 or v3.1 vector, e.g. CVSS:4.0/AV:X/AC:X/AT:X/PR:X/UI:X/VC:X/VI:X/VA:X/SC:X/SI:X/SA:X or CVSS:3.1/AV:X/AC:X/PR:X/UI:X/S:X/C:X/I:X/A:X)
**CWE**: CWE-XXX -- Name
**Affected Systems**: [IP/hostname/URL list]
**MITRE ATT&CK**: TXXXX -- Technique Name
#### Description
What the vulnerability is, where it exists, and the technical root cause.
#### Evidence
[Screenshot placeholder: evidence-XX.png]
[Redacted proof-of-concept details]
#### Impact
Business impact: what an attacker could achieve.
#### Remediation
1. Immediate mitigation
2. Root cause fix
3. Preventive measures
#### Verification
How to confirm the fix was applied correctly.
#### References
- CVE-XXXX-XXXXX
- CWE-XXX
6. Attack narrative (optional)
Chronological walkthrough: initial access, privilege escalation, lateral movement, objective completion. Mapped to MITRE ATT&CK at each step.
7. Remediation priorities
Group fixes by effort and impact:
- Quick wins (low effort, high impact).
- Strategic fixes (architectural changes).
- Compensating controls (interim measures).
1---2name: report-generation-technique3description: Assessment reporting: exec summaries, CVSS findings, evidence chains, MITRE ATT&CK mapping, remediation, review-ready structure.4license: MIT5---67# Report Generation Technique89Goal: produce professional penetration test reports that meet industry standards and satisfy both technical and executive audiences.1011## When this technique applies1213- Need to compile pentest findings into a structured report.14- Writing executive summaries or detailed technical findings.15- Creating attack narratives or remediation guidance.1617## Initial triage1819Before writing, classify the deliverable and the evidence maturity so the report structure matches the engagement outcome.2021- **Starting state**: are you producing an executive summary, a full technical report, an interim findings memo, or a single-finding writeup?22- **First questions**: who is the audience, what evidence is already validated, what findings are report-ready, and what methodology/scope context must be stated up front?23- **Immediate actions**: sort findings by severity and confidence, identify missing proof or remediation details, and build the report skeleton before prose.24- **Tool-family direction**: this technique mostly coordinates evidence and structure; pull from the relevant technique/tool outputs rather than inventing new tooling here.25- **Escalation rule**: do not polish narrative before confirming evidence quality, scope statements, and remediation ownership.2627## Boundary with other skills2829- **Evidence production**: the relevant offensive or analysis technique should already have produced validated findings and artifacts.30- **Writing support**: use `behaviours/evidence-before-claims/` and `behaviours/verification-before-completion/` logic when a finding is not yet report-ready.3132## Report structure3334### 1. Cover page3536```37[CLASSIFICATION LEVEL]38Penetration Test Report39[ENGAGEMENT TITLE]4041Client: [CLIENT NAME]42Assessment Dates: [START DATE] -- [END DATE]43Report Date: [REPORT DATE]44Assessor(s): [ASSESSOR NAME(S)]45Report Version: 1.046Distribution: [DISTRIBUTION LIST]47```4849### 2. Executive summary5051- Written for non-technical leadership (C-suite, board members, risk committee).52- 1-2 pages maximum.53- Overall risk rating with justification.54- Key statistics: total findings by severity, systems tested, critical issues.55- Top 3-5 findings summarized in business impact terms.56- Strategic recommendations (business decisions, not technical fixes).57- Comparison to previous assessment if applicable.5859### 3. Scope and methodology6061- Systems, networks, and applications in scope (with IP ranges, URLs).62- Explicitly stated exclusions.63- Testing approach and methodology (PTES, OWASP, custom).64- Testing window and any constraints.65- Tools used (with versions).66- Limitations encountered during testing.6768### 4. Findings summary table6970| ID | Finding | Severity | CVSS | Affected Systems | Status |71|---|---|---|---|---|---|7273Sorted by severity (Critical to Informational).7475### 5. Detailed findings7677Each finding:7879```markdown80### [ID] -- Finding Title8182**Severity**: Critical | High | Medium | Low | Informational83**CVSS**: X.X (v4.0 or v3.1 vector, e.g. CVSS:4.0/AV:X/AC:X/AT:X/PR:X/UI:X/VC:X/VI:X/VA:X/SC:X/SI:X/SA:X or CVSS:3.1/AV:X/AC:X/PR:X/UI:X/S:X/C:X/I:X/A:X)84**CWE**: CWE-XXX -- Name85**Affected Systems**: [IP/hostname/URL list]86**MITRE ATT&CK**: TXXXX -- Technique Name8788#### Description89What the vulnerability is, where it exists, and the technical root cause.9091#### Evidence92[Screenshot placeholder: evidence-XX.png]93[Redacted proof-of-concept details]9495#### Impact96Business impact: what an attacker could achieve.9798#### Remediation991. Immediate mitigation1002. Root cause fix1013. Preventive measures102103#### Verification104How to confirm the fix was applied correctly.105106#### References107- CVE-XXXX-XXXXX108- CWE-XXX109```110111### 6. Attack narrative (optional)112113Chronological walkthrough: initial access, privilege escalation, lateral movement, objective completion. Mapped to MITRE ATT&CK at each step.114115### 7. Remediation priorities116117Group fixes by effort and impact:118- Quick wins (low effort, high impact).119- Strategic fixes (architectural changes).120- Compensating controls (interim measures).