analytics-review

name: analytics-review
description: >
  Run a weekly retro on real numbers: pull the period's posts and their actual metrics
  from connected channels, say honestly what worked and what didn't, and turn it into
  three concrete content moves for next week. Covers LinkedIn, X (Twitter), Instagram,
  and Facebook — each platform reports different metrics, and gaps are shown as gaps.
  Use when the user says "review my week", "what worked this week", "analytics retro",
  or asks "how did my posts do". Requires the Inklate MCP connection. Reads
  social-context.md when present so recommendations tie back to the user's pillars and
  goals rather than generic growth advice.
metadata:
  version: 1.0.0
  topics: [analytics, planning]
  examplePrompt: "Review last week's posts and tell me what to double down on"
  pairsWith: [social-audit, content-calendar]
  mcpTools: [get_post_metrics, get_channel_metrics, list_posts]

Review the period's real performance and leave the user with an honest read and three specific moves for next week.

Connection check

1. Call list_organizations first.
2. If it fails or the Inklate tools are absent, tell the user to connect at https://inklate.com/skills/connect?ref=skills-analytics-review and STOP — a retro on invented numbers is worse than no retro.
3. If multiple organizations exist, ask which one to review.

Context

Read social-context.md (project root, then .agents/social-context.md) if present. ## Pillars lets you group performance by theme, and ## Goals decides which metric matters most — reach for awareness, replies and profile visits for leads. Proceed without it if absent, but note that recommendations will be metric-generic rather than goal-anchored.

Workflow

1. Establish the period: default to the last 7 full days; honor whatever range the user names. State the exact dates you are reviewing.
2. Call list_posts for the period. If nothing was published, say so and offer to review the prior period instead — do not pad the retro with older posts unlabeled.
3. For each published post, call get_post_metrics. Collect what each platform actually returns: impressions, engagement, clicks, and platform-specific extras.
4. Call get_channel_metrics for each channel over the period for account-level context — follower movement and channel-level reach — so post performance is read against its baseline.
5. Honesty rule for gaps: platforms report different metric sets, and some metrics arrive late or not at all. A missing metric is a dash, never a zero — a zero is a claim, a dash is an absence. Say once which metrics a platform doesn't provide.
6. Build the metrics table (see Receipt) and read it before interpreting:
   • Best and worst post by the goal metric, per channel.
   • Per-pillar patterns when social-context.md names pillars — which theme carried the week.
   • Format patterns: did threads, single posts, or media posts outperform on each platform?
   • Timing: anything notable about which days or slots performed, stated cautiously at weekly sample sizes.
7. What worked / what didn't. Two short lists, each item citing its number ("the contrarian take drew 4x your median impressions"). Attribute honestly: if the sample is 3 posts, say the pattern is weak. Never invent causality the data can't support.
8. Three moves for next week. Exactly three, each concrete enough to act on without discussion — a topic, a format, and a cadence or channel adjustment, each tied to a pillar (when known) and to the evidence from step 7. "Post more consistently" fails; "the two build-in-public posts beat everything else — make Tuesday a fixed build-in-public slot on LinkedIn" passes.
9. If the user asks about follower growth beyond the channel summary, note that get_channel_metrics is the source and report the period delta per channel alongside the post table.
10. Offer the bridge: hand the three moves to the content-calendar skill to plan next week, or to schedule-week if drafts already exist.

Quality bar

• Every number in the retro comes from get_post_metrics or get_channel_metrics this session — no remembered, estimated, or extrapolated figures.
• Missing metrics render as "—" with a footnote, never as 0; late-arriving metrics (recent posts) are marked "too early".
• Claims are proportional to sample size; with under five posts, findings are labeled directional.
• Exactly three moves — not two, not five — each specific enough that a stranger could execute it.
• When social-context.md exists, each move names the pillar it serves; when it doesn't, say the retro would sharpen with one and suggest the social-context skill.
• This skill reads and recommends; it publishes and schedules nothing.
• Comparisons across platforms are framed carefully: an impression on X and an impression on LinkedIn are not the same unit, so cross-platform tables never sum them into one total.

Receipt

End with the period's metrics table and the three moves:

Post	Channel	Published	Impressions	Engagement	Clicks	Notes
"Why we killed our roadmap"	LinkedIn	Jul 13	8,420	312	47	best of week
Thread: roadmap lessons	X	Jul 13	21,050	460	—	X doesn't report clicks here
Carousel: 5 lessons	Instagram	Jul 15	1,180	96	—	too early for full metrics

Below the table: channel-level context (follower delta and reach per channel for the period), the what-worked and what-didn't lists with their numbers, and then the three moves for next week, numbered, each with its pillar and its evidence.

Close with the offer to turn the moves into next week's plan via content-calendar, or into booked placements via schedule-week if drafts exist.