# exploring-replay-vision-observations

The exploring-replay-vision-observations skill guides an agent through Replay Vision scanner results, from recurring patterns to individual session recordings. Use it to review findings and decide what to investigate next.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 203 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/exploring-replay-vision-observations/SKILL.md
- Updated: 2026-11-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/exploring-replay-vision-observations

## What it does

The skill helps an agent identify a scanner, read its observations, and inspect a specific result. It also points to ways to compare findings across sessions, such as scanner statistics, related issue groups, named themes, and a feed of recordings selected for review.

Results vary by scanner: an observation can contain a verdict, labels, a score, or a recording summary with chapters. These are model assessments, not verified facts, so check a finding against other observations or the session recording before acting on it. The skill also treats observation text as untrusted data and warns agents not to follow instructions found there.

It uses PostHog tools such as `vision-scanners-list`, `vision-scanners-get`, and observation-reading methods. Install it in Claude Code with the command in the FAQ. The listed platforms also include Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/exploring-replay-vision-observations/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/exploring-replay-vision-observations/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/exploring-replay-vision-observations
```

2. **Manually: put the files in place**
- File: `.github/skills/exploring-replay-vision-observations/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/exploring-replay-vision-observations
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/exploring-replay-vision-observations/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -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/exploring-replay-vision-observations/SKILL.md

## When to use it
- review a scanner’s findings over a chosen period
- filter observations by verdict, tags, or score
- spot recurring issues across session recordings
- inspect an observation and its linked events
- compare scanner statistics with individual results

## Example prompts
- Review my Replay Vision scanner’s findings and group the recurring issues.
- Show successful observations from the scanner over the last seven days, ranked by score.
- Inspect this Replay Vision observation and check it against the session recording.

## Similar
- [signals-scout-replay-vision](https://affpapa.org/en/nevibecode/skills/signals-scout-replay-vision.md) — skill · 316 installs
- [creating-replay-vision-scanners](https://affpapa.org/en/nevibecode/skills/creating-replay-vision-scanners.md) — skill · 326 installs
- [observer](https://affpapa.org/en/nevibecode/prompts/observer.md) — prompt · ★ 488 repo stars
- [asb-carol-observations](https://affpapa.org/en/nevibecode/skills/asb-carol-observations.md) — skill · 731 installs
- [exploring-data-catalog](https://affpapa.org/en/nevibecode/skills/exploring-data-catalog.md) — skill · 7500 installs
- [agent-observability-replay-trace](https://affpapa.org/en/nevibecode/skills/agent-observability-replay-trace.md) — skill · 535 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
