Initial commit

commands/analyze_user_behavior.md

@@ -0,0 +1,120 @@
+---
+description: Analyze user behavior patterns and cohorts using PostHog
+category: analytics
+tools: Task, TodoWrite
+model: inherit
+version: 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
+
+```bash
+/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
+
+```bash
+/analyze-user-behavior "Show conversion rate from signup to first purchase, broken down by traffic source"
+```
+
+### Feature Adoption
+
+```bash
+/analyze-user-behavior "How many users adopted the new search feature in the last week?"
+```
+
+### Retention Cohorts
+
+```bash
+/analyze-user-behavior "Show weekly retention for users who signed up in December 2024"
+```
+
+### User Journey
+
+```bash
+/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:
+
+```bash
+/plugin disable catalyst-analytics
+```
+
+---
+
+**See also**: `/product-metrics`, `/segment-analysis`