social-media-analyzer

Q: How do I install social-media-analyzer?

Run npx skills add https://github.com/alirezarezvani/claude-skills --skill social-media-analyzer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/social-media-analyzer/ (personal) or .claude/skills/social-media-analyzer/ (project).

Q: Which AI agents can use social-media-analyzer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Q: Is social-media-analyzer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Q: Who maintains social-media-analyzer?

It is published by alirezarezvani in alirezarezvani/claude-skills. It has 1,563 recorded installs.

by alirezarezvaniMarketing & SEO

Social media campaign analysis and performance tracking. Calculates engagement rates, ROI, and benchmarks across platforms. Use when analyzing social media performance, calculating engagement rate, measuring campaign ROI, comparing platform metrics, or benchmarking against industry standards. Also use when the user mentions "social media audit," "engagement rate," or "which platform performs best."

Installs: 1.6K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/alirezarezvani/claude-skills --skill social-media-analyzer

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads social-media-analyzer automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Social Media Analyzer

Campaign performance analysis with engagement metrics, ROI calculations, and platform benchmarks.

Analysis Workflow
Engagement Metrics
ROI Calculation
Platform Benchmarks
Tools
Examples

Analysis Workflow

Analyze social media campaign performance:

Validate input data completeness (reach > 0, dates valid)
Calculate engagement metrics per post
Aggregate campaign-level metrics
Calculate ROI if ad spend provided
Compare against platform benchmarks
Identify top and bottom performers
Generate recommendations
Validation: Engagement rate < 100%, ROI matches spend data

Input Requirements

Field	Required	Description
platform	Yes	instagram, facebook, twitter, linkedin, tiktok
posts[]	Yes	Array of post data
posts[].likes	Yes	Like/reaction count
posts[].comments	Yes	Comment count
posts[].reach	Yes	Unique users reached
posts[].impressions	No	Total views
posts[].shares	No	Share/retweet count
posts[].saves	No	Save/bookmark count
posts[].clicks	No	Link clicks
total_spend	No	Ad spend (for ROI)

Data Validation Checks

Before analysis, verify:

Reach > 0 for all posts (avoid division by zero)
Engagement counts are non-negative
Date range is valid (start < end)
Platform is recognized
Spend > 0 if ROI requested

Engagement Metrics

Engagement Rate Calculation

Engagement Rate = (Likes + Comments + Shares + Saves) / Reach × 100

Metric Definitions

Metric	Formula	Interpretation
Engagement Rate	Engagements / Reach × 100	Audience interaction level
CTR	Clicks / Impressions × 100	Content click appeal
Reach Rate	Reach / Followers × 100	Content distribution
Virality Rate	Shares / Impressions × 100	Share-worthiness
Save Rate	Saves / Reach × 100	Content value

Performance Categories

Rating	Engagement Rate	Action
Excellent	> 6%	Scale and replicate
Good	3-6%	Optimize and expand
Average	1-3%	Test improvements
Poor	< 1%	Analyze and pivot

ROI Calculation

Calculate return on ad spend:

Sum total engagements across posts
Calculate cost per engagement (CPE)
Calculate cost per click (CPC) if clicks available
Estimate engagement value using benchmark rates
Calculate ROI percentage
Validation: ROI = (Value - Spend) / Spend × 100

ROI Formulas

Metric	Formula
Cost Per Engagement (CPE)	Total Spend / Total Engagements
Cost Per Click (CPC)	Total Spend / Total Clicks
Cost Per Thousand (CPM)	(Spend / Impressions) × 1000
Return on Ad Spend (ROAS)	Revenue / Ad Spend

Engagement Value Estimates

Action	Value	Rationale
Like	$0.50	Brand awareness
Comment	$2.00	Active engagement
Share	$5.00	Amplification
Save	$3.00	Intent signal
Click	$1.50	Traffic value

ROI Interpretation

ROI %	Rating	Recommendation
> 500%	Excellent	Scale budget significantly
200-500%	Good	Increase budget moderately
100-200%	Acceptable	Optimize before scaling
0-100%	Break-even	Review targeting and creative
< 0%	Negative	Pause and restructure

Platform Benchmarks

Engagement Rate by Platform

