home / skills / phrazzld / claude-config / marketing-status

marketing-status skill

/skills/marketing-status

This skill provides a CLI marketing dashboard that aggregates traffic, activation, and revenue from PostHog, Stripe, and Postiz MCPs.

npx playbooks add skill phrazzld/claude-config --skill marketing-status

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
3.6 KB
---
name: marketing-status
description: |
  CLI dashboard for marketing metrics. Pulls from PostHog, Stripe,
  and Postiz MCPs when configured. Shows traffic, activation, conversion.
  Includes CLI script examples for direct API access.
effort: high
---

# /marketing-status

Marketing metrics dashboard. Shows what's working.

## Philosophy

If you can't measure it, you can't iterate. Three metrics that matter:
1. Traffic source - where people came from
2. Activation - did they do the core thing once?
3. Conversion - paid or email signup

## Output Format

Show a dashboard like:

```
MARKETING STATUS
================

Traffic (last 7 days)
├─ Direct: XXX
├─ Twitter: XXX
├─ Reddit: XXX
├─ HN: XXX
└─ Other: XXX

Activation
├─ Signups: XXX
├─ Activated: XXX (XX%)
└─ Core action: XXX

Revenue (Stripe)
├─ MRR: $XXX
├─ New this week: $XXX
└─ Churn: $XXX
```

## Data Sources

### PostHog MCP (if configured)
- Traffic by source
- Signup events
- Activation events (custom)
- Core action events (custom)

### Stripe MCP (if configured)
- MRR calculation
- New revenue
- Churn

### Postiz MCP (if configured)
- Post performance
- Engagement metrics
- Scheduled posts

## CLI Script Examples

### PostHog via MCP (Preferred)

When PostHog MCP is configured, Claude can query directly:
- "What are my top traffic sources this week?"
- "Show signup conversion rate by source"
- "Which features have the highest engagement?"

### PostHog via CLI

```bash
# Get pageviews for last 7 days
curl -s "https://app.posthog.com/api/projects/${POSTHOG_PROJECT_ID}/insights/trend/" \
  -H "Authorization: Bearer $POSTHOG_API_KEY" \
  -d '{"events": [{"id": "$pageview"}], "date_from": "-7d"}' | jq '.result[0].data | add'

# Get signups by referrer
curl -s "https://app.posthog.com/api/projects/${POSTHOG_PROJECT_ID}/insights/trend/" \
  -H "Authorization: Bearer $POSTHOG_API_KEY" \
  -d '{"events": [{"id": "signup"}], "breakdown": "$referrer", "date_from": "-7d"}' | jq

# Get feature flag evaluations
curl -s "https://app.posthog.com/api/projects/${POSTHOG_PROJECT_ID}/feature_flags/" \
  -H "Authorization: Bearer $POSTHOG_API_KEY" | jq '.[].key'
```

### Stripe via CLI

```bash
# MRR calculation (active subscriptions)
stripe subscriptions list --status=active --limit=100 | jq '[.data[].plan.amount] | add / 100'

# New revenue this week
stripe balance_transactions list --created[gte]=$(date -v-7d +%s) --limit=100 | jq '[.data[].amount] | add / 100'

# Churn (canceled subscriptions)
stripe subscriptions list --status=canceled --created[gte]=$(date -v-7d +%s) | jq '[.data[].plan.amount] | add / 100'
```

## Fallback (No MCPs)

If MCPs not configured, show:
1. Instructions for setting up PostHog
2. Links to dashboards (PostHog, Stripe, etc.)
3. Recommend running /check-observability

## Process

1. Check which MCPs are available
2. Pull metrics from available sources
3. Format into dashboard view
4. Highlight anomalies or opportunities
5. Suggest next actions based on data

## MCP Configuration

Add to your Claude config for full MCP integration:

```json
{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": ["-y", "@posthog/mcp-server"],
      "env": {
        "POSTHOG_API_KEY": "your-api-key",
        "POSTHOG_PROJECT_ID": "your-project-id"
      }
    },
    "stripe": {
      "command": "npx",
      "args": ["-y", "@stripe/mcp", "--tools=all"],
      "env": {
        "STRIPE_SECRET_KEY": "your-stripe-key"
      }
    }
  }
}
```

## Related Skills

- /check-observability - Audit analytics setup
- /growth-sprint - Weekly marketing ritual
- /check-stripe - Stripe integration audit

Overview

This skill is a CLI dashboard for core marketing metrics that quickly shows what’s working. It pulls traffic, activation, and conversion data from PostHog, Stripe, and Postiz when configured, and falls back to setup guidance and links when not. The output is a compact terminal view and includes CLI examples for direct API access.

How this skill works

It detects configured MCPs (PostHog, Stripe, Postiz) and queries those endpoints to gather traffic by source, signup and activation events, core action events, revenue (MRR, new revenue, churn), and post performance. The tool formats those results into a simple dashboard in the terminal, highlights anomalies or opportunities, and suggests next actions. If MCPs are not configured, it prints setup instructions and recommended diagnostic steps.

When to use it

  • Weekly marketing reviews to see top traffic sources, activation, and revenue at a glance
  • During growth sprints to prioritize experiments based on conversion and activation trends
  • When you need quick CLI access to PostHog or Stripe metrics without opening multiple dashboards
  • For on-call or incident triage to spot sudden drops in traffic, activation, or payments
  • Before planning outreach or content to identify high-performing channels

Best practices

  • Configure PostHog MCP to get traffic breakdowns, signup conversions, and custom activation events
  • Connect Stripe MCP for automated MRR, new revenue, and churn calculations instead of manual spreadsheets
  • Tag referrers and track a single clear activation event to keep conversion math simple and actionable
  • Run the CLI dashboard on a schedule (e.g., cron) and surface anomalies via your communication channel
  • Use the provided curl/stripe CLI examples for ad-hoc deep dives when MCPs are not available

Example use cases

  • Show top traffic sources and signup conversion rates for the last 7 days before your weekly marketing sync
  • Inspect activation funnel after a product launch to confirm new users perform the core action
  • Monitor MRR and new revenue this week following a pricing change or promotional campaign
  • Run a quick check when you suspect analytics gaps—fallback instructions guide PostHog setup
  • Query post performance and engagement from Postiz to decide which content to amplify

FAQ

What happens if no MCPs are configured?

The CLI shows setup instructions, links to relevant dashboards, and recommends running an observability check to get analytics flowing.

Can I run queries directly against PostHog or Stripe?

Yes. The skill includes curl and Stripe CLI examples for direct API access when MCP integrations are not available or for custom queries.