# Renderers

> Office-document renderers for pursuit deliverables — Markdown to DOCX (Pandoc/OpenXML) and JSON envelopes to styled XLSX (openpyxl). USE WHEN the user asks to export a Studio markdown file to Word, convert compliance matrix JSON to Excel, render proposal outline as DOCX, or run a one-off format conversion on files under pursuits/. Consumer skills (proposal-generator, subcontractor-sow-builder, compliance-auditor) call these scripts internally; users can also run renderers directly from Agent Skills or chat. DO NOT USE FOR drafting content (use proposal-generator), visual decks/PDF/PPTX (use huashu-design), or domain analysis.

- Skill: `bdm-15/renderers` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bdm-15/renderers`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bdm-15/renderers/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- License: MIT
- Author: BdM-15 (https://skillmd.com/u/bdm-15)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/bdm-15/renderers

---


# Renderers — DOCX + XLSX utility

## Capture-insights adapter

- **DOCX:** `scripts/render_docx.py` — Pandoc on PATH or OpenXML fallback via `python-docx`
- **XLSX:** `scripts/render_xlsx.py` — requires `openpyxl` in the project venv
- **Run** from Agent Skills, chat ("export executive summary to Word"), or automatically after proposal-generator

PDF / PPTX / MP4 → route to `huashu-design`, not here.

## CLI examples

```bash
python skills/renderers/scripts/render_docx.py --input path/to.md --output path/to.docx --toc
python skills/renderers/scripts/render_xlsx.py --input envelope.json --output matrix.xlsx --title "Compliance"
```