planning-voice-agent-user-interviews

Plan automated user interview campaigns conducted by PostHog's AI voice agent.

713|118|Updated Aug 11, 2020
One-click install
npx skills add https://github.com/PostHog/posthog-foss --skill planning-voice-agent-user-interviews
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-voice-agent-user-interviews
Source: https://github.com/PostHog/posthog-foss/tree/main/products/user_interviews/skills/planning-voice-agent-user-interviews
Command: npx skills add https://github.com/PostHog/posthog-foss --skill planning-voice-agent-user-interviews

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up automated user research interviews requires identifying the right participants, resolving cohorts to contactable users, and structuring questions — this Skill orchestrates that entire planning flow and creates a UserInterviewTopic that PostHog's AI voice agent uses to actually call and interview users.

Core Features & Use Cases

  • Audience Resolution: Converts named cohorts, behavioral segments (heavy users, drop-offs, at-risk users), or pasted email lists into interviewee emails and distinct IDs, with a 500-member cap workflow.
  • Interview Design: Captures the research topic, open-ended question lists, and agent framing context (tone, constraints, persona) to guide the voice agent's calls.
  • Per-Interviewee Context: Attaches individual background notes (usage counts, churn status) to specific interviewees via single or bulk CSV-based creation.
  • Use Case: A product manager wants to learn why trial users churned — the Skill finds users who signed up but went dormant, drafts churn-focused questions, and creates a topic so the voice agent calls each user automatically.

Quick Start

Ask the assistant to set up robo user interviews where PostHog's AI voice agent calls users who abandoned checkout and asks them what stopped them from converting.

Frequently Asked Questions about planning-voice-agent-user-interviews

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up automated user interviews with PostHog's voice agent?

Provide a target audience (cohort, emails, or behavioral description), a research topic, and questions. The Skill resolves the audience to emails or distinct IDs and calls user-interview-topics-create so the voice agent can run the calls.

How do I find users to interview based on product behavior?

The Skill queries your PostHog events with HogQL to find heavy users, drop-offs, or at-risk users over the last 60 days. It groups results per person using email or distinct ID and builds a balanced sample across segments.

What happens if my cohort has more than 500 members?

The Skill stops and asks you to choose: narrow the cohort with a more specific filter, randomly sample a confirmed number of members, or paste a curated email list. It never silently truncates the audience.

Can I add different context for individual interviewees?

Yes, per-interviewee context rows pair an identifier with custom agent context, created individually or in bulk from a two-column CSV. Identifiers must exactly match the emails or distinct IDs in the parent topic.

When should I not use the voice agent interview flow?

Do not use it for finding users to interview yourself, planning human-run interviews, uploading recorded audio files, or analyzing existing transcripts. Those are handled by ordinary data queries or the separate UserInterview model.