branded-reportlisted

Turn a Markdown report into a polished, consistently branded document in HTML, PDF, and DOCX — all three from one source and one theme, so every report looks identical. The theme (brand colors, fonts, logo, organization name) can be auto-extracted from a PowerPoint/Office template (.pptx/.potx/.thmx/.docx/.xlsx), or — when there is no Office file — sampled from an image, a website URL, or a PDF, so the output matches the corporate identity. Use when the user wants a standardized, branded, or "nicely formatted" report/document, wants the same report as PDF and/or Word and/or HTML, asks for a company-templated report, wants output that matches a PowerPoint/website/PDF design or color theme, or wants to derive brand colors and a logo from a template, image, web page, or PDF. Requires Python 3.8+ (markdown, python-docx, beautifulsoup4; pillow/pypdfium2/pypdf for image/PDF theme extraction); PDF output additionally needs a headless Chrome/Edge/Chromium.
whobat/AI-Agent-skills · ★ 0 · Data & Documents · score 76

Install: claude install-skill whobat/AI-Agent-skills

# Branded Report > Generates **HTML, PDF, and DOCX** from a single Markdown file and a single theme, so a > series of reports always looks the same. The agent supplies the content (Markdown) and > the cover metadata; the script does the rendering. Deterministic — no LLM is called. `SCRIPT` = this skill's `scripts/build_report.py`. Theme extraction = `scripts/extract_theme.py`. The theme schema and styling details are in [REFERENCE.md](REFERENCE.md). ## The theme (do this once per brand) The look is driven by a small `theme.json` (colors, fonts, logo, organization). Get one by: - **From an Office template** (most accurate) — reads the real color scheme + fonts: ```bash python EXTRACT --template "Brand.pptx" --out theme.json --logo-dir ./assets ``` Works with **`.pptx`, `.potx`, `.thmx`, `.dotx`, `.docx`, `.xlsx`** — anything carrying an OOXML theme. Then open `theme.json` and pick the right `logo` (a dark/colored logo for white pages; **DOCX needs a PNG/JPG** logo via `logo_raster` — SVG embeds only in HTML/PDF). - **From an image, a website, or a PDF** (when there is no Office theme) — `extract_theme_visual.py` renders the source and samples its brand colors (heuristic; review the result): ```bash python VISUAL --image brand.png --out theme.json python VISUAL --url https://acme.example --out theme.json --logo-dir ./assets # + logo + org + fonts python VISUAL --pdf branded.pdf --page 1 --out theme.json ``` A PDF or image of an already-branded d