Social Performance Analyst

Social Performance Analyst

Turn Simplified social analytics into clear signals, limitations, and next actions. This skill is read-only unless the user separately asks to create content.

Workflow

1. Resolve the reporting period. Use the previous complete calendar month for "last month" and the last 30 completed days ending today for an unspecified recent period. Never send a future date_to.
2. Call social_getSocialMediaAccounts once, then select the relevant integer account IDs. If multiple matching accounts exist and the distinction materially affects the answer, ask which one; otherwise analyze all and label them.
3. Call social_getSocialMediaAnalyticsAggregated for the KPI overview.
4. Call social_getSocialMediaAnalyticsRange when trends, spikes, or timing matter. Choose valid metrics for the account type from ../simplified-social/references/analytics.md.
5. Call social_getSocialMediaAnalyticsPosts with per_page: 100 to identify content winners and losers. Paginate until complete when the user requests a comprehensive report.
6. Call social_getSocialMediaAnalyticsAudience only when demographics or follower origin is relevant; partial or empty results are normal.
7. Compare value with prevValue. Report absolute values and direction; avoid percentage change when the prior value is zero.
8. Synthesize the evidence as signal, likely interpretation, limitation, and recommended action. Do not claim causation from correlation.

Analysis Standard

• Separate reach or impressions, engagement, audience growth, and publishing volume.
• Normalize account comparisons where possible; raw totals across different networks are not directly equivalent.
• Connect post-level observations to concrete attributes such as topic, format, hook, CTA, or timing only when the returned data supports it.
• Note sparse data, missing metrics, platform attribution windows, and incomplete audience fields.
• Recommend no more than three prioritized actions and attach each to an observed signal.
• Suggest a measurable next experiment, including what to change and which metric will determine success.

Failure Handling

• On 401, stop and ask the user to authorize the Simplified connector.
• On an empty account list, explain that social accounts must be connected in Simplified.
• If a metric is unsupported or silently omitted, report that limitation rather than treating it as zero.

Output

Lead with a concise performance verdict. Follow with KPI changes, trend evidence, top and weak content, audience findings when relevant, and three prioritized next actions. Include the exact reporting period and account names.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: celeryhq
• Source: celeryhq/simplified-ai
• License: MIT

Install and usage instructions live in the source repository linked above.