Planning user interviews

Use this skill when someone asks to set up a user interview — to talk to customers, check sentiment, or gather qualitative feedback through a voice conversation. The plan is captured as a UserInterviewTopic that a voice agent will later run through.

What a complete topic needs

Before calling user-interview-topics-create, gather these:

1. Who to interview — at least one of:
   • interviewee_emails — list of email addresses
   • interviewee_distinct_ids — list of PostHog distinct IDs
2. What to ask about — topic (required free text)
3. How the agent should frame the conversation — optional agent_context (extra system prompt)
4. The questions to work through — optional ordered questions list

Topics snapshot their audience at create time — there is no live cohort link. If the user names a cohort, you (the agent) resolve cohort members to emails/distinct_ids before calling user-interview-topics-create. See Step 2 for the resolution flow and the 500-member cap UX.

The API rejects topics with no targeting, so interviewee_emails and/or interviewee_distinct_ids must end up non-empty.