Agent skill

Social Listening Brief

by ScrapeCreators in ScrapeCreators/social-media-research-skills

A skill your agent uses when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms.

MITAuto-check: notesMarketing & SEO

Install Social Listening Brief

skills CLI
$ npx skills add ScrapeCreators/social-media-research-skills --skill social-listening-brief -a claude-code

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

GitHub CLI
$ gh skill install ScrapeCreators/social-media-research-skills social-listening-brief --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/social-listening-brief .claude/skills/social-listening-brief && 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-listening-brief
GitHub stars
3.3k
Token cost
~646 tokens
SKILL.md length
189 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 a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms.

  • Works in 6 steps: Define topic, aliases, competitor names,… → Search multiple relevant sources, not… → Keep URLs, dates, platform, engagement… → …
  • The user wants a social listening report about what people are saying about a brand
  • SKILL.md covers Overview, When to Use, Useful Sources and Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Social Listening Brief is an agent skill from ScrapeCreators/social-media-research-skills. Use when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms. Produces cited themes, sentiment caveats, notable posts, and recommended actions.

Its SKILL.md is about 650 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 Marketing & SEO, covering Social media marketing. It works with Reddit. 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 a social listening report about what people are saying about a brand
  • Niche across public social platforms

Example prompts

  • “/social-listening-brief”

Requirements

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

Workflow steps

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

  1. Define topic, aliases, competitor names, and date window.
  2. Search multiple relevant sources, not every source blindly.
  3. Keep URLs, dates, platform, engagement metrics, and exact quotes.
  4. Cluster conversations into themes.
  5. Separate positive, negative, neutral, and mixed signals.
  6. Highlight representative examples and action items.

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

Social Listening Brief loads about 646 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 189 words of instructions outside code blocks.

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

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). 189 words, ~646 tokens.

Download SKILL.mdSave it as .claude/skills/social-listening-brief/SKILL.md (or your agent's skills folder).
name
social-listening-brief
description
Use when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms. Produces cited themes, sentiment caveats, notable posts, and recommended actions.
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

Social Listening Brief

Overview

Research what people are saying publicly across social platforms. This is useful for brand monitoring, category research, product feedback, reputation checks, and understanding recent conversations.

When to Use

Use this skill when the user asks:

  • what are people saying about X?
  • monitor this brand/topic/category
  • find complaints or praise about a product
  • summarize recent social discussion
  • compare sentiment across Reddit, TikTok, YouTube, LinkedIn, Instagram, or Threads

Useful Sources

  • Reddit search, subreddit search, posts, comments
  • TikTok search top/keyword/hashtag and comments
  • YouTube search, transcripts, comments
  • Instagram reels search and hashtag search
  • LinkedIn post search
  • Threads search
  • Google search when platform search is not enough

Workflow

  1. Define topic, aliases, competitor names, and date window.
  2. Search multiple relevant sources, not every source blindly.
  3. Keep URLs, dates, platform, engagement metrics, and exact quotes.
  4. Cluster conversations into themes.
  5. Separate positive, negative, neutral, and mixed signals.
  6. Highlight representative examples and action items.

Output Format

markdown
# Social Listening Brief: {topic}

## Executive Summary
- Main takeaway:
- Conversation volume: Low/Medium/High
- Sentiment: Positive/Neutral/Negative/Mixed
- Confidence: High/Medium/Low

## Top Themes
| Theme | Sentiment | Evidence | Representative quote/source |
|---|---|---|---|

## Notable Posts
- [source](url) — why it matters

## Risks / Opportunities
- ...

## Recommended Actions
1. ...

Common Pitfalls

  • Do not pretend this is exhaustive social monitoring. It is public-data research.
  • Do not average sentiment across very different communities without caveats.
  • Do not use engagement as a proxy for truth.

© 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/social-listening-brief of ScrapeCreators/social-media-research-skills.

Open the folder on GitHubat commit 64ba7b4

Compare with similar skills

Social Listening Brief 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 Listening Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Listening Brief this skillScrapeCreators/social-media-research-skills3.3k—~646Automated safety check: NotesMIT
Reddit Competitor Analysis API Skillbrowser-act/skills6.1k2 repos~1.7kAutomated safety check: PassMIT
Blog DiscourseAgriciDaniel/claude-blog2.3k1 repos~3.4kAutomated safety check: WarnMIT
Community Seeding Planminhnv0807/ai-business-skills608—~3.2kAutomated safety check: PassMIT
Brand Monitoringsandbaseai/sandbase-skills201—~696Automated safety check: PassApache-2.0
Reddit Community Researchunifapi-agent/agents587—~2.7kAutomated safety check: PassMIT

Similar skills

  • This skill helps users extract structured data from Reddit posts and comments via BrowserAct API.

    6.1k GitHub starsUsed in 2 repos~1.7k tokens
    Marketing & SEOAuto-check passed
  • Blog Discourse

    AgriciDaniel/claude-blog

    Research what people are actually saying about a topic in the last 30 days across Reddit, X / Twitter, YouTube, Hacker News, dev.to, Medium, and other public discourse platforms.

    2.3k GitHub starsUsed in 1 repo~3.4k tokens
    Marketing & SEOAuto-check: warnings
  • Community Seeding Plan

    minhnv0807/ai-business-skills

    Plans honest participation in outside communities such as Reddit, Discord and Facebook Groups, with a rules-based community list, roster, posts, replies and calendar.

    608 GitHub stars~3.2k tokensUpdated 26 days ago
    Marketing & SEOAuto-check passed
  • Brand Monitoring

    sandbaseai/sandbase-skills

    Monitor brand mentions, sentiment, and reputation across Twitter, Reddit, news, and social platforms through SandBase.

    201 GitHub stars~696 tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • Reddit Community Research

    unifapi-agent/agents

    When the user wants to understand the Reddit communities around a niche — which subreddits matter, what questions and objections keep coming up, and the exact language people use.

    587 GitHub stars~2.7k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Reddit Thread Fit Check

    unifapi-agent/agents

    When the user wants to decide which Reddit threads are worth replying to, citing, monitoring, or avoiding based on relevance, subreddit rules, conversation intent, and outreach risk.

    587 GitHub stars~1.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-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

Works with

Categories

Questions about Social Listening Brief

What does Social Listening Brief do?

A skill your agent uses when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms. Social Listening Brief is an agent skill from ScrapeCreators/social-media-research-skills. Use when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms.

When should I use Social Listening Brief?

Social Listening Brief fits situations like: the user wants a social listening report about what people are saying about a brand; niche across public social platforms.

How do I install Social Listening Brief in Claude Code?

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

How do I install Social Listening Brief in Codex?

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

Can I use Social Listening Brief 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 social-listening-brief -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-listening-brief, .gemini/skills/social-listening-brief, .github/skills/social-listening-brief and .opencode/skills/social-listening-brief in your project.

What does Social Listening Brief need to run?

SKILL.md names no scripts, command-line tools or credentials: Social Listening Brief 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 Social Listening Brief 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 Listening Brief 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 Social Listening Brief use?

Social Listening Brief 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 Social Listening Brief use?

About 646 tokens (SKILL.md is roughly 2.6k 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 Listening Brief?

Skills that share tags, products or a category with Social Listening Brief: Reddit Competitor Analysis API Skill (browser-act/skills, 6.1k stars), Blog Discourse (AgriciDaniel/claude-blog, 2.3k stars), Community Seeding Plan (minhnv0807/ai-business-skills, 608 stars) and Brand Monitoring (sandbaseai/sandbase-skills, 201 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Listening Brief?

ScrapeCreators (a GitHub organization) maintains it in ScrapeCreators/social-media-research-skills, which has 3,306 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.