Generating Security Audit Reports
Overview
Aggregate vulnerability scan results, configuration analyses, and compliance assessments into a structured, auditor-ready security report. Map every finding to a CVSS severity, applicable compliance control (PCI-DSS, HIPAA, SOC 2, GDPR), and a prioritized remediation timeline.
Prerequisites
- Vulnerability scanner outputs (Nmap, Nessus, OpenVAS, OWASP ZAP) available in
${CLAUDE_SKILL_DIR}/security/
- Application and infrastructure configuration files accessible
- SAST/DAST tool results (e.g., Semgrep, Snyk, Trivy, Bandit)
- Applicable compliance framework documentation identified (PCI-DSS v4.0, HIPAA Security Rule, SOC 2 TSC, GDPR)
- Write permissions for report output directory
${CLAUDE_SKILL_DIR}/reports/
Instructions
- Inventory all available security data sources by scanning
${CLAUDE_SKILL_DIR}/security/ for scanner outputs, log files, and configuration exports.
- Parse vulnerability findings and normalize severity using CVSS 3.1 base scores: Critical (9.0-10.0), High (7.0-8.9), Medium (4.0-6.9), Low (0.1-3.9).
- Cross-reference each finding against applicable compliance controls. Map to specific PCI-DSS requirements (e.g., Req 6.5 for injection flaws), HIPAA safeguards, or SOC 2 Common Criteria.
- Deduplicate findings across scanners and merge related vulnerabilities into consolidated entries with all affected assets listed.
- Classify access control weaknesses, encryption gaps, and authentication deficiencies into separate report sections.
- Generate an executive summary including total findings by severity, overall risk score, and top-5 critical remediation priorities.
- Build a detailed findings table: finding ID, CWE number, affected component, CVSS score, compliance mapping, remediation steps, and evidence links.
- Produce a compliance status matrix showing pass/fail/partial for each applicable standard requirement.
- Create remediation recommendations with effort estimates (hours), priority ranking, and suggested timelines.
- Format the final report as Markdown to
${CLAUDE_SKILL_DIR}/reports/security-audit-YYYYMMDD.md. Optionally produce JSON for Jira/ServiceNow import.
See ${CLAUDE_SKILL_DIR}/references/implementation.md for the detailed four-phase implementation workflow.
Output
- Audit Report:
${CLAUDE_SKILL_DIR}/reports/security-audit-YYYYMMDD.md containing executive summary, detailed findings, compliance matrix, and remediation plan
- Findings JSON: Machine-readable findings for ticketing system import
- Compliance Matrix: Per-requirement pass/fail/partial status for each applicable framework
- Remediation Backlog: Prioritized list with effort estimates and owner assignments
Error Handling
| Error |
Cause |
Solution |
| No security scan results found |
Scanner outputs missing from ${CLAUDE_SKILL_DIR}/security/ |
Specify alternate data source paths or run preliminary scans with nmap -sV or trivy fs . |
| Cannot assess compliance -- requirements unavailable |
Compliance framework checklist not provided |
Fall back to OWASP Top 10 and CWE Top 25 as baseline; note limitation in report |
| Permission denied reading config files |
Insufficient filesystem access |
Request elevated permissions or provide exported configuration snapshots |
| Scan results exceed processing capacity |
Thousands of findings from multiple scanners |
Process in batches by severity (Critical/High first), then merge |
| Conflicting severity ratings across scanners |
Different tools score the same vulnerability differently |
Use CVSS 3.1 base score as canonical severity; note discrepancies in appendix |
Examples
- "Generate a SOC 2 security audit report for the API using scan results in
${CLAUDE_SKILL_DIR}/security/."
- "Create a PCI-DSS compliance-focused security assessment with a prioritized remediation plan for all Critical and High findings."
- "Produce a HIPAA security audit from the Nessus and Trivy outputs, mapping each finding to the relevant HIPAA safeguard."
Resources
1---2name: generating-security-audit-reports3description: Generate comprehensive security audit reports for applications and systems. Use when you need to assess security posture, identify vulnerabilities, evaluate compliance status, or create formal security documentation. Trigger with phrases like "create security audit report", "generate security assessment", "audit security posture", or "PCI-DSS compliance report".4license: MIT5---6# Generating Security Audit Reports
7
8## Overview
9
10Aggregate vulnerability scan results, configuration analyses, and compliance assessments into a structured, auditor-ready security report. Map every finding to a CVSS severity, applicable compliance control (PCI-DSS, HIPAA, SOC 2, GDPR), and a prioritized remediation timeline.
11
12## Prerequisites
13
14- Vulnerability scanner outputs (Nmap, Nessus, OpenVAS, OWASP ZAP) available in `${CLAUDE_SKILL_DIR}/security/`
15- Application and infrastructure configuration files accessible
16- SAST/DAST tool results (e.g., Semgrep, Snyk, Trivy, Bandit)
17- Applicable compliance framework documentation identified (PCI-DSS v4.0, HIPAA Security Rule, SOC 2 TSC, GDPR)
18- Write permissions for report output directory `${CLAUDE_SKILL_DIR}/reports/`
19
20## Instructions
21
221. Inventory all available security data sources by scanning `${CLAUDE_SKILL_DIR}/security/` for scanner outputs, log files, and configuration exports.
232. Parse vulnerability findings and normalize severity using CVSS 3.1 base scores: Critical (9.0-10.0), High (7.0-8.9), Medium (4.0-6.9), Low (0.1-3.9).
243. Cross-reference each finding against applicable compliance controls. Map to specific PCI-DSS requirements (e.g., Req 6.5 for injection flaws), HIPAA safeguards, or SOC 2 Common Criteria.
254. Deduplicate findings across scanners and merge related vulnerabilities into consolidated entries with all affected assets listed.
265. Classify access control weaknesses, encryption gaps, and authentication deficiencies into separate report sections.
276. Generate an executive summary including total findings by severity, overall risk score, and top-5 critical remediation priorities.
287. Build a detailed findings table: finding ID, CWE number, affected component, CVSS score, compliance mapping, remediation steps, and evidence links.
298. Produce a compliance status matrix showing pass/fail/partial for each applicable standard requirement.
309. Create remediation recommendations with effort estimates (hours), priority ranking, and suggested timelines.
3110. Format the final report as Markdown to `${CLAUDE_SKILL_DIR}/reports/security-audit-YYYYMMDD.md`. Optionally produce JSON for Jira/ServiceNow import.
32
33See `${CLAUDE_SKILL_DIR}/references/implementation.md` for the detailed four-phase implementation workflow.
34
35## Output
36
37- **Audit Report**: `${CLAUDE_SKILL_DIR}/reports/security-audit-YYYYMMDD.md` containing executive summary, detailed findings, compliance matrix, and remediation plan
38- **Findings JSON**: Machine-readable findings for ticketing system import
39- **Compliance Matrix**: Per-requirement pass/fail/partial status for each applicable framework
40- **Remediation Backlog**: Prioritized list with effort estimates and owner assignments
41
42## Error Handling
43
44| Error | Cause | Solution |
45|-------|-------|----------|
46| No security scan results found | Scanner outputs missing from `${CLAUDE_SKILL_DIR}/security/` | Specify alternate data source paths or run preliminary scans with `nmap -sV` or `trivy fs .` |
47| Cannot assess compliance -- requirements unavailable | Compliance framework checklist not provided | Fall back to OWASP Top 10 and CWE Top 25 as baseline; note limitation in report |
48| Permission denied reading config files | Insufficient filesystem access | Request elevated permissions or provide exported configuration snapshots |
49| Scan results exceed processing capacity | Thousands of findings from multiple scanners | Process in batches by severity (Critical/High first), then merge |
50| Conflicting severity ratings across scanners | Different tools score the same vulnerability differently | Use CVSS 3.1 base score as canonical severity; note discrepancies in appendix |
51
52## Examples
53
54- "Generate a SOC 2 security audit report for the API using scan results in `${CLAUDE_SKILL_DIR}/security/`."
55- "Create a PCI-DSS compliance-focused security assessment with a prioritized remediation plan for all Critical and High findings."
56- "Produce a HIPAA security audit from the Nessus and Trivy outputs, mapping each finding to the relevant HIPAA safeguard."
57
58## Resources
59
60- OWASP Top 10: https://owasp.org/www-project-top-ten/
61- CWE Top 25: https://cwe.mitre.org/top25/
62- NIST Cybersecurity Framework: https://www.nist.gov/cyberframework
63- PCI-DSS v4.0 Requirements: https://www.pcisecuritystandards.org/
64- CVSS 3.1 Calculator: https://www.first.org/cvss/calculator/3.1
65- `${CLAUDE_SKILL_DIR}/references/errors.md` -- full error handling reference
66- `${CLAUDE_SKILL_DIR}/references/examples.md` -- additional usage examples
67- https://intentsolutions.io
gabrielmoreira