Platform	Average	Good	Excellent
Instagram	1.22%	3-6%	>6%
Facebook	0.07%	0.5-1%	>1%
Twitter/X	0.05%	0.1-0.5%	>0.5%
LinkedIn	2.0%	3-5%	>5%
TikTok	5.96%	8-15%	>15%

CTR by Platform

Platform	Average	Good	Excellent
Instagram	0.22%	0.5-1%	>1%
Facebook	0.90%	1.5-2.5%	>2.5%
LinkedIn	0.44%	1-2%	>2%
TikTok	0.30%	0.5-1%	>1%

CPC by Platform

Platform	Average	Good
Facebook	$0.97	<$0.50
Instagram	$1.20	<$0.70
LinkedIn	$5.26	<$3.00
TikTok	$1.00	<$0.50

See references/platform-benchmarks.md for complete benchmark data.

Tools

Calculate Metrics

python scripts/calculate_metrics.py assets/sample_input.json

Calculates engagement rate, CTR, reach rate for each post and campaign totals.

Analyze Performance

python scripts/analyze_performance.py assets/sample_input.json

Generates full performance analysis with ROI, benchmarks, and recommendations.

Output includes:

Campaign-level metrics
Post-by-post breakdown
Benchmark comparisons
Top performers ranked
Actionable recommendations

Examples

Sample Input

See assets/sample_input.json:

{
  "platform": "instagram",
  "total_spend": 500,
  "posts": [
    {
      "post_id": "post_001",
      "content_type": "image",
      "likes": 342,
      "comments": 28,
      "shares": 15,
      "saves": 45,
      "reach": 5200,
      "impressions": 8500,
      "clicks": 120
    }
  ]
}

Sample Output

See assets/expected_output.json:

{
  "campaign_metrics": {
    "total_engagements": 1521,
    "avg_engagement_rate": 8.36,
    "ctr": 1.55
  },
  "roi_metrics": {
    "total_spend": 500.0,
    "cost_per_engagement": 0.33,
    "roi_percentage": 660.5
  },
  "insights": {
    "overall_health": "excellent",
    "benchmark_comparison": {
      "engagement_status": "excellent",
      "engagement_benchmark": "1.22%",
      "engagement_actual": "8.36%"
    }
  }
}

Interpretation

The sample campaign shows:

Engagement rate 8.36% vs 1.22% benchmark = Excellent (6.8x above average)
CTR 1.55% vs 0.22% benchmark = Excellent (7x above average)
ROI 660% = Outstanding return on $500 spend
Recommendation: Scale budget, replicate successful elements

Reference Documentation

Platform Benchmarks

references/platform-benchmarks.md contains:

Engagement rate benchmarks by platform and industry
CTR benchmarks for organic and paid content
Cost benchmarks (CPC, CPM, CPE)
Content type performance by platform
Optimal posting times and frequency
ROI calculation formulas

Proactive Triggers

Engagement rate below platform average → Content isn't resonating. Analyze top performers for patterns.
Follower growth stalled → Content distribution or frequency issue. Audit posting patterns.
High impressions, low engagement → Reach without resonance. Content quality issue.
Competitor outperforming significantly → Content gap. Analyze their successful posts.

Output Artifacts

When you ask for...	You get...
"Social media audit"	Performance analysis across platforms with benchmarks
"What's performing?"	Top content analysis with patterns and recommendations
"Competitor social analysis"	Competitive social media comparison with gaps

Communication

All output passes quality verification:

Self-verify: source attribution, assumption audit, confidence scoring
Output format: Bottom Line → What (with confidence) → Why → How to Act
Results only. Every finding tagged: 🟢 verified, 🟡 medium, 🔴 assumed.

Related Skills

social-content: For creating social posts. Use this skill for analyzing performance.
campaign-analytics: For cross-channel analytics including social.
content-strategy: For planning social content themes.
marketing-context: Provides audience context for better analysis.

FAQ

What does the social-media-analyzer skill do?

How do I install social-media-analyzer?

Run npx skills add https://github.com/alirezarezvani/claude-skills --skill social-media-analyzer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/social-media-analyzer/ (personal) or .claude/skills/social-media-analyzer/ (project).

Which AI agents can use social-media-analyzer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is social-media-analyzer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains social-media-analyzer?

