Skip to content
Skills Library
Marketing & content · Analysis

review-performance

/review-performance

Review how your social media content is performing through the Marky API, find what is working, and turn it into a concrete plan. Use this when you want to know your top posts, follower growth, and which topics, formats, and platforms get the best engagement, then get specific recommendations (and optionally act on them). Pulls per-post stats, account stats, and your post history. Reads auth and endpoints from the marky-api skill. Also triggers on "how are my posts doing", "what's working", "top posts last month". For a quick queue/account status, use /marky-status.

Licence
Apache-2.0
Last repository change
22.07.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 22.07.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Review how your social media content is performing through the Marky API, find what is working, and turn it into a concrete plan. Use this when you want to know your top posts, follower growth, and which topics, formats, and platforms get the best engagement, then get specific recommendations (and optionally act on them). Pulls per-post stats, account stats, and your post history. Reads auth and endpoints from the marky-api skill. Also triggers on "how are my posts doing", "what's working", "top posts last month". For a quick queue/account status, use /marky-status.

Triggers from the description

how are my posts doingwhattop posts last month
Original author description

Review how your social media content is performing through the Marky API, find what is working, and turn it into a concrete plan. Use this when you want to know your top posts, follower growth, and which topics, formats, and platforms get the best engagement, then get specific recommendations (and optionally act on them). Pulls per-post stats, account stats, and your post history. Reads auth and endpoints from the marky-api skill. Also triggers on "how are my posts doing", "what's working", "top posts last month". For a quick queue/account status, use /marky-status.

How it works

  1. Cut by metadata tags
  2. Step 1 — find your business and connected accounts
  3. Step 2 — pull the numbers
  4. Step 3 — find the patterns
  5. Step 4 — recommend and (optionally) act
  6. Notes and limits
Original SKILL.md headings · 110 lines, 880 words
SKILL.md preview
---
name: review-performance
description: >
  Review how your social media content is performing through the Marky API, find what is
  working, and turn it into a concrete plan. Use this when you want to know your top posts,
  follower growth, and which topics, formats, and platforms get the best engagement, then
  get specific recommendations (and optionally act on them). Pulls per-post stats, account
  stats, and your post history. Reads auth and endpoints from the marky-api skill. Also triggers on "how are my posts doing", "what's working", "top posts last month". For a quick queue/account status, use /marky-status.
---

# Review Performance

Find out what is actually working on your socials and what to do more of. This skill reads
your real engagement numbers through the Marky API, looks for patterns, and gives you
specific, data-backed recommendations.

**Read the `marky-api` skill first** for the base URL, your `mk_live_` key, and the full
endpoint list. Everything below uses `https://api.mymarky.ai/api` and the header
`Authorization: Bearer mk_live_YOUR_KEY`.

**Marky wants your feedback.** If anything breaks or is confusing while you run this skill — and again once you finish — send Marky a quick note with the `submit_feedback` MCP tool. See the **"Marky wants your feedback"** section in the `marky-api` skill for when and how.

Everything here uses only read endpoints, so it is safe to run anytime.


## Cut by metadata tags

Posts created by agents carry `metadata` (media_type / format / hook / topic — see
"Tag every post" in the marky-api skill). When enough tagged posts have stats, group
engagement by each key and report which values win — "diagrams out-engage photos 2:1",
"question hooks beat bold claims". This is the highest-signal section of the review;
lead with it when tags exist, and note when the sample is too small to trust (<5 posts
per bucket is directional only).

## Step 1 — find your business and connected accounts

Two MCP tools: `list_businesses` (copy the id you want as `business_id`), then
`list_connected_social_accounts` on that business (copy each integration `id`, and note
its `platform` and `status`).

