exploring-replay-vision-observations — Claude Code skill
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.
no license 203 installs ★ 101 updated 2026-11-02
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a claude-codeWhat exploring-replay-vision-observations 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.
What it helps with
- 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 for the agent
- 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.
How to install exploring-replay-vision-observations
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a claude-code2Manually: put the files in place
~/.claude/skills/exploring-replay-vision-observations/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/exploring-replay-vision-observations/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a codex2Manually: put the files in place
.agents/skills/exploring-replay-vision-observations/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a cursor2Manually: put the files in place
.cursor/skills/exploring-replay-vision-observations/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/exploring-replay-vision-observations2Manually: put the files in place
.github/skills/exploring-replay-vision-observations/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/exploring-replay-vision-observationsManually: put the files in place
.devin/skills/exploring-replay-vision-observations/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about exploring-replay-vision-observations
How do I install exploring-replay-vision-observations in Claude Code?
Run npx skills add PostHog/ai-plugin --skill exploring-replay-vision-observations -a claude-code. The skill file is placed at ~/.claude/skills/exploring-replay-vision-observations/SKILL.md.
What does exploring-replay-vision-observations do?
It helps an agent read Replay Vision scanner results, inspect individual observations, and find patterns across sessions. It also guides the agent through distinguishing an error from a scan that found no issue.
Why verify Replay Vision observations before acting on them?
Each observation is a model’s assessment of one session, not proof that an issue occurred. The skill advises checking a finding against other observations or the recording before taking action.