social-media-analyzer

Analyzes social media campaign data to calculate engagement rates, ROI, and platform benchmark comparisons.

Updated May 18, 2026
One-click install
npx skills add https://github.com/rigasnameji/address_uluwatu --skill social-media-analyzer-rigasnameji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: social-media-analyzer
Source: https://github.com/rigasnameji/address_uluwatu/tree/main/ADDRESS/marketing-skill/social-media-analyzer
Command: npx skills add https://github.com/rigasnameji/address_uluwatu --skill social-media-analyzer-rigasnameji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Marketers struggle to turn raw social media metrics (likes, comments, reach, spend) into clear performance insights and ROI figures without manual spreadsheet calculations and benchmark research. ## Core Features & Use Cases - Engagement Metrics: Calculates engagement rate, CTR, reach rate, virality, and save rate per post and across campaigns. - ROI Analysis: Computes cost per engagement, cost per click, CPM, and ROI percentage from ad spend data. - Benchmark Comparison: Compares results against platform-specific benchmarks for Instagram, Facebook, Twitter/X, LinkedIn, and TikTok, then generates recommendations. - Use Case: Provide a JSON of Instagram post metrics with $500 ad spend and receive a full report showing an 8.36% engagement rate, 660% ROI, top-performing posts, and scaling recommendations. ## Quick Start Ask the AI to analyze your social media campaign data and calculate engagement rate and ROI compared to platform benchmarks.

Frequently Asked Questions about social-media-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate social media engagement rate?▼

Engagement rate is calculated as (likes + comments + shares + saves) divided by reach, multiplied by 100. The calculate_metrics.py script computes this per post and aggregates campaign-level averages automatically.

How to measure ROI on a social media ad campaign?▼

Provide your total ad spend along with post metrics, and the analyzer computes cost per engagement, cost per click, and ROI percentage. ROI uses estimated engagement values such as $0.50 per like and $5.00 per share.

What is a good engagement rate on Instagram or TikTok?▼

Instagram averages 1.22% engagement, with above 6% rated excellent, while TikTok averages 5.96% with above 15% excellent. The references/platform-benchmarks.md file lists benchmarks by platform, industry, and content type.

What input data format does the social media analyzer require?▼

Input is a JSON object with platform name, optional total_spend, and a posts array containing likes, comments, and reach per post. Optional fields include shares, saves, impressions, and clicks, as shown in assets/sample_input.json.

Why does engagement rate calculation fail or return zero?▼

Calculation fails when reach is zero, causing division errors, or when engagement counts are missing. The scripts use safe division returning 0.0, but you should validate that reach is greater than zero for all posts before analysis.