A skill your agent uses when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline.

MITAuto-check: notesWriting & Content

Install Outlier Post Finder

skills CLI
$ npx skills add ScrapeCreators/social-media-research-skills --skill outlier-post-finder -a claude-code

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

GitHub CLI
$ gh skill install ScrapeCreators/social-media-research-skills outlier-post-finder --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/ScrapeCreators/social-media-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/outlier-post-finder .claude/skills/outlier-post-finder && 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
outlier-post-finder
GitHub stars
3.3k
Token cost
~1.5k tokens
SKILL.md length
535 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline.

  • Works in 7 steps: Clarify scope only if needed → Fetch recent posts → Normalize metrics → …
  • The user wants to find posts
  • SKILL.md covers Overview, When to Use, Data Sources and Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Outlier Post Finder is an agent skill from ScrapeCreators/social-media-research-skills. Use when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline. Finds outliers, explains why they worked, extracts hooks and formats, and produces a practical swipe file.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Social media posts and Video scripts and shorts. It works with X (Twitter), YouTube, Instagram and LinkedIn. The repository describes itself as: AI agent skills for social media research. Outlier posts, comment mining, competitor teardowns, ad libraries & trends across TikTok, Instagram, YouTube, Reddit, X, LinkedIn &… The licence is MIT.

When your agent uses it

  • The user wants to find posts
  • Social content that overperformed versus a creator
  • Competitor baseline

Example prompts

  • “/outlier-post-finder”

Requirements

  • A credential in SCRAPECREATORS_API_KEY
  • Pre-approved tools (allowed-tools): Bash, Read, Write, WebFetch

Workflow steps

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

  1. Clarify scope only if needed
  2. Fetch recent posts
  3. Normalize metrics
  4. Calculate the account baseline
  5. Score outliers
  6. Enrich the winners
  7. Explain why they worked

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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

Outlier Post Finder loads about 1.5k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 535 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, WebFetch

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 ScrapeCreators/social-media-research-skills at commit 64ba7b4, republished under its MIT licence (© ScrapeCreators). 535 words, ~1,534 tokens.

