Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill debugging-surveys -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/debugging-surveys/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/debugging-surveys/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set82

The whole set →
setting-up-a-custom-rest-source setting-up-a-custom-rest-source — a skill for Claude Code and Codex that links arbitrary REST APIs to the PostHog data warehouse using a JSON manifest. Activates when importing custom endpoints without native connectors. CX Codex +1 199installs exploring-ai-failures exploring-ai-failures reads real production traces from PostHog and returns a ranked list of the ways your LLM feature breaks. CX Codex +1 198installs resolving-ingestion-warnings resolving-ingestion-warnings walks through PostHog ingestion warnings: dropped events, rejected person merges, oversized payloads. Use it when event counts look low or identify calls misbehave. CX Codex +1 197installs exploring-scouts exploring-scouts reads the state of PostHog Signals scouts: which ones a project has, how recent runs went, and where their reports ended up. Read-only. CX Codex +1 197installs authoring-scouts authoring-scouts is a Claude Code skill for creating, tuning, and testing PostHog Signals scouts that inspect project metrics on a schedule and submit findings. CX Codex +1 196installs creating-online-evaluations creating-online-evaluations — a Claude Code skill that turns production failure modes into continuously-running online evaluations in PostHog. It starts when new generations need automatic scoring against specific errors. CX Codex +1 195installs signals-scout-insight-alerts signals-scout-insight-alerts — a Claude Code skill for reviewing insight alert history in PostHog. It scans recent alert triggers and flags material incidents that missed notifying the team. CX Codex +1 195installs signals-scout-data-warehouse signals-scout-data-warehouse monitors warehouse imports for failures, stale data, and sharp row-count drops, then flags recurring query patterns that may merit materialized views. CX Codex +1 195installs

Project sponsors

Companies that keep this analytics open