# create-data-context

Builds and maintains a semantic layer that records how data should be read, which metric counts as canonical, and what caveats to check.

- skill · `type=skill` · Codex, ChatGPT · 1 install · ★ 7596
- Author: Data Analytics Maintainers · official OpenAI repository
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openai/plugins/tree/HEAD/plugins/data-analytics/skills/create-data-context/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/create-data-context

## What it does

The skill produces a separate artifact you can open and point to in later prompts. It records which metric definition to treat as canonical, which dashboard or table is the source of truth, and which caveats deserve a look before an answer goes out.

It runs only when someone asks to save data context or to create, update, inspect, or repair a semantic layer. Ordinary data work — a metric question, a report, a dataset check — belongs to the `index` skill. One layer covers a single product, business, metric, source, or reporting area unless a broader shared layer is requested.

Before crawling, the skill drafts a source list: what was checked, what is missing, where confidence is lower. Durable evidence wins — transformation code, tests, maintained metric docs, verified dashboards. When sources disagree, the conflict stays visible rather than being resolved quietly. On ChatGPT Desktop it writes to `$CODEX_HOME/skills/<area>-semantic-layer` by default; if that variable is unavailable and the local setup plainly uses the standard home directory, the path becomes `~/.codex/skills/<area>-semantic-layer`. Generated skills stay compact: definitions, tables, query patterns, and evidence live in linked files, while raw sensitive data, credentials, and row-level examples are kept out.

## Install

### Codex (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill create-data-context -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/create-data-context/SKILL.md` — For all projects use ~/.agents/skills/

### Claude Code

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill create-data-context -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/create-data-context/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/create-data-context/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/create-data-context/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins create-data-context
```

2. **Manually: put the files in place**
- File: `.github/skills/create-data-context/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/create-data-context
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/create-data-context/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/openai/plugins/tree/HEAD/plugins/data-analytics/skills/create-data-context/SKILL.md

## When to use it
- pin down which metric definition is canonical
- name the dashboard or table that counts as source of truth
- list sources and flag where coverage is thin
- keep disagreements between sources visible
- refresh the semantic layer when understanding of the data shifts

## Example prompts
- Save the data context for revenue: which metric is canonical and what to check first
- Create a semantic layer for the orders reporting area
- Inspect the semantic layer and add the sources it is missing

## Similar
- [xlsx](https://affpapa.org/en/nevibecode/skills/xlsx.md) — skill · 187223 installs
- [google-agents-cli-observability](https://affpapa.org/en/nevibecode/skills/google-agents-cli-observability.md) — skill · 511300 installs
- [caveman-evidence-review](https://affpapa.org/en/nevibecode/skills/caveman-evidence-review.md) — skill · 104500 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs
- [performance-optimization](https://affpapa.org/en/nevibecode/skills/performance-optimization.md) — skill · 65200 installs

From the same set: [openai/plugins](https://affpapa.org/en/nevibecode/by/openai/plugins.md) — 360 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md