Skip to main content
skill CX Codex

social-media-analyzer · alirezarezvani/claude-code-skill-factory — Claude Code skill: setup and use

social-media-analyzer analyzes social campaign metrics, calculates ROI, and identifies top-performing content across platforms in Claude Code.

MIT ★ 907 updated 2025-11-12

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a claude-code
Open on GitHub

What social-media-analyzer does

This skill evaluates marketing performance across Facebook, Instagram, Twitter, LinkedIn, and TikTok. Under the hood, two Python scripts handle processing: calculate_metrics.py calculates core metrics, while analyze_performance.py generates performance assessments and recommendations. The skill accepts structured JSON files, CSV exports from platform dashboards, or plain text metric summaries.

It computes click-through rates, reach, impressions, cost per engagement, and return on ad spend. Output options include performance breakdowns, post comparisons, and chart reports in Excel or PDF formats.

The skill cannot pull data directly from platform accounts: you must export CSV files or provide metrics manually.

What it helps with

  • Calculate ROAS, cost per click, and cost per engagement for paid campaigns
  • Compare reach and engagement metrics across multiple social networks
  • Identify best-performing post formats, hashtags, and publishing times
  • Generate visual performance reports in Excel or PDF from exported CSVs

Example prompts for the agent

  • Analyze this Facebook campaign data from campaign.csv and calculate engagement metrics
  • What is the ROI on this Instagram ad campaign with $500 spend and 2,000 clicks?
  • Compare performance across all social platforms for the last month using metrics.json

How to install social-media-analyzer

1Skills CLI (Vercel)

npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a claude-code

2Manually: put the files in place

~/.claude/skills/social-media-analyzer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/social-media-analyzer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about social-media-analyzer

How to install social-media-analyzer in Claude Code?

Run npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a claude-code in your terminal. Alternatively, save the skill file to ~/.claude/skills/social-media-analyzer/SKILL.md.

What does social-media-analyzer do?

It processes campaign metrics across platforms like Facebook and TikTok to calculate engagement rates, ad spend efficiency, and content performance trends.

Can this skill fetch metrics directly via social media APIs?

No, it does not fetch live platform data on its own. You need to export metrics as JSON or CSV files first, or paste the numbers directly.

Source text

SKILL.md · MIT
---
name: social-media-analyzer
description: Analyzes social media campaign performance across platforms with engagement metrics, ROI calculations, and audience insights for data-driven marketing decisions
---

# Social Media Campaign Analyzer

This skill provides comprehensive analysis of social media campaign performance, helping marketing agencies deliver actionable insights to clients.

## Capabilities

- **Multi-Platform Analysis**: Track performance across Facebook, Instagram, Twitter, LinkedIn, TikTok
- **Engagement Metrics**: Calculate engagement rate, reach, impressions, click-through rate
- **ROI Analysis**: Measure cost per engagement, cost per click, return on ad spend
- **Audience Insights**: Analyze demographics, peak engagement times, content performance
- **Trend Detection**: Identify high-performing content types and posting patterns
- **Competitive Benchmarking**: Compare performance against industry standards

## Input Requirements

Campaign data including:
- **Platform metrics**: Likes, comments, shares, saves, clicks
- **Reach data**: Impressions, unique reach, follower growth
- **Cost data**: Ad spend, campaign budget (for ROI calculations)
- **Content details**: Post type (image, video, carousel), posting time, hashtags
- **Time period**: Date range for analysis

Formats accepted:
- JSON with structured campaign data
- CSV exports from social media platforms
- Text descriptions of key metrics

## Output Formats

Results include:
- **Performance dashboard**: Key metrics with trends
- **Engagement analysis**: Best and worst performing posts
- **ROI breakdown**: Cost efficiency metrics
- **Audience insights**: Demographics and behavior patterns
- **Recommendations**: Data-driven suggestions for optimization
- **Visual reports**: Charts and graphs (Excel/PDF format)

## How to Use

"Analyze this Facebook campaign data and calculate engagement metrics"
"What's the ROI on this Instagram ad campaign with $500 spend and 2,000 clicks?"
"Compare performance across all social platforms for the last month"

## Scripts

- `calculate_metrics.py`: Core calculation engine for all social media metrics
- `analyze_performance.py`: Performance analysis and recommendation generation

## Best Practices

1. Ensure data completeness before analysis (missing metrics affect accuracy)
2. Compare metrics within same time periods for fair comparisons
3. Consider platform-specific benchmarks (Instagram engagement differs from LinkedIn)
4. Account for organic vs. paid metrics separately
5. Track metrics over time to identify trends
6. Include context (seasonality, campaigns, events) when interpreting results

## Limitations

- Requires accurate data from social media platforms
- Industry benchmarks are general guidelines and vary by niche
- Historical data doesn't guarantee future performance
- Organic reach calculations may vary by platform algorithm changes
- Cannot access data directly from platforms (requires manual export or API integration)
- Some platforms limit data availability (e.g., TikTok analytics for business accounts only)

© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory

Similar skills

All skills for Marketing and content →

social-media-analyzer by other authors comes first.

social-media-analyzer Alireza Rezvani social-media-analyzer is a Claude Code skill that measures social campaign engagement and ROI. It compares post and campaign results with platform benchmarks. CX Codex +1 1,558installs social-media-management manojbajaj95 social-media-management — a skill for planning and repurposing posts across LinkedIn, X, Instagram, TikTok and more. Useful when the content calendar lives only in your head. CX Codex +1 504installs social-media-manager borghei social-media-manager — a skill to build sustainable social presence: platform selection, content pillars, editorial calendars, and community workflows. For marketers and product leaders scaling SaaS social channels. CX Codex +1 118installs performance-analyzer-sms blacktwist performance-analyzer-sms turns raw social post metrics into a ranked read on what worked, what flopped and why. Pulls from BlackTwist or from data you hand it. CX Codex +1 1,900installs social-media genspark-ai social-media generates a four-week Excel content calendar and drafts platform-adapted copy for week one based on account positioning. CX Codex +1 ★ 12,746repo stars socialclaw-social-media-scheduling-posting-and-analytics-for-ai- ndesv21 The socialclaw-social-media-scheduling-posting-and-analytics-for-ai- plugin for Claude Code schedules posts, uploads media, and retrieves social media metrics. It manages multi-platform campaigns directly. ★ 112repo stars social-media-strategist Maigent social-media-strategist is a Claude Code command that builds a social media plan around a business and its audience. It covers platform choices, content, engagement, and measurement. CX Codex +1 ★ 1,013repo stars

From the same set36

The whole set →

Project sponsors

Companies that keep this analytics open