generate-structured-reports
Writes a source-cited report from the user's files by running the gaik ReportWriter pipeline: every file (PDF, Word, spreadsheet, text, recording, image) is normalized to text, facts are curated per report section with quotes checked against the sources, and each section is drafted and reviewed. Drafts the report's sections from an optional template or proposes them, and agrees the structure with the user in chat; reports what the sources do not cover, where they disagree, and which facts were dropped. Use when a report must be written from source material and every statement must trace to a source, for example a condition or inspection report, an assessment, or a project or meeting report filled into a fixed template. Also use to correct curated facts and write the report again, or to rebuild a report after its sections were edited. Runs Python with gaik[report-writer]; in Claude Desktop without code execution, use the report-writing skill instead.
- Compatibility
- Needs Python 3.11 or later with gaik[report-writer] installed, an LLM provider configured through environment variables (OpenAI or Azure OpenAI when the sources include recordings), and Pandoc for Word output. The agent must be able to run the Python helper in scripts/.
Pinned to revision 842a90dd550c, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/generate-structured-reports/SKILL.md
- skills/generate-structured-reports/README.md
- skills/generate-structured-reports/references/report-spec.md
- skills/generate-structured-reports/references/report-structure.md
- skills/generate-structured-reports/references/review-and-resume.md
- skills/generate-structured-reports/scripts/install_pandoc.py
- skills/generate-structured-reports/scripts/run_report.py
- skills/generate-structured-reports/scripts/template_library.py
- skills/generate-structured-reports/scripts/template_to_spec.py
Every link opens the file at its source, pinned to the revision this page describes.