Download SKILL.mdSave it as .claude/skills/outlier-post-finder/SKILL.md (or your agent's skills folder).
name
outlier-post-finder
description
Use when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline. Finds outliers, explains why they worked, extracts hooks and formats, and produces a practical swipe file.
allowed-tools
Bash, Read, Write, WebFetch
version
1.0.0
author
ScrapeCreators
license
MIT
homepage
https://scrapecreators.com
repository
https://github.com/ScrapeCreators/social-media-research-skills

Outlier Post Finder

Overview

Find social posts that beat an account's normal performance. The goal is not just to sort by views. The goal is to identify posts that performed unusually well for that creator or brand, then explain the repeatable patterns.

Use ScrapeCreators as the data layer. Pull recent public posts, normalize engagement metrics, calculate each account's baseline, and produce an outlier report with source URLs and practical takeaways.

When to Use

Use this skill when the user asks to:

  • find outlier posts, viral posts, top posts, best reels, best shorts, best TikToks, or best tweets
  • analyze why a creator's content is working
  • find competitor posts worth copying or learning from
  • build a swipe file from high-performing social posts
  • compare performance across a creator's recent posts

Do not use this for raw endpoint lookup only. Use scrapecreators-api for direct API routing.

Data Sources

Prefer the platform-specific feed endpoint, then enrich individual posts only when needed.

PlatformFeed endpointDetail/enrichment endpoint
TikTok/v3/tiktok/profile/videos/v2/tiktok/video, /v1/tiktok/video/transcript
Instagram posts/v2/instagram/user/posts/v1/instagram/post, /v2/instagram/media/transcript
Instagram reels/v1/instagram/user/reels/v1/instagram/post, /v2/instagram/media/transcript
YouTube videos/v1/youtube/channel-videos/v1/youtube/video, /v1/youtube/video/transcript
YouTube Shorts/v1/youtube/channel/shorts/v1/youtube/video, /v1/youtube/video/transcript
Facebook/v1/facebook/profile/posts, /v1/facebook/profile/reels/v1/facebook/post, /v1/facebook/post/transcript
LinkedIn/v1/linkedin/company/posts/v1/linkedin/post, /v1/linkedin/post/transcript
X/Twitter/v1/twitter/user-tweets/v1/twitter/tweet, /v1/twitter/tweet/transcript
Threads/v1/threads/user/posts/v1/threads/post
Bluesky/v1/bluesky/user/posts/v1/bluesky/post

Before calling an endpoint, fetch its docs or per-endpoint OpenAPI spec if parameter names or response fields are uncertain.

Workflow

  1. Clarify scope only if needed

    • Platform(s)
    • Handles or URLs
    • Time/post count window
    • Whether to include transcript/comment analysis
  2. Fetch recent posts

    • Pull at least 20 posts when available. More is better for baseline confidence.
    • Paginate if the endpoint supports cursors and the user wants a larger window.
    • Keep source URLs for citations.
  3. Normalize metrics

    • Capture whatever exists: views, plays, likes, comments, shares, reposts, saves.
    • Build a combined engagement score only after preserving raw metrics.
    • For video-first platforms, views/play count is usually the primary metric.
    • For text-first platforms, likes + replies/comments + reposts/shares is usually better.
  4. Calculate the account baseline

    • Use median instead of mean so one viral post does not distort the baseline.
    • Calculate per-platform and per-account baselines separately.
    • If mixed formats exist, split by format when possible: reel vs carousel, short vs long video, text vs video.
  5. Score outliers

    • view_lift = post_views / median_views
    • engagement_lift = post_engagement / median_engagement
    • Label posts as:
      • Huge outlier: 5x+ baseline
      • Strong outlier: 2x-5x baseline
      • Mild outlier: 1.5x-2x baseline
    • If sample size is under 10 posts, call confidence low.
  6. Enrich the winners

    • Fetch post details for top outliers.
    • Fetch transcripts for video posts when useful.
    • Optionally fetch comments to understand audience reaction.
  7. Explain why they worked Look for:

    • hook style
    • topic/category
    • format
    • emotional trigger
    • novelty/timeliness
    • creator proof or authority
    • controversy or debate
    • comments showing confusion, desire, or buying intent
Show full SKILL.md (86 more words)Show less

Output Format

markdown
# Outlier Posts Report: {creator_or_brand}

## Summary
- Sample: {n} posts from {platforms}
- Window: {window}
- Baseline: median {primary_metric} = {value}
- Confidence: High/Medium/Low

## Biggest Outliers
| Rank | Post | Platform | Date | Primary Metric | Lift | Why it likely worked |
|---:|---|---|---|---:|---:|---|
| 1 | [title/hook](url) | TikTok | 2026-01-01 | 1.2M views | 8.4x | Contrarian hook + clear before/after |

## Repeatable Patterns
1. **Pattern name** — evidence and examples.
2. **Pattern name** — evidence and examples.

## Hooks to Steal
- "Exact hook from caption or transcript"
- "Exact hook from caption or transcript"

## Content Ideas Based on the Outliers
1. ...
2. ...

## Notes and Caveats
- Public data only.
- Small samples are directional, not definitive.

Common Pitfalls

  • Do not call the highest raw-view post the best outlier if a huge account is being compared with a small one. Use lift versus each account's own baseline.
  • Do not average TikTok, Instagram, YouTube, and LinkedIn metrics into one baseline. Score each platform separately.
  • Do not invent transcript quotes. Fetch transcripts or quote only visible captions/text.
  • Do not overstate confidence from fewer than 10 posts.
  • Do not ignore old viral posts if the user asked for recent performance. Respect the requested window.

© ScrapeCreators, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/outlier-post-finder of ScrapeCreators/social-media-research-skills.

Open the folder on GitHubat commit 64ba7b4

Compare with similar skills

Outlier Post Finder 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.

Outlier Post Finder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Outlier Post Finder this skillScrapeCreators/social-media-research-skills3.3k—~1.5kAutomated safety check: NotesMIT
Hook Writer Smsblacktwist/social-media-skills557—~3.7kAutomated safety check: PassMIT
Caption Writersocial-media-skills/skills116—~1.7kAutomated safety check: PassMIT
Schedule Socialindranilbanerjee/digital-marketing-pro8541 repos~3.4kAutomated safety check: PassMIT
Social Media Managementmanojbajaj95/claude-gtm-plugin1041 repos~3.9kAutomated safety check: PassMIT
AI Social Media ContentNeverSight/learn-skills.dev2161 repos~1.8kAutomated safety check: PassNone

Similar skills

  • Hook Writer Sms

    blacktwist/social-media-skills

    When the user wants help writing opening lines, hooks, first sentences, video hooks, thumbnails titles, or pin titles that grab attention.

    557 GitHub stars~3.7k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Caption Writer

    social-media-skills/skills

    A skill your agent uses to write platform-native social media captions (post copy) in the brand's voice — the words that accompany a post on Instagram, LinkedIn, TikTok, Facebook, X/Twitter…

    116 GitHub stars~1.7k tokensUpdated 5 days ago
    Writing & ContentAuto-check passed
  • Schedule Social

    indranilbanerjee/digital-marketing-pro

    Schedule social posts to Twitter/X, Instagram, LinkedIn, TikTok, YouTube, and Pinterest through connected platform MCPs — generating per-platform copy variations, hashtag mixes, media-spec…

    854 GitHub starsUsed in 1 repo~3.4k tokens
    Writing & ContentAuto-check passed
  • Social Media Management

    manojbajaj95/claude-gtm-plugin

    Comprehensive social media management for all platforms (LinkedIn, Twitter/X, Instagram, TikTok, Facebook, Pinterest, YouTube).

    104 GitHub starsUsed in 1 repo~3.9k tokens
    Writing & ContentAuto-check passed
  • AI Social Media Content

    NeverSight/learn-skills.dev

    Create AI-powered social media content for TikTok, Instagram, YouTube, Twitter/X.

    216 GitHub starsUsed in 1 repo~1.8k tokens
    Writing & ContentAuto-check passed
  • Social Content

    alecs5am/ralphy

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    136 GitHub starsUsed in 3 repos~3.2k tokens
    Writing & ContentAuto-check passed

More from ScrapeCreators/social-media-research-skills

All 13 skills in this repo
  • Scrapecreators API

    ScrapeCreators/social-media-research-skills

    Scrape and extract public data from 27+ social media platforms using the ScrapeCreators REST API.

    3.3k GitHub starsUsed in 1 repo~4k tokens
    Auto-check: notes
  • Ad Library Teardown

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to analyze active ads from Meta/Facebook, Google, or LinkedIn ad libraries; tear down a competitor's messaging; extract hooks, offers, CTAs, video…

    3.3k GitHub stars~947 tokensUpdated 1 mo ago
    Auto-check: notes
  • Audience Research

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to evaluate a creator, influencer, or brand audience using public profile signals, TikTok audience demographics, follower/following data, comments…

    3.3k GitHub stars~635 tokensUpdated 1 mo ago
    Auto-check: notes
  • Comment Mining

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to mine comments and replies for audience reactions, customer language, questions, objections, complaints, product ideas, buying intent, sentiment, or…

    3.3k GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Competitor Social Research

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to research competitors' social media strategy, compare brands or creators, find what content is working in a niche, identify content gaps, or produce a…

    3.3k GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Content Repurposing

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to turn public social videos, transcripts, posts, or creator research into reusable content assets such as LinkedIn posts, X threads, short-form scripts…

    3.3k GitHub stars~564 tokensUpdated 1 mo ago
    Auto-check: notes

Questions about Outlier Post Finder

What does Outlier Post Finder do?

A skill your agent uses when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline. Outlier Post Finder is an agent skill from ScrapeCreators/social-media-research-skills. Use when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline.

When should I use Outlier Post Finder?

Outlier Post Finder fits situations like: the user wants to find posts; social content that overperformed versus a creator; competitor baseline.

How do I install Outlier Post Finder in Claude Code?

Run `npx skills add ScrapeCreators/social-media-research-skills --skill outlier-post-finder -a claude-code`. Or copy the skill folder (skills/outlier-post-finder in ScrapeCreators/social-media-research-skills) into .claude/skills/outlier-post-finder in your project. Claude Code loads it when a task matches its description.

How do I install Outlier Post Finder in Codex?

Run `npx skills add ScrapeCreators/social-media-research-skills --skill outlier-post-finder -a codex`. Or copy the skill folder (skills/outlier-post-finder in ScrapeCreators/social-media-research-skills) into .agents/skills/outlier-post-finder in your project. Codex loads it when a task matches its description.

Can I use Outlier Post Finder 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 ScrapeCreators/social-media-research-skills --skill outlier-post-finder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/outlier-post-finder, .gemini/skills/outlier-post-finder, .github/skills/outlier-post-finder and .opencode/skills/outlier-post-finder in your project.

What does Outlier Post Finder need to run?

SKILL.md names no scripts, command-line tools or credentials: Outlier Post Finder is instructions for the agent only. Our summary lists: A credential in SCRAPECREATORS_API_KEY. Its frontmatter pre-approves these tools: Bash, Read, Write, WebFetch.

Does Outlier Post Finder 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 Outlier Post Finder safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Outlier Post Finder use?

Outlier Post Finder is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Outlier Post Finder use?

About 1.5k tokens (SKILL.md is roughly 6.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 Outlier Post Finder?

Skills that share tags, products or a category with Outlier Post Finder: Hook Writer Sms (blacktwist/social-media-skills, 557 stars), Caption Writer (social-media-skills/skills, 116 stars), Schedule Social (indranilbanerjee/digital-marketing-pro, 854 stars) and Social Media Management (manojbajaj95/claude-gtm-plugin, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Outlier Post Finder?

ScrapeCreators (a GitHub organization) maintains it in ScrapeCreators/social-media-research-skills, which has 3,258 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on August 26, 2026.

Source: ScrapeCreators/social-media-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.