Agent skill

Social Media Analyzer

by alirezarezvani in alirezarezvani/claude-code-skill-factory

Analyzes social media campaign performance across platforms with engagement metrics, ROI calculations, and audience insights for data-driven marketing decisions

MITAuto-check passedProduct & Project Management

Install Social Media Analyzer

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-code-skill-factory social-media-analyzer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/generated-skills/social-media-analyzer .claude/skills/social-media-analyzer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
social-media-analyzer
GitHub stars
882
Used in
2 other repos
Token cost
~772 tokens
SKILL.md length
346 words
Files
6
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Analyzes social media campaign performance across platforms with engagement metrics, ROI calculations, and audience insights for data-driven marketing decisions

  • Works in 6 steps: Ensure data completeness before analysis… → Compare metrics within same time periods… → Consider platform-specific benchmarks… → …
  • Tasks that involve Product metrics
  • SKILL.md covers Capabilities, Input Requirements, Output Formats and How to Use, plus 3 more sections
  • Runs Python scripts from its folder

What it does

Social Media Analyzer is an agent skill from alirezarezvani/claude-code-skill-factory. Analyzes social media campaign performance across platforms with engagement metrics, ROI calculations, and audience insights for data-driven marketing decisions

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `HOW_TO_USE.md`, `analyze_performance.py` and `calculate_metrics.py`).

It sits in Product & Project Management, covering Product metrics. The repository describes itself as: Claude Code Skill Factory — A powerful open-source toolkit for building and deploying production-ready Claude Skills, Code Agents, custom Slash Commands, and LLM Prompts at… The licence is MIT.

When your agent uses it

  • Tasks that involve Product metrics

Example prompts

  • “Use the social-media-analyzer skill to analyz social media campaign performance across platforms with engagement metrics, ROI calculations, and…”
  • “/social-media-analyzer”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit ba18b31. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Social Media Analyzer loads about 772 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 346 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~772

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/claude-code-skill-factory at commit ba18b31, republished under its MIT licence (© alirezarezvani). 346 words, ~772 tokens.

Download SKILL.mdSave it as .claude/skills/social-media-analyzer/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files in generated-skills/social-media-analyzer of alirezarezvani/claude-code-skill-factory.

  • SKILL.md
  • HOW_TO_USE.md
  • analyze_performance.py
  • calculate_metrics.py
  • expected_output.json
  • sample_input.json

Open the folder on GitHubat commit ba18b31

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in alirezarezvani/claude-code-skill-factory, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Social Media Analyzer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Social Media Analyzer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Media Analyzer this skillalirezarezvani/claude-code-skill-factory8822 repos~772Automated safety check: PassMIT
Swarmaglitch-rabin/swarma173—~4.4kAutomated safety check: NotesMIT
Prdjuanandresgs/claude-ctrl193—~2.9kAutomated safety check: PassNone
AI Product Strategy InterviewerPrepLabsAI/InterviewMentor112—~4.5kAutomated safety check: PassMIT
Investigate MetricPostHog/posthog40k—~1.9kAutomated safety check: PassCustom licence
Weekly Creative Reportreal-simple-labs/parker-brain102—~4.7kAutomated safety check: PassCustom licence

