Social Media Analyzer
Turn raw social post and spend data into engagement, ROI, benchmark comparisons, and scaling recommendations for a solo builder’s campaigns.
Overview
Social Media Analyzer is an agent skill most often used in Grow (also Launch) that turns campaign posts and spend into engagement, ROI, and benchmark-driven recommendations.
Install
npx skills add https://github.com/alirezarezvani/claude-skills --skill social-media-analyzerWhat is this skill?
- Computes campaign totals: engagements, reach, impressions, clicks, and average engagement rate
- ROI block: spend, cost per engagement/click, estimated value, and ROI percentage
- Ranks top posts by engagement with content-type breakdown (image, video, carousel)
- Benchmark comparison against industry engagement and CTR with health labels
- Recommendation bullets for budget scaling and replicating winning creative
Adoption & trust: 1.2k installs on skills.sh; 17.5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You ran a short social burst but cannot quickly tell if engagement and ROI beat norms or which post formats deserve more budget.
Who is it for?
Solo builders reviewing Instagram-style campaigns with post-level stats and ad spend who want a fast performance narrative.
Skip if: Teams that need live API ingestion, multi-platform OAuth, or brand-new channel strategy before any data exists.
When should I use this skill?
You have post-level metrics and optional spend and need engagement, ROI, benchmarks, and scaling recommendations.
What do I get? / Deliverables
You get a structured campaign and ROI report with top posts, benchmark status, and scaling recommendations you can act on in the next content cycle.
- Structured JSON campaign_metrics, roi_metrics, top_posts, and insights with recommendations
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Grow because the skill’s output is post-campaign measurement and optimization, not channel setup. Analytics subphase fits aggregated metrics, CTR/engagement benchmarks, and actionable insights on what to scale next.
Where it fits
Roll up three posts into engagement, CTR, and ROI after a weekly promo ends.
Decide whether to extend paid social based on cost per click versus estimated value.
Compare micro-campaign results before committing to a full launch calendar.
How it compares
Use for structured campaign post-mortems instead of guessing performance from raw platform dashboards alone.
Common Questions / FAQ
Who is social-media-analyzer for?
Indie founders and one-person marketing leads who export or paste campaign metrics and want ROI and benchmark interpretation without hiring an analyst.
When should I use social-media-analyzer?
In Grow analytics after a campaign ends; at Launch when judging whether distribution spend worked; in Validate when testing messaging on a small paid test.
Is social-media-analyzer safe to install?
Review the Security Audits panel on this skill’s catalog page before installing; the skill logic is analysis-only but your agent may still handle sensitive spend or audience data you provide.
SKILL.md
READMESKILL.md - Social Media Analyzer
{ "campaign_metrics": { "platform": "instagram", "total_posts": 3, "total_engagements": 1521, "total_reach": 18200, "total_impressions": 27700, "total_clicks": 430, "avg_engagement_rate": 8.36, "ctr": 1.55 }, "roi_metrics": { "total_spend": 500.0, "cost_per_engagement": 0.33, "cost_per_click": 1.16, "estimated_value": 3802.5, "roi_percentage": 660.5 }, "top_posts": [ { "post_id": "post_002", "content_type": "video", "engagement_rate": 8.18, "likes": 587, "reach": 8900 }, { "post_id": "post_001", "content_type": "image", "engagement_rate": 8.27, "likes": 342, "reach": 5200 }, { "post_id": "post_003", "content_type": "carousel", "engagement_rate": 8.85, "likes": 298, "reach": 4100 } ], "insights": { "overall_health": "excellent", "benchmark_comparison": { "engagement_status": "excellent", "engagement_benchmark": "1.22%", "engagement_actual": "8.36%", "ctr_status": "excellent", "ctr_benchmark": "0.22%", "ctr_actual": "1.55%" }, "recommendations": [ "Excellent ROI (660.5%)! Consider: (1) Scaling this campaign with increased budget, (2) Replicating successful elements to other campaigns, (3) Testing similar audiences" ], "key_strengths": [ "Strong audience engagement", "Excellent return on investment", "High click-through rate" ] } } { "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, "posted_at": "2025-10-15T14:30:00Z" }, { "post_id": "post_002", "content_type": "video", "likes": 587, "comments": 42, "shares": 31, "saves": 68, "reach": 8900, "impressions": 12400, "clicks": 215, "posted_at": "2025-10-16T18:45:00Z" }, { "post_id": "post_003", "content_type": "carousel", "likes": 298, "comments": 19, "shares": 12, "saves": 34, "reach": 4100, "impressions": 6800, "clicks": 95, "posted_at": "2025-10-18T12:15:00Z" } ] } # How to Use This Skill Hey Claude—I just added the "social-media-analyzer" skill. Can you analyze this campaign's performance and give me actionable insights? ## Example Invocations **Example 1:** Hey Claude—I just added the "social-media-analyzer" skill. Can you analyze this Instagram campaign data and tell me which posts performed best? **Example 2:** Hey Claude—I just added the "social-media-analyzer" skill. Can you calculate the ROI on this Facebook ad campaign with $1,200 spend? **Example 3:** Hey Claude—I just added the "social-media-analyzer" skill. Can you compare our engagement rates across Instagram, Facebook, and LinkedIn? ## What to Provide - Social media campaign data (likes, comments, shares, reach, impressions) - Platform name (Instagram, Facebook, Twitter, LinkedIn, TikTok) - Ad spend amount (for ROI calculations) - Time period of the campaign - Post details (type, content, posting time - optional but helpful) ## What You'll Get - **Campaign Performance Metrics**: Engagement rate, CTR, reach, impressions - **ROI Analysis**: Cost per engagement, cost per click, return on investment - **Benchmark Comparison**: How your campaign compares to industry standards - **Top Performing Posts**: Which content resonated most with your audience - **Actionable Recommendations**: Specific steps to improve future campaigns - **Visual Report**: Charts and graphs (Excel/PDF format) ## Tips for Best Results 1. **Include complete data**: More metrics = more accurate insights 2. **Specify platform**: Different platforms have different benchmark standards 3. **Provide context**: