# debugging-surveys

debugging-surveys investigates why PostHog Surveys fail to appear or record complete answers. Useful for support cases involving targeting, SDK behavior, and stored responses.

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

## What it does

This skill examines survey settings and recorded answers through PostHog MCP tools or the Survey API. It follows the checks that control display, including dates, survey type, flags, repeat-view limits, URL and device rules, and event triggers. It also covers partial submissions, branching, optional fields, and automatic submission.

For web surveys, the order of the checks matters: the first failed condition points to the likely cause. The skill includes read-only diagnostic queries, SDK capability checks, and guidance for writing a customer reply. A local checkout of the PostHog repository is not needed for these checks.

Platform behavior differs. Android has no built-in survey renderer, so an app needs `PostHogSurveysDelegate` before a survey can appear. Partial responses and automatic submission are web-only, while URL targeting is handled differently across mobile SDKs.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill debugging-surveys -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill debugging-surveys -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill debugging-surveys -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/debugging-surveys
```

2. **Manually: put the files in place**
- File: `.github/skills/debugging-surveys/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill debugging-surveys -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/debugging-surveys
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- find the condition blocking a survey display
- explain why a response contains only some answers
- compare survey behavior across SDKs
- trace a URL or feature-flag targeting mismatch
- draft a reply to a PostHog Surveys ticket

## Example prompts
- Investigate this ticket: the survey does not appear in the web app.
- Check why PostHog Surveys stored only the answer to the first question.
- Compare this survey on Android and Flutter and identify the likely failure point.

## Similar
- [signals-scout-surveys](https://affpapa.org/en/nevibecode/skills/signals-scout-surveys.md) — skill · 319 installs
- [mobile-app-debugging](https://affpapa.org/en/nevibecode/skills/secondsky-mobile-app-debugging.md) — skill · 446 installs
- [mobile-debugging](https://affpapa.org/en/nevibecode/skills/mobile-debugging.md) — skill · 176 installs
- [Weavely AI Forms & Surveys](https://affpapa.org/en/nevibecode/mcp/weavely-ai-forms-surveys.md) — MCP server · 2515 installs
- [posthog-survey-creator](https://affpapa.org/en/nevibecode/skills/posthog-survey-creator.md) — skill · 225 installs
- [integrate-revenuecat](https://affpapa.org/en/nevibecode/skills/integrate-revenuecat.md) — skill · 1300 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
