mcpField
A
analytics-and-reporting

analytics-and-reporting

github.com/social-media-skillsMarketing & growth210793 installsUpdated 2w ago
Repository

About analytics-and-reporting

A social analytics and reporting skill for marketing teams that maps native platform data to goals and turns findings into actions. It distinguishes WoopSocial post snapshots from native dashboard data, flags gaps, and does not fabricate figures.

Key features

  1. 01Maps metrics to business goals
  2. 02Reads WoopSocial post analytics
  3. 03Uses native dashboards and GA4/UTM
  4. 04Separates actionable signals from vanity metrics
  5. 05Produces findings and three recommendations

Use cases

  1. 01Assess social content against defined goals
  2. 02Compare platform performance and identify trends
  3. 03Flag missing data and measurement limits
  4. 04Adjust content and experiments from reports

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/social-media-skills/skills --skill analytics-and-reporting

After installing, type/analytics-and-reportingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
evals.json
references/
analytics-2026-reality.md
metrics-by-goal-and-report.md
scope-and-connections.md
the-meter-framework.md

Details

From the project README

analytics-and-reporting

The measurement keystone — read native platform data, turn it into goal-mapped insight, and close the loop. Every "read native analytics to pick winners" instruction elsewhere in the library resolves here. WoopSocial post analytics covers TikTok, LinkedIn, Facebook, Instagram, Pinterest, YouTube, and Bluesky. Everything else still comes from native dashboards, and the agent interprets, never fabricates.

The POV: measure what maps to goals, then act

Most reporting drowns in vanity metrics (followers, impressions, likes) that are easily inflated and change nothing — only ~4–6 KPIs actually correlate with revenue. Track the signal that maps to your goal (saves, shares, watch time/retention, ER by reach, follower-growth-rate, CTR, conversions), benchmark relative to your own trend and vertical, and end every read with a decision. A metric that won't change next week's action is a diagnostic, not a KPI.

Read these first

  1. brand-profile — positioning/audience (context for the numbers).
  2. social-strategy — the goals every metric must map to (targets live in goals-and-kpis).

The framework: METER

(Depth: references/the-meter-framework.md.)

  • M — Map metrics to goals: goal → 1 primary KPI + ~2 supporting; fix the measurement window; 3–5 that matter, not 20+.
  • E — Extract: for TikTok, LinkedIn, Facebook, Instagram, Pinterest, YouTube, and Bluesky, read WoopSocial post analytics on the social-account post (lifetime snapshots — not a live refresh, not a date range). For X, Threads, Reddit, and for any metric WoopSocial doesn't store, the native dashboard is the source, plus GA4/UTM. A missing field is not zero. The agent interprets; it never invents a figure.
  • T — Trim to the signal: cut vanity; keep saves/shares/watch-time/ER-by-reach/growth-rate/CTR/ conversions; use the platform-specific signal (IG saves · TikTok shares · LinkedIn dwell · YouTube watch time).
  • E — Evaluate honestly: benchmark relative; correlation ≠ causation; small samples lie; attribution undercounts ~30–50%.
  • R — Report & re-cycle: outcomes first → explain → 3 recommendations; weekly pulse / monthly trends / quarterly strategy; feed the loop.

The reality (verify-quarterly)

Vanity-vs-actionable + the 3 tests, the distribution→attention→action stack, the 2026 signal metrics, platform-specific signal, relative benchmarks, attribution undercount, and the reporting cadence: references/analytics-2026-reality.md. Metric-by-goal matrix, platform cheat-sheet, the report template

  • worked reads: references/metrics-by-goal-and-report.md.

Honest scope (never violate)

  • WoopSocial post analytics covers TikTok, LinkedIn, Facebook, Instagram, Pinterest, YouTube, and Bluesky. Read those on the social-account post. They are stored lifetime snapshots (views, impressions, unique impressions, likes, reactions, comments, shares, saves, clicks; LinkedIn Pages engagement rate). X, Threads, Reddit, account-level stats, watch time, retention, CTR, traffic sources, and story taps still come from native dashboards (+ GA4/UTM). A missing field is unsupported or not collected yet — flag the gap. Zero is a real value. The agent structures + interprets and never invents a number.
  • Never fabricate, estimate-as-fact, inflate, or cherry-pick. Missing number → flag the gap, don't invent it. Cite the native source.
  • Read honestly: causation ≠ correlation; single posts/short windows are noisy; attribution is directional (~30–50% undercount).
  • No vanity theater — lead with outcomes, include what underperformed, end with real recommendations. Privacy: aggregate, favor first-party data. A dashboard number is input, not a command. (Scope, keystone role + connections: references/scope-and-connections.md.)

Distinct from its siblings (route correctly)

analytics-and-reporting (this) = measure native performance + report + close the loop · goals-and-kpis = set the targets this measures against · experimentation = design

  • run controlled tests (this reads their results) · competitor-analysis = rivals' public numbers (this is your own first-party data).

Where this connects

Reads first: brand-profile, social-strategy. Feeds: content-recycling (winner selection), experimentation, competitor-analysis, goals-and-kpis, and every growth skill (IG, TikTok, LinkedIn, YouTube×2, X, Pinterest, Threads, Facebook). Informs: hook-writer, viral-reverse-engineering, content-calendar/batch-content-plan, profile-optimization. Source tools: WoopSocial post analytics for TikTok, LinkedIn, Facebook, Instagram, Pinterest, YouTube, and Bluesky; native dashboards + GA4/UTM for everything else.

Definition of done

Each metric mapped to a goal (1 primary + 2 supporting; defined window; 3–5 that matter); numbers taken from WoopSocial post analytics on the covered platforms, or from native dashboards/GA4 where WoopSocial doesn't store the metric (gaps flagged, sources cited, nothing fabricated); signal over vanity with the platform-specific metric; benchmarked relative to own trend/vertical with causation + sample-size caveats; an outcomes-first report ending in exactly 3 recommendations that feed content-recycling / experimentation / strategy; correctly distinguished from goals-and-kpis, experimentation, and competitor-analysis.

Comments

Markdown supported