Agent skill

Social Listening

by gooseworks-ai in gooseworks-ai/goose-skills

Monitor brand mentions, competitor activity, and industry conversations across social media and the web

MITAuto-check passedMarketing & SEO

Install Social Listening

skills CLI
$ npx skills add gooseworks-ai/goose-skills --skill social-listening -a claude-code

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

GitHub CLI
$ gh skill install gooseworks-ai/goose-skills social-listening --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/gooseworks-ai/goose-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/social/capabilities/social-listening .claude/skills/social-listening && 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
GitHub stars
1.2k
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
306 words
Files
2
Skills in repo
273
Repo updated
First seen
Licence
MIT

At a glance

Monitor brand mentions, competitor activity, and industry conversations across social media and the web

  • Works in 3 steps: Search Web Mentions with Exa → Monitor Social Media with Scrape Creators → Deep Scrape Key Pages with Scrapegraph
  • Tasks that involve Social media marketing
  • SKILL.md covers Setup, When to Use, Workflow and Examples, plus 1 more section
  • Calls curl, python3 and npx; reaches api.gooseworks.ai and linkedin.com; needs GOOSEWORKS_API_KEY

What it does

Social Listening is an agent skill from gooseworks-ai/goose-skills. Monitor brand mentions, competitor activity, and industry conversations across social media and the web

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.meta.json`).

It sits in Marketing & SEO, covering Social media marketing. It works with LinkedIn and X (Twitter). The repository describes itself as: Library of Growth & GTM skills + data APIs for Claude Code, Codex, Cursor to run ads, social, content, lead gen, seo and data scraping. The licence is MIT.

When your agent uses it

  • Tasks that involve Social media marketing

Example prompts

  • “/social-listening”

Requirements

  • Python 3
  • Node.js
  • A credential in GOOSEWORKS_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Search Web Mentions with Exa
  2. Monitor Social Media with Scrape Creators
  3. Deep Scrape Key Pages with Scrapegraph

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • python3
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.gooseworks.ai
    • linkedin.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOSEWORKS_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Social Listening loads about 1.1k tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 306 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 gooseworks-ai/goose-skills at commit c650c6d, republished under its MIT licence (© gooseworks-ai). 306 words, ~1,078 tokens.

Download SKILL.mdSave it as .claude/skills/social-listening/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
social-listening
description
Monitor brand mentions, competitor activity, and industry conversations across social media and the web
source
orthogonal

Social Listening

Setup

Choose the available runtime before doing any credential setup:

  • Terminal-free client: skip the shell commands below. Use connected MCP tools. For ScrapeCreators operations, read scrapecreators-api and prefer call_data_provider. For another provider step without a connected tool, use an equivalent built-in public-web method when it preserves the workflow, or clearly report that step as unavailable.
  • Local terminal: use the GooseWorks credentials and proxy commands below.

Read your credentials from ~/.gooseworks/credentials.json:

bash
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

The local proxy endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY". ScrapeCreators operation descriptions below remain environment-neutral in both runtimes.

Track brand mentions, competitor activity, and industry conversations across social media and the web.

When to Use

  • User wants to monitor what people say about a brand or product
  • User asks "what are people saying about [company]?"
  • Tracking competitor launches or announcements
  • Monitoring industry trends and sentiment
  • Social media due diligence before partnerships

Workflow

Step 1: Search Web Mentions with Exa

Find recent mentions, reviews, and discussions across the web:

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"exa","path":"/search"}'
  "query": "Notion reviews opinions user feedback",
  "numResults": 30,
  "contents": {"text": true}
}'
Step 2: Monitor Social Media with Scrape Creators

Check what's being posted on X/Twitter:

yaml
provider: scrapecreators
method: GET
path: /v1/twitter/user-tweets
query:
  handle: NotionHQ

Check LinkedIn company activity:

yaml
provider: scrapecreators
method: GET
path: /v1/linkedin/company/posts
query:
  url: https://linkedin.com/company/notion

Use /v1/linkedin/company when only the company page is needed, and /v1/linkedin/post for one specific post URL.

Step 3: Deep Scrape Key Pages with Scrapegraph

Extract structured data from specific pages found in Steps 1-2:

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"scrapegraph","path":"/v1/smartscraper"}'
  "website_url": "https://example.com/review-page",
  "user_prompt": "Extract sentiment, key complaints, and praise about the product"
}'

Examples

User: "What are people saying about Slack?"

bash
# Step 1: Web mentions
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"exa","path":"/search","body":{"query":"Slack reviews complaints praise 2025 2026","numResults":20,"contents":{"text":true}}}'

Then run the X/Twitter operation from Step 2 with handle: SlackHQ through the selected ScrapeCreators runtime.

User: "Monitor competitor launches in the AI space"

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"exa","path":"/search","body":{"query":"AI startup launch announcement new product 2026","numResults":30,"contents":{"text":true}}}'

Tips

  • Use Exa for broad web monitoring (blogs, forums, news)
  • Use Scrape Creators for social media (X/Twitter, LinkedIn, Instagram, TikTok)
  • Use Scrapegraph for extracting structured data from specific URLs
  • Include date ranges in Exa queries for recent results
  • Track both your brand and competitors for comparative insights

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

Files

SKILL.md and 1 other file in skills/social/capabilities/social-listening of gooseworks-ai/goose-skills.

  • SKILL.md
  • skill.meta.json

Open the folder on GitHubat commit c650c6d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in gooseworks-ai/goose-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Social Listening 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Listening this skillgooseworks-ai/goose-skills1.2k1 repos~1.1kAutomated safety check: PassMIT
Business Contact and Social Links Finderbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Buying Signal Monitorunifapi-agent/agents589—~2.4kAutomated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Banner Design Systemnextlevelbuilder/ui-ux-pro-max-skill135k1 repos~1.8kAutomated safety check: PassMIT
Social Media Managementmanojbajaj95/claude-gtm-plugin1051 repos~3.9kAutomated safety check: PassMIT

Similar skills

  • Finds a company's official website and social profiles from its name, or collects social links from a website URL, using BrowserAct templates run by a Python script.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Marketing & SEOAuto-check passed
  • Buying Signal Monitor

    unifapi-agent/agents

    When a seller or SDR wants to catch public buying intent on X/Twitter and LinkedIn — someone asking for a tool they sell, complaining about or switching off a competitor, or hiring for a role that…

    589 GitHub stars~2.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    135k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed
  • Social Media Management

    manojbajaj95/claude-gtm-plugin

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

    105 GitHub starsUsed in 1 repo~3.9k tokens
    Writing & ContentAuto-check passed
  • Ads

    Cesarjoquin/Marketing-Skills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    202 GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed

More from gooseworks-ai/goose-skills

All 273 skills in this repo
  • Reddit Post Finder

    gooseworks-ai/goose-skills

    Scrape and search Reddit posts using Apify. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Create Image Fal

    gooseworks-ai/goose-skills

    Generate or edit an image via any FAL image model (nano-banana edit, gpt-image, flux, ...), ROUTED THROUGH THE fal-proxy so it bills the Ads agent.

    1.2k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Render Hook Replacement

    gooseworks-ai/goose-skills

    Replace an existing video's opening with a supplied clip or free kinetic text hook while retaining and verifying every original body frame, audio, captions and ending.

    1.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Blog Feed Monitor

    gooseworks-ai/goose-skills

    Scrape blog posts via RSS feeds (free, no API key) with Apify fallback for JS-heavy sites.

    1.2k GitHub starsUsed in 1 repo~578 tokens
    Auto-check passed
  • Competitor Post Engagers

    gooseworks-ai/goose-skills

    Find leads by scraping engagers from a competitor's top LinkedIn posts.

    1.2k GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check: notes
  • Render Chatgpt Chat

    gooseworks-ai/goose-skills

    Assemble a ChatGPT chat-reveal video ad from a thread + timeline JSON — one continuous Playwright recording of a ChatGPT mobile chat (user types with the iOS keyboard up → taps send → keyboard…

    1.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Categories

Questions about Social Listening

What does Social Listening do?

Monitor brand mentions, competitor activity, and industry conversations across social media and the web. Social Listening is an agent skill from gooseworks-ai/goose-skills.

When should I use Social Listening?

Social Listening fits situations like: tasks that involve Social media marketing.

How do I install Social Listening in Claude Code?

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

How do I install Social Listening in Codex?

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

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

What does Social Listening need to run?

Going by SKILL.md and its folder, Social Listening needs the command-line tools its instructions call (curl, python3 and npx) and credentials named GOOSEWORKS_API_KEY. Our summary lists: Python 3; Node.js; A credential in GOOSEWORKS_API_KEY.

Does Social Listening access the network?

SKILL.md names 2 domains. In commands or code: api.gooseworks.ai and linkedin.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Social Listening safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Social Listening use?

Social Listening is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Social Listening use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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?

Skills that share tags, products or a category with Social Listening: Business Contact and Social Links Finder (browser-act/skills, 6.1k stars), Buying Signal Monitor (unifapi-agent/agents, 589 stars), Social (coreyhaines31/marketingskills, 54k stars) and Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 135k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Listening?

gooseworks-ai (a GitHub organization) maintains it in gooseworks-ai/goose-skills, which has 1,240 GitHub stars. The repository holds 273 skills in this directory. The repository was last updated on October 8, 2026.

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