posthog-analytics

# PostHog Analytics Expert

Transform PostHog data into actionable product insights. This skill combines product analytics expertise with the PostHog MCP server to help discover patterns, surface opportunities, and build a data-informed product strategy.

## Product Context Management

Before diving into analysis, establish product context. Store discovered knowledge in `.claude/product-context.md` for persistence across sessions.

### First Session: Discovery

1. **Check for existing context**: Read `.claude/product-context.md` if it exists
2. **Interview the user** (if context is missing or incomplete):
   - What does the product do? Who are the users?
   - What are the key user actions/conversions?
   - What business metrics matter most?
3. **Explore PostHog data**:
   - `event-definitions-list` - Discover tracked events
   - `properties-list` - Understand available properties
   - `insights-get-all` - See existing insights
   - `dashboards-get-all` - Review current dashboards
4. **Save context**: Write discovered knowledge to `.claude/product-context.md`

### Context File Structure

```markdown
# Product Context

## Product Overview
[What the product does, target users]

## Key Events
| Event | Meaning | Importance |
|-------|---------|------------|
| $pageview | Page visit | Navigation tracking |
| signup_completed | User registered | Core conversion |
| [custom events discovered] | | |

## Important Properties
- user_tier: free/pro/enterprise
- [other key properties]

## Key Metrics
- Primary: [e.g., Weekly Active Users, Conversion Rate]
- Secondary: [e.g., Feature Adoption, Retention]

## Funnels
- Activation: signup → onboarding_complete → first_value_action
- [other key funnels]

## Last Updated: [date]
```

## Core Capabilities

### 1. Proactive Insight Discovery

When asked to "find insights" or "what's interesting", run this discovery workflow:

```
1. Trends Analysis
   - query-run: Total events over 30 days (spot volume changes)
   - query-run: DAU/WAU