calculation-report

Calculation Report Skill

Pipeline

calculation.yaml → generate-calc-report.py → report.html (default) / report.md

Usage

# Generate HTML (default)
uv run --no-project python scripts/reporting/generate-calc-report.py <input.yaml>

# Generate Markdown with LaTeX math
uv run --no-project python scripts/reporting/generate-calc-report.py <input.yaml> --format md

# Specify output path
uv run --no-project python scripts/reporting/generate-calc-report.py <input.yaml> --output path/to/report.html

YAML Structure (Required Sections)

• metadata: title, doc_id, revision, date, author, status (draft/reviewed/approved)
• inputs: list of {name, symbol, value, unit} with optional source/notes
• methodology: description, standard, equations [{id, name, latex, description}]
• outputs: list of {name, symbol, value, unit} with optional pass_fail/limit
• assumptions: list of strings
• references: list of strings

Optional Sections

• charts: interactive Chart.js charts (line, bar, scatter, log_log)
• data_tables: tabular data with column headers and units
• change_log: revision history in metadata

Examples (13 calc reports)