Files
gh-coalesce-labs-catalyst-p…/commands/analyze_user_behavior.md
2025-11-29 18:14:34 +08:00

2.6 KiB

description, category, tools, model, version
description category tools model version
Analyze user behavior patterns and cohorts using PostHog analytics Task, TodoWrite inherit 1.0.0

Analyze User Behavior

Query PostHog to understand user behavior patterns, cohorts, and product usage.

Prerequisites

  • PostHog MCP must be enabled (this plugin should be enabled)
  • POSTHOG_AUTH_HEADER environment variable configured
  • Access to PostHog project

Usage

/analyze-user-behavior <query>

Examples:
  /analyze-user-behavior "checkout abandonment last 30 days"
  /analyze-user-behavior "feature adoption for new dashboard"
  /analyze-user-behavior "user retention cohorts by signup month"

What This Command Does

Uses PostHog MCP tools to:

  1. Query user events and properties
  2. Analyze cohorts and segments
  3. Calculate conversion metrics
  4. Identify behavior patterns
  5. Generate insights with charts/data

Available PostHog Capabilities

When this plugin is enabled, you have access to ~43 PostHog tools:

User Analysis:

  • Query user properties and events
  • Segment users by behavior
  • Track user journeys
  • Analyze cohort retention

Product Metrics:

  • Feature usage tracking
  • Conversion funnel analysis
  • A/B test results
  • Session replay analysis

Trends & Insights:

  • Event trends over time
  • User engagement metrics
  • Feature adoption rates
  • Custom dashboard queries

Example Queries

Conversion Analysis

/analyze-user-behavior "Show conversion rate from signup to first purchase, broken down by traffic source"

Feature Adoption

/analyze-user-behavior "How many users adopted the new search feature in the last week?"

Retention Cohorts

/analyze-user-behavior "Show weekly retention for users who signed up in December 2024"

User Journey

/analyze-user-behavior "What's the typical path users take before upgrading to paid plan?"

Output Format

The command will:

  1. Translate your natural language query to PostHog API calls
  2. Fetch relevant data
  3. Present findings with:
    • Key metrics and numbers
    • Trends and patterns
    • Visualizations (when possible)
    • Actionable insights

Tips

  • Be specific about time ranges ("last 30 days", "this quarter")
  • Mention specific events or features by name
  • Ask for comparisons ("vs last month", "broken down by...")
  • Request segmentation ("by country", "by plan type")

Context Cost

This plugin adds ~40,645 tokens to your context window. Disable when not analyzing metrics:

/plugin disable catalyst-analytics

See also: /product-metrics, /segment-analysis