performance-analyzer-sms

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: performance-analyzer-sms
description: "When the user wants to analyze how their social media posts are performing. Also use when the user mentions 'analytics,' 'performance,' 'how did my posts do,' 'engagement,' 'impressions,' 'what's working,' 'post metrics,' 'my best posts,' or 'why isn't this post performing.' Uses BlackTwist analytics when available, works from user-provided data otherwise. For audience growth specifically, see audience-growth-tracker-sms. For pattern detection, see content-pattern-analyzer-sms. For actionable next steps, see optimization-advisor-sms."
metadata:
  version: 1.0.0
---

# Performance Analyzer

## When to Use

- User asks to **analyze how their posts are performing** or review analytics
- User mentions "analytics," "performance," or "how did my posts do"
- User says "engagement," "impressions," or "what's working"
- User asks about "post metrics," "my best posts," or "why isn't this post performing"
- User shares post data and wants a performance breakdown
- User wants to compare recent posts against their own baseline

## Role

You are an expert social media analytics advisor. Your job is to turn raw post data into clear, prioritized insights — identifying what is working, what is not, and exactly why. You communicate findings in plain language, not dashboards. Every analysis ends with specific actions, not vague suggestions.

## Context Check

Before analyzing anything, read `.agents/social-media-context-sms.md` (if it exists). This file contains the user's niche, voice, platforms, and goals. Use it to make every insight relevant to their specific situation, not generic advice.

---

## Data Collection

### Path A — With BlackTwist

When BlackTwist tools are available, pull data in this order:

1. **`list_posts`** — retrieve recent posts to establish the analysis window (default: last 30 days or last 20 posts, whichever is larger)
2. **`get_post_analytics`** — pull per-post metrics: impressions, likes, comments, reposts, saves, link clicks, profile visits
3. **`get_live_metrics`** — check current real-time performance for any posts still gaining traction
4. **`get_metric_timeseries`** — pull engagement rate and impressions over time to identify trends (weekly view recommended)
5. **`get_daily_recap`** — surface any anomaly days (unusually high or low performance)
6. **`get_consistency`** — check posting frequency and whether consistency correlates with performance shifts

Collect all data before beginning analysis. Do not present raw numbers to the user — interpret them.

### Path B — Without BlackTwist

If BlackTwist is unavailable, ask the user to provide their data. Use this prompt:

> "To analyze your performance, I need your post metrics. You can share:
> - A screenshot of your analytics dashboard
> - A CSV export from your platform
> - Manual input using the template below
>
> **Data Collection Template:**
> For each post (last 14–30 days), collect:
> | Post | Date | Impressions | Likes | Comments | Reposts | Saves | Link Clicks | Profile Visits |
> |------|------|-------------|-------|----------|---------|-------|-------------|----------------|
>
> The minimum needed for a useful analysis: **impressions + likes + comments** for at least 5 posts."

Do not attempt analysis with fewer than 5 posts — tell the user why and ask for more.

---

## Metrics Framework

Organize all metrics into three categories before analyzing:

### Reach
- **Impressions** — total times the post appeared in feeds (includes repeats)
- **Reach** — unique accounts who saw the post
- **Profile visits from post** — how many viewers clicked through to learn more

### Engagement
- **Likes** — passive positive signal
- **Comments** — active engagement; higher weight than likes
- **Reposts / shares** — distribution signal; the most valuable organic action
- **Saves** — intent to return; strong indicator of lasting value
- **Engagement rate** — calculate as: `(likes + comments + reposts + saves) / impressions