# adding-warehouse-person-properties

The adding-warehouse-person-properties Claude Code skill maps columns from a synced warehouse table to PostHog person or group properties. It activates for requests to add warehouse data to profiles or manage an existing mapping.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 148 installs · ★ 101 repo stars
- Author: PostHog
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/adding-warehouse-person-properties/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/adding-warehouse-person-properties

## What it does

The skill connects selected warehouse columns to person or group properties in PostHog. It locates the table schema, checks its columns and matching key, then creates the property mapping. The resulting values work wherever PostHog uses person and group properties.

Matching requires a real person `distinct_id` or group key; an internal database primary key usually will not match. The project needs the `warehouse-person-properties` feature enabled, and the caller needs warehouse source editor access. Group mappings also require the paid groups feature, an existing group type, and `group:read` and `group:write` permissions.

The skill can inspect sync status and run history, disable a mapping, or refresh historical values with a backfill. A full warehouse sync is billable; backfills are not. If the warehouse source has not been connected, `setting-up-a-data-warehouse-source` is needed first.

## Requirements
- Works with: PostgreSQL, Salesforce, Stripe

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill adding-warehouse-person-properties -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill adding-warehouse-person-properties -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/adding-warehouse-person-properties/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill adding-warehouse-person-properties -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/adding-warehouse-person-properties/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/adding-warehouse-person-properties
```

2. **Manually: put the files in place**
- File: `.github/skills/adding-warehouse-person-properties/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill adding-warehouse-person-properties -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/adding-warehouse-person-properties
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/adding-warehouse-person-properties/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill adding-warehouse-person-properties -a opencode
```

### 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/PostHog/ai-plugin/tree/HEAD/skills/adding-warehouse-person-properties/SKILL.md

## When to use it
- copy a plan tier or ARR column into PostHog person properties
- target a feature flag using a warehouse column
- map an accounts table to organization properties
- find why a mapping leaves person properties unchanged
- refresh existing values with a backfill

## Example prompts
- Add the plan tier from my Stripe table to PostHog person properties.
- Map the Postgres `accounts` table to organization properties.
- Find why warehouse values are missing from person properties, then refresh the historical values.

## Similar
- [diagnosing-failed-warehouse-syncs](https://affpapa.org/en/nevibecode/skills/diagnosing-failed-warehouse-syncs.md) — skill · 401 installs
- [setting-up-a-data-warehouse-source](https://affpapa.org/en/nevibecode/skills/setting-up-a-data-warehouse-source.md) — skill · 405 installs
- [cleanup-properties](https://affpapa.org/en/nevibecode/skills/cleanup-properties.md) — skill · ★ 81 repo stars
- [adding-stripe](https://affpapa.org/en/nevibecode/skills/adding-stripe.md) — skill · 406 installs
- [data-context-extractor](https://affpapa.org/en/nevibecode/skills/data-context-extractor.md) — skill · 3300 installs
- [adding-analytics](https://affpapa.org/en/nevibecode/skills/adding-analytics.md) — skill · 410 installs

From the same set: [posthog/ai-plugin](https://affpapa.org/en/nevibecode/by/posthog/ai-plugin.md) — 82 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
