build-report — Codex skill: what it does, how to install
Builds analytical reports with findings, tables, and visuals for executives, product teams, or technical audiences.
npx skills add openai/plugins --skill build-report -a codexWhat build-report does
The skill turns data into structured reports: conclusions first, then evidence, charts, caveats, and source links. It runs in three publishing modes — Sites, MCP app, or standalone HTML — and picks the right one based on platform.
Inside, it follows audience specifications: executive reports for product stakeholders, methods-first documents for technical readers. It separates metrics, SQL queries, and assumptions into metadata blocks to keep the main text readable. Validates the artifact via npm run report:deliver, so npm must be available.
When analysis requires metric calculation or KPI diagnostics, the skill calls focused analysis first, then formats the result. Worth checking whether you have the full data-analytics suite from the same repository.
What it helps with
- turn raw data and SQL logs into an executive report
- format A/B test results into an executive summary with charts
- prepare technical documentation of measurement methodology
- convert notebook output into a stakeholder-ready document
- create a reproducible report with source metadata and caveats
Example prompts for the agent
- Build an executive report on product metrics for the quarter, source is `metrics.db`
- Create a technical report: how we measured conversion, what assumptions, where the limits are
- Turn the analysis in `analysis.ipynb` into a stakeholder report — I need HTML to send
How to install build-report
1Skills CLI (Vercel)
npx skills add openai/plugins --skill build-report -a codex2Manually: put the files in place
.agents/skills/build-report/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill build-report -a claude-code2Manually: put the files in place
~/.claude/skills/build-report/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/build-report/
Manually: put the files in place
.cursor/skills/build-report/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins build-report2Manually: put the files in place
.github/skills/build-report/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/build-reportManually: put the files in place
.devin/skills/build-report/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Similar
Questions about build-report
How to install build-report in Codex?
Run npx skills add openai/plugins --skill build-report in the project root. The skill will appear in .agents/skills/build-report/SKILL.md. You can specify -a codex explicitly: npx skills add openai/plugins --skill build-report -a codex.
What does build-report do?
It builds complete analytical reports: findings, evidence, charts, tables, caveats, and source links. Chooses the publishing format automatically — Sites, MCP app, or HTML — depending on the environment.
Why does build-report need npm?
The skill validates report structure and packages the artifact with npm run report:deliver. Final assembly will not complete without npm.