Similar skills

  • Swarma

    glitch-rabin/swarma

    Agent teams that run growth experiments and build their own playbook.

    173 GitHub stars~4.4k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check: notes
  • Prd

    juanandresgs/claude-ctrl

    Write structured feature specifications with problem statements, user journeys, use cases, functional requirements, and success metrics.

    193 GitHub stars~2.9k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • AI Product Strategy Interviewer

    PrepLabsAI/InterviewMentor

    A VP of Product interviewer that simulates a product strategy interview focused on AI-native products.

    112 GitHub stars~4.5k tokensUpdated 4 days ago
    Product & Project ManagementAuto-check passed
  • Investigate Metric

    PostHog/posthog

    Official

    Diagnose why a product metric changed (dropped, spiked, or plateaued) by orchestrating breakdowns, actors, paths, lifecycle, retention, and annotations queries.

    40k GitHub stars~1.9k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Weekly Creative Report

    real-simple-labs/parker-brain

    Build the brand's weekly creative report, a polished, shareable page an agency can send straight to the brand's CMO and team.

    102 GitHub stars~4.7k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • North Star

    andreaskelm/pm-brain

    Define, sharpen, or audit a North Star metric and its input metrics tree, and decide which product metrics actually matter (leading vs.

    234 GitHub stars~2.5k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from alirezarezvani/claude-code-skill-factory

All 12 skills in this repo
  • App Store Optimization

    alirezarezvani/claude-code-skill-factory

    Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store

    882 GitHub starsUsed in 8 repos~4.1k tokens
    Auto-check passed
  • Claude Md Enhancer

    alirezarezvani/claude-code-skill-factory

    Analyzes, generates, and enhances CLAUDE.md files for any project type using best practices, modular architecture support, and tech stack customization.

    882 GitHub stars~4.1k tokensUpdated 11 mo ago
    Auto-check passed
  • Content Trend Researcher

    alirezarezvani/claude-code-skill-factory

    Advanced content and topic research skill that analyzes trends across Google Analytics, Google Trends, Substack, Medium, Reddit, LinkedIn, X, blogs, podcasts, and YouTube to generate data-driven…

    882 GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • TDD Guide

    alirezarezvani/claude-code-skill-factory

    Comprehensive Test Driven Development guide for engineering subagents with multi-framework support, coverage analysis, and intelligent test generation

    882 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Agent Factory

    alirezarezvani/claude-code-skill-factory

    Claude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns

    882 GitHub stars~2k tokensUpdated 11 mo ago
    Auto-check passed
  • Codex CLI Bridge

    alirezarezvani/claude-code-skill-factory

    Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools

    882 GitHub stars~2.2k tokensUpdated 11 mo ago
    Auto-check passed

Questions about Social Media Analyzer

What does Social Media Analyzer do?

Analyzes social media campaign performance across platforms with engagement metrics, ROI calculations, and audience insights for data-driven marketing decisions. Social Media Analyzer is an agent skill from alirezarezvani/claude-code-skill-factory.

When should I use Social Media Analyzer?

Social Media Analyzer fits situations like: tasks that involve Product metrics.

How do I install Social Media Analyzer in Claude Code?

Run `npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a claude-code`. Or copy the skill folder (generated-skills/social-media-analyzer in alirezarezvani/claude-code-skill-factory) into .claude/skills/social-media-analyzer in your project. Claude Code loads it when a task matches its description.

How do I install Social Media Analyzer in Codex?

Run `npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a codex`. Or copy the skill folder (generated-skills/social-media-analyzer in alirezarezvani/claude-code-skill-factory) into .agents/skills/social-media-analyzer in your project. Codex loads it when a task matches its description.

Can I use Social Media Analyzer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-code-skill-factory --skill social-media-analyzer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/social-media-analyzer, .gemini/skills/social-media-analyzer, .github/skills/social-media-analyzer and .opencode/skills/social-media-analyzer in your project.

What does Social Media Analyzer need to run?

Going by SKILL.md and its folder, Social Media Analyzer needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Social Media Analyzer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Social Media Analyzer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Social Media Analyzer use?

Social Media Analyzer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Social Media Analyzer use?

About 772 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Social Media Analyzer?

Skills that share tags, products or a category with Social Media Analyzer: Swarma (glitch-rabin/swarma, 173 stars), Prd (juanandresgs/claude-ctrl, 193 stars), AI Product Strategy Interviewer (PrepLabsAI/InterviewMentor, 112 stars) and Investigate Metric (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Media Analyzer?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-code-skill-factory, which has 882 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on November 12, 2025.

Source: alirezarezvani/claude-code-skill-factory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.