It is published by alirezarezvani in alirezarezvani/claude-skills. It has 1,563 recorded installs.

More from alirezarezvani/claude-skills

View all →

engineering-skills

alirezarezvani/claude-skills

Index of the engineering-team skills bundle for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw, and 6 more tools. Architecture, frontend, backend, QA, DevOps, security, AI/ML, data engineering, Playwright, Stripe, AWS, MS365 (stdlib-only Python tools). Use when browsing or choosing among engineering-team role skills — load only the one specialist SKILL.md you need, never bulk-load the bundle.

Backend & APIs2.4K installs

finance-skills

alirezarezvani/claude-skills

Router/index for the finance skills bundled in this plugin: financial-analyst (ratio analysis, DCF valuation, budget variance, rolling forecasts), saas-metrics-coach (ARR/MRR, churn, CAC/LTV, NRR, quick ratio) and month-end-close (close calendar, reconciliations, flux review). Use when a finance request doesn't obviously match one skill and you need to pick the right one (e.g., 'analyze these financials', 'how healthy are my SaaS metrics').

Business & Finance2.3K installs

marketing-skills

alirezarezvani/claude-skills

Directory and router for the marketing skills library. Use when you need to find the right marketing skill for a task, see what marketing capabilities exist, or get oriented in this plugin. 44 specialist skills across 8 pods (content, SEO + AEO, CRO, channels, growth, intelligence, sales enablement, ops), 59 stdlib Python tools. Routes to one skill — it does not execute marketing work itself.

Marketing & SEO2.3K installs

business-growth-skills

alirezarezvani/claude-skills

Router/index for the 4 business & growth skills bundled in this plugin: customer-success-manager (health scoring, churn risk, expansion), sales-engineer (RFP analysis, competitive matrices, PoC planning), revenue-operations (pipeline, forecast accuracy, GTM efficiency), and contract-and-proposal-writer. Use when a growth/revenue request doesn't obviously match one skill and you need to pick the right one (e.g., 'which accounts are at risk', 'should we bid on this RFP').

Business & Finance2.2K installs

engineering-advanced-skills

alirezarezvani/claude-skills

Index of 37 advanced engineering agent skills for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw. Use when browsing or choosing among the POWERFUL-tier engineering skills: agent design, RAG, MCP servers, CI/CD, database design, observability, security auditing, changelog/release automation, reliability (SLO/chaos/flags/operators), platform ops.

AI & Agents2K installs

product-skills

alirezarezvani/claude-skills

Use when coordinating product work across the 12 bundled product sub-skills (RICE, OKRs, UX research, design tokens, competitive teardown, analytics, experiments, discovery, roadmaps, spec-to-repo, landing pages, SaaS scaffolding) or the 4 standalone product-team plugins (user stories, Apple HIG, code-to-PRD, research summarizer). Triggers on 'help me prioritize', 'plan a product experiment', 'we ship features nobody uses', 'run the discovery loop', 'is our OST sound'. Forks context to route to one sub-skill via a deterministic signal router and returns a digest; can also drive a continuous-discovery loop (Torres cadence tracker + OST linter as machine gates) or a full goal→plan→execute→verify→close run through the repo-wide agent-harness. Distinct from project-management (how to deliver vs what to build), marketing/landing (from-scratch pages), and engineering/agent-harness (the generic loop engine this orchestrator plugs into).

Code Quality & Workflow2K installs

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Marketing & SEO453.7K installs

social-media-analyzer

Install

Install

Describe the task

Review the result

SKILL.md

Social Media Analyzer

Table of Contents

Analysis Workflow

Input Requirements

Data Validation Checks

Engagement Metrics

Engagement Rate Calculation

Metric Definitions

Performance Categories

ROI Calculation

ROI Formulas

Engagement Value Estimates

ROI Interpretation

Platform Benchmarks

Engagement Rate by Platform

CTR by Platform

CPC by Platform

Tools

Calculate Metrics

Analyze Performance

Examples

Sample Input

Sample Output

Interpretation

Reference Documentation

Platform Benchmarks

Proactive Triggers

Output Artifacts

Communication

Related Skills

FAQ

More from alirezarezvani/claude-skills

Popular marketing & seo skills