report-to-pdf — Codex skill: what it does, how to install
Converts Data Analytics reports and charts from static HTML into clean PDF documents using headless Chrome.
npx skills add openai/plugins --skill report-to-pdf -a codexWhat report-to-pdf does
This skill renders analytical dashboards and charts into PDF files. It relies strictly on static HTML exports. Trying to print straight out of a live MCP frame in ChatGPT Desktop fails because its sandbox blocks PDF bridges.
The conversion executes Chrome or Chromium CLI with the --headless=new flag and --print-to-pdf. During processing, the skill strips UI controls like refresh toggles and internal debug properties. If only raw session state remains in artifact.json, a Node.js script generates the standalone HTML page first.
The output goes through inspection scripts using pdfinfo, pdftotext, and pdftoppm. These utilities spot layout clipping and blank areas. Without Chrome, the task stops immediately.
What it helps with
- turn static HTML analytics dashboards into printable PDF documents
- strip interactive buttons and debug metadata from report pages
- verify exported PDFs for missing charts or text issues with
pdftoppm - build a standalone HTML file from
artifact.jsonbefore printing
Example prompts for the agent
- Export the static analytics dashboard in report.html to a PDF file.
- Convert the current Data Analytics export into a clean PDF document.
How to install report-to-pdf
1Skills CLI (Vercel)
npx skills add openai/plugins --skill report-to-pdf -a codex2Manually: put the files in place
.agents/skills/report-to-pdf/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill report-to-pdf -a claude-code2Manually: put the files in place
~/.claude/skills/report-to-pdf/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/report-to-pdf/
Manually: put the files in place
.cursor/skills/report-to-pdf/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins report-to-pdf2Manually: put the files in place
.github/skills/report-to-pdf/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/build-report/report-to-pdfManually: put the files in place
.devin/skills/report-to-pdf/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about report-to-pdf
How to install report-to-pdf in Codex?
Run npx skills add openai/plugins --skill report-to-pdf -a codex. Alternatively, save the skill definition directly to .agents/skills/report-to-pdf/SKILL.md.
What does report-to-pdf do?
It takes a static HTML export of a dashboard or report and converts it into a PDF via headless browser rendering. It also inspects pages for rendering defects and cleans out UI controls.
Why does it require a static HTML export instead of live app printing?
Sandboxed hosts such as ChatGPT Desktop do not provide print bridges for live MCP views. Extracting or rendering static markup first ensures the headless browser can read the document.
