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
npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/social-media-analyzer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/social-media-analyzer/
1Skills CLI (Vercel)
npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a codex2Manually: put the files in place
.agents/skills/social-media-analyzer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a cursor2Manually: put the files in place
.cursor/skills/social-media-analyzer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alirezarezvani/claude-code-skill-factory generated-skills/social-media-analyzer/SKILL.md2Manually: put the files in place
.github/skills/social-media-analyzer/SKILL.md1Skills CLI (Vercel)
npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a gemini-cli2Platform CLI
gemini skills install https://github.com/alirezarezvani/claude-code-skill-factory --path generated-skills/social-media-analyzerManually: put the files in place
.devin/skills/social-media-analyzer/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.