gather-business-context — Codex skill: what it does, how to install
Extracts business definitions, metric context, and source owners before analytical work starts. It frames the question so subsequent skills operate on verified facts.
npx skills add openai/plugins --skill gather-business-context -a codexWhat gather-business-context does
This skill inspects connected catalogs, metadata, and company artifacts to clarify ambiguous tasks. Instead of jumping straight into SQL or statistical runs, it identifies who owns the subject, what the metric represents, and which decision is currently on the table.
The process uses targeted search anchors instead of loose guesses. It checks schemas, views, and shared records, then compares duplicates. If an earlier specification disagrees with what actually shipped, it gives precedence to the live implementation and records the discrepancy openly.
It deliberately stops short of diagnostics or reporting. Once the framing note with sources and known caveats is assembled, it routes the downstream task to skills like $metric-diagnostics or $build-report.
What it helps with
- clarify ambiguous metric definitions before data extraction
- surface source owners and schema catalogs for vague requests
- track down conflicts between written roadmaps and deployed features
- frame baseline assumptions before running diagnostic models
Example prompts for the agent
- Collect the business context and owner notes for our churn calculation
- Frame the recent checkout changes before running metric diagnostics
- Identify authoritative sources and definitions for the active subscriber KPI
How to install gather-business-context
1Skills CLI (Vercel)
npx skills add openai/plugins --skill gather-business-context -a codex2Manually: put the files in place
.agents/skills/gather-business-context/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill gather-business-context -a claude-code2Manually: put the files in place
~/.claude/skills/gather-business-context/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gather-business-context/
Manually: put the files in place
.cursor/skills/gather-business-context/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins gather-business-context2Manually: put the files in place
.github/skills/gather-business-context/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/gather-business-contextManually: put the files in place
.devin/skills/gather-business-context/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 gather-business-context
How to install gather-business-context in Codex?
Run npx skills add openai/plugins --skill gather-business-context -a codex in your terminal.
What does gather-business-context do?
It retrieves metric definitions, verifies source authority, and extracts framing notes so downstream analytics start with reliable background facts.
Does this skill perform root-cause analysis or generate dashboards?
No. It only gathers background facts and hands off the structured note to downstream tools like $build-dashboard or $metric-diagnostics.