If no accounts are connected, stop and tell the user to connect a social account in the
[dashboard](https://app.mymarky.ai) first. Stats only exist for connected platforms.

## Step 2 — pull the numbers

Pull three things: account-level stats, the posts published on each platform (with their
engagement), and per-post detail when you want to go deeper.

- `get_integration_stats(business_id, integration_id)` — account-level audience stats
  (followers, growth) for one connected account.
- `list_integration_posts(business_id, integration_id)` — posts published on that
  platform, each with its engagement numbers. This includes posts published OUTSIDE
  Marky, so it is the true account picture; `get_external_post_stats` drills into one
  of those external posts.
- `get_post_analytics(business_id, post_id)` — engagement for one specific Marky post
  (across the platforms it went to).

Repeat the account/posts calls for each connected integration so you can compare platforms.

To tie performance back to what you posted about, also list your posts and topics:

`list_posts(business_id)` for your post history (filter by status if you like), and
`list_topics(business_id)` so you can group results by topic.

If the business has a Google Business profile connected, you can also pull customer
reviews to round out the picture (reviewer, star rating, text, and any reply):

`list_google_reviews(business_id, order_by="rating desc")` — newest first by default;
`order_by` also takes `rating`.

## Step 3 — find the patterns

Compare across a few dimensions and write down what stands out:

- **Top posts.** Which 3-5 posts got the most engagement? What do they have in common?
- **By topic.** Group posts by their `topic_id` and compare average engagement. Which
  topics pull their weight and which are dead weight?
- **By format.** Compare image posts vs video vs text. One format usually wins.
- **By platform.** Average engagement per platform. Some platforms reward different content.
- **Follower growth.** Is the audience growing, flat, or shrinking on each platform?

## Step 4 — recommend and (optionally) act

Present a four-tier action plan. Lead with the result, not the metric, and cite the
specific posts behind every recommendation — a rec with no post behind it is a guess:

- **Quick wins** — do this week, low effort ("Your how-to posts get ~3x the engagement
  of your promo posts — post two more how-tos").
- **Strategic shifts** — change the mix ("Video outperforms image on TikTok but image
  wins on LinkedIn. Match format to platform").
- **Experiments** — worth testing, not yet proven ("Topic 'client wins' is your best
  performer on 2 posts — small sample; run 3 more before concluding").
- **Stop doing** — the negative space most reviews skip ("Hashtag-wall captions are your
  bottom quartile on LinkedIn — drop them").

Benchmark against the business's OWN averages, not platform folklore — "good" is
whatever beats their last 90 days. Flag every thin sample (<5 posts per bucket is
directional only).

Then offer to act on it with the writing skills:

- **Save the learnings.** Offer to append the data-backed findings to the business's
  `performance-learnings.md` (see "Performance learnings" in the `marky-api` skill for
  the file's home and format). Creation skills read it before drafting, so a saved
  learning steers every future batch. Show the exact lines first; write only on a yes.
- Add or sharpen topics with the `suggest-topics` skill.
- Produce the next batch with the `schedule-posts` or `plan-social-content` skill, leaning
  into the winning topics and formats.

## Notes and limits

- The API gives you per-post and per-account engagement plus your post and topic lists.
  Group and compare those yourself, the API does not return pre-aggregated leaderboards.
- Posts are linked to a `topic_id`, so you can group by topic. Categories now have their
  own endpoints too (`GET /businesses/{id}/categories`), so you can roll topics up by
  category if you want a higher-level cut.
- Stats are read-only here. Acting on the findings (new topics, new posts) happens through
  the other skills.

Versions

RepositoryScoreLicence
This page · marky-team/marky-skills90Apache-2.0
paultyng/skill-issue100MIT
cbeeswax/code-review-skill100MIT

Database snapshot: 13.11.2026 · package version 3eeb01dd8b93 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100schedule-posts
    Create, upload media to, and schedule social media posts through the Marky API. Use this when you have post content ready (your own captions and images/videos, or a topic for Marky to write) and you want to get it onto your connected social accounts on a schedule. Covers…
  • 100marky-api
    Reference for driving Marky (social media management) from an AI agent. Use this when you need to authenticate to the Marky API, find the base URL, look up the key endpoints (businesses, integrations, media, posts, generate, schedule, stats), or connect Marky's MCP server to…
  • 90analyze-performance
    Analyze how a profile's social posts performed with Reelspan analytics and turn it into a short report - what to post more of, when to post, and what to drop. Use when the user asks how their posts or accounts are doing, which posts worked best, follower growth, the best time to…
  • 90performance-report
    Summarize how the user's social media is performing from PostFast analytics, with reach, engagement and follower growth per network, the best and weakest posts, and what to post more of. Use when someone asks how their posts did last week or last month, which posts worked best,…
  • 100performance-analyzer-sms
    When the user wants to analyze how their social media posts are performing. Also use when the user mentions 'analytics,' 'performance,' 'how did my posts do,' 'engagement,' 'impressions,' 'what's working,' 'post metrics,' 'my best posts,' or 'why isn't this post performing.'…
  • 100social-media-manager
    When the user wants to develop social media strategy, plan content calendars, manage community engagement, or grow their social presence across platforms. Also use when the user mentions 'social media strategy,' 'social calendar,' 'community management,' 'social media plan,'…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.