Skip to content

maxwellokumu/okaudit-claude-skills / lead-it-auditor/exec-summary-writer

exec-summary-writer

Verified

Convert a structured findings JSON file into a polished executive summary with risk breakdown, key findings, and recommendations. Use this skill for leadership-facing audit reporting.

FileKindSize
README.mdmarkdown1.9 KB
SKILL.mdskill md1.6 KB
main.pyscript9.2 KB
sample_input/findings.jsonconfig4.7 KB
skill.yamlconfig1.2 KB
# exec-summary-writer

Convert a structured findings JSON file into a polished executive summary report
ready for presentation to management or the audit committee.

---

## Purpose

Takes a list of audit findings and produces a professional markdown executive summary with:
- Scope, author, and date header
- Narrative overview paragraph
- Key findings table with risk levels
- Risk summary with counts by severity
- Prioritised recommendations
- Standard next steps / remediation timeline

---

## Requirements

```bash
pip install python-dotenv
```

---

## Findings JSON Schema

Each finding must have these fields:

```json
[
  {
    "title": "Overly permissive IAM policies",
    "description": "Several IAM roles were found with wildcard actions...",
    "risk_level": "High",
    "recommendation": "Implement least-privilege IAM policies...",
    "affected_system": "AWS IAM"
  }
]
```

Valid `risk_level` values: `Critical`, `High`, `Medium`, `Low`, `Informational`

---

## Usage

```bash
# Minimal usage
python main.py --findings findings.json

# With scope, author and date
python main.py \
  --findings findings.json \
  --scope "Q3 2025 AWS Infrastructure Audit" \
  --author "Jane Smith, CISA" \
  --date "2025-07-15"

# Using sample input
python main.py \
  --findings sample_input/findings.json \
  --scope "Sample Audit Engagement"
```

---

## Sample Output (truncated)

```markdown
# Executive Summary — IT Audit Report
**Scope:** Q3 2025 AWS Infrastructure Audit
**Author:** Jane Smith, CISA  
**Date:** 2025-07-15

## Overview
This report presents the findings of the Q3 2025 IT audit...

## Key Findings
| # | Title | Affected System | Risk Level |
|---|-------|----------------|------------|
| 1 | Overly permissive IAM policies | AWS IAM | 🔴 High |

## Risk Summary
| Risk Level | Count | % of Total |
|------------|-------|------------|
| 🚨 Critical | 1 | 12.5% |
| 🔴 High | 3 | 37.5% |
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall