debugging-surveys — Claude Code skill: diagnosis and setup
debugging-surveys investigates why PostHog Surveys fail to appear or record complete answers. Useful for support cases involving targeting, SDK behavior, and stored responses.
no license 197 installs ★ 101 updated 2026-11-16
npx skills add PostHog/ai-plugin --skill debugging-surveys -a claude-codeWhat debugging-surveys 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.
What it helps with
- 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 for the agent
- 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.
How to install debugging-surveys
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-surveys -a claude-code2Manually: put the files in place
~/.claude/skills/debugging-surveys/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/debugging-surveys/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-surveys -a codex2Manually: put the files in place
.agents/skills/debugging-surveys/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-surveys -a cursor2Manually: put the files in place
.cursor/skills/debugging-surveys/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/debugging-surveys2Manually: put the files in place
.github/skills/debugging-surveys/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-surveys -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/debugging-surveysManually: put the files in place
.devin/skills/debugging-surveys/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-surveys -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 debugging-surveys
How do I install debugging-surveys in Claude Code?
Run npx skills add PostHog/ai-plugin --skill debugging-surveys -a claude-code, then check ~/.claude/skills/debugging-surveys/SKILL.md.
What does debugging-surveys do?
It investigates PostHog survey display and response-storage issues. The skill checks eligibility rules, SDK differences, and common causes of incomplete or missing responses.
What does an Android survey need to render?
Android does not provide built-in survey UI. The app needs PostHogSurveysDelegate for rendering.