Agent skill

Social Data

by Bitterbot-AI in Bitterbot-AI/bitterbot-desktop

Search and fetch social media data from Twitter/X, Reddit, and Hacker News.

MITAuto-check passed

Install Social Data

skills CLI
$ npx skills add Bitterbot-AI/bitterbot-desktop --skill social-data -a claude-code

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

GitHub CLI
$ gh skill install Bitterbot-AI/bitterbot-desktop social-data --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/Bitterbot-AI/bitterbot-desktop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/social-data .claude/skills/social-data && 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-data
GitHub stars
2.5k
Token cost
~793 tokens
SKILL.md length
201 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Search and fetch social media data from Twitter/X, Reddit, and Hacker News.

  • Tasks that involve Social media posts
  • SKILL.md covers Hacker News (free, no key), Reddit (free, no key for…, Twitter/X (requires API key) and Tips
  • Calls curl; reaches reddit.com and api.twitter.com; needs TWITTER_BEARER_TOKEN

What it does

Social Data is an agent skill from Bitterbot-AI/bitterbot-desktop. Search and fetch social media data from Twitter/X, Reddit, and Hacker News.

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

It works with X (Twitter) and Reddit. The repository describes itself as: Bitterbot - a mesh of agents that turns shared experience into collective capability. The licence is MIT.

When your agent uses it

  • Tasks that involve Social media posts

Example prompts

  • “/social-data”

Requirements

  • A credential in TWITTER_BEARER_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit cd4562a. 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

    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:

    • reddit.com
    • api.twitter.com
    • hacker-news.firebaseio.com
    • hn.algolia.com

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

  • Credentials

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

    • TWITTER_BEARER_TOKEN

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

Context cost

Social Data loads about 793 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 201 words of instructions outside code blocks.

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

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 Bitterbot-AI/bitterbot-desktop at commit cd4562a, republished under its MIT licence (© Bitterbot-AI). 201 words, ~793 tokens.

Download SKILL.mdSave it as .claude/skills/social-data/SKILL.md (or your agent's skills folder).
name
social-data
description
Search and fetch social media data from Twitter/X, Reddit, and Hacker News.

Social Data

Access social media content from multiple platforms. Some require API keys, some are free.

Hacker News (free, no key)

Top Stories
bash
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json" | head -c 200

Returns array of item IDs. Fetch individual items:

bash
curl -s "https://hacker-news.firebaseio.com/v0/item/12345678.json"
Search (via Algolia, free)
bash
curl -s "https://hn.algolia.com/api/v1/search?query=rust+programming&tags=story&hitsPerPage=10"
  • tags: story, comment, ask_hn, show_hn, poll
  • numericFilters: created_at_i>1700000000 (Unix timestamp)
  • Response: hits[] array with title, url, author, points, num_comments
Front Page
bash
curl -s "https://hn.algolia.com/api/v1/search?tags=front_page&hitsPerPage=30"

Reddit (free, no key for public data)

Subreddit Posts
bash
curl -s "https://www.reddit.com/r/programming/hot.json?limit=10" \
  -H "User-Agent: bitterbot/1.0"

Sort options: hot, new, top, rising For top: add ?t=hour|day|week|month|year|all

Search Reddit
bash
curl -s "https://www.reddit.com/search.json?q=rust+async&sort=relevance&limit=10" \
  -H "User-Agent: bitterbot/1.0"
Post Comments
bash
curl -s "https://www.reddit.com/r/programming/comments/POST_ID.json" \
  -H "User-Agent: bitterbot/1.0"

Response is array of two listings: [0] = post, [1] = comments tree.

User Profile (public)
bash
curl -s "https://www.reddit.com/user/USERNAME/submitted.json?limit=10" \
  -H "User-Agent: bitterbot/1.0"

Twitter/X (requires API key)

Requires TWITTER_BEARER_TOKEN env var (from X Developer Portal).

Search Recent Tweets
bash
curl -s "https://api.twitter.com/2/tweets/search/recent?query=from:elonmusk&max_results=10&tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $TWITTER_BEARER_TOKEN"

Query operators:

  • from:username — tweets by user
  • to:username — replies to user
  • #hashtag — hashtag search
  • "exact phrase" — exact match
  • -is:retweet — exclude retweets
  • lang:en — language filter
  • has:media — tweets with media
User Lookup
bash
curl -s "https://api.twitter.com/2/users/by/username/elonmusk?user.fields=public_metrics,description,created_at" \
  -H "Authorization: Bearer $TWITTER_BEARER_TOKEN"
User Timeline
bash
curl -s "https://api.twitter.com/2/users/USER_ID/tweets?max_results=10&tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $TWITTER_BEARER_TOKEN"

Tips

  • Always include User-Agent header for Reddit (they block default agents).
  • Reddit JSON endpoints append .json to any Reddit URL.
  • HN Algolia API is the most reliable for search; Firebase API for real-time data.
  • Twitter free tier allows 500K tweets/month read access.
  • For rate-limited APIs, cache results and avoid repeated identical queries.
  • Use web_fetch for HTML pages, exec + curl for JSON APIs.

© Bitterbot-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

Just SKILL.md in skills/social-data of Bitterbot-AI/bitterbot-desktop.

Open the folder on GitHubat commit cd4562a

Compare with similar skills

Social Data 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 Data compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Data this skillBitterbot-AI/bitterbot-desktop2.5k—~793Automated safety check: PassMIT
Content CollectorvigorX777/content-collector-skill240—~2kAutomated safety check: PassNone
Feedgrab BatchiBigQiang/feedgrab614—~1.8kAutomated safety check: PassMIT
ShareSerhiiKorniienko/bullshit-detector154—~857Automated safety check: PassMIT
Viral Post WriterAffitor/affiliate-skills700—~3.8kAutomated safety check: PassMIT
Social MediaEpicenterHQ/epicenter4.8k—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Content Collector

    vigorX777/content-collector-skill

    Collect social media content (X/Twitter, WeChat, Jike, Reddit, etc.) into Feishu bitable.

    240 GitHub stars~2k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check passed
  • Feedgrab Batch

    iBigQiang/feedgrab

    Batch content grabber — bulk fetch bookmarks, user tweets, search results, author notes, wiki pages, subreddit posts, and more from X/Twitter, Xiaohongshu, Reddit, WeChat, YouTube, Feishu, Zhihu.

    614 GitHub stars~1.8k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Share

    SerhiiKorniienko/bullshit-detector

    Turn a BS report (or any analysis result) into ready-to-paste posts for X/Twitter, LinkedIn, Facebook, Reddit, Hacker News, or a newsletter issue — plus a branded image carousel (PNGs + PDF) for…

    154 GitHub stars~857 tokensUpdated 9 days ago
    Writing & ContentAuto-check passed
  • Viral Post Writer

    Affitor/affiliate-skills

    Write viral social media posts that promote affiliate products naturally.

    700 GitHub stars~3.8k tokensUpdated 24 days ago
    Writing & ContentAuto-check passed
  • Social Media

    EpicenterHQ/epicenter

    Draft social posts for LinkedIn, Reddit, or Twitter/X. An agent skill from EpicenterHQ/epicenter.

    4.8k GitHub stars~1.7k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Headline Engineering

    assafkip/kipi-system

    Platform-optimized headline and hook engineering for X (Twitter), Reddit, LinkedIn, Medium, Substack.

    112 GitHub stars~1.1k tokensUpdated yesterday
    Writing & ContentAuto-check passed

More from Bitterbot-AI/bitterbot-desktop

All 17 skills in this repo
  • Canvas

    Bitterbot-AI/bitterbot-desktop

    Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server.

    2.5k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Moltbook

    Bitterbot-AI/bitterbot-desktop

    Participate in Moltbook — the social network for AI agents. An agent skill from Bitterbot-AI/bitterbot-desktop.

    2.5k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Pre Action Interceptors

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when a tool error begins with "INTERCEPTOR:", a sent message was silently hedged or rewritten, or the user asks about active guards or blocked actions.

    2.5k GitHub stars~580 tokensUpdated today
    Auto-check passed
  • Finance Data

    Bitterbot-AI/bitterbot-desktop

    Get stock quotes, company info, market data, and crypto prices.

    2.5k GitHub stars~696 tokensUpdated today
    Auto-check passed
  • Forage Economy

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation.

    2.5k GitHub stars~633 tokensUpdated today
    Auto-check passed
  • Memory Architecture

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when the user asks how your memory, dreams, hormones or knowledge crystals work, or when you need to interpret memorystatus output.

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

Questions about Social Data

What does Social Data do?

Search and fetch social media data from Twitter/X, Reddit, and Hacker News. Social Data is an agent skill from Bitterbot-AI/bitterbot-desktop. Search and fetch social media data from Twitter/X, Reddit, and Hacker News.

When should I use Social Data?

Social Data fits situations like: tasks that involve Social media posts.

How do I install Social Data in Claude Code?

Run `npx skills add Bitterbot-AI/bitterbot-desktop --skill social-data -a claude-code`. Or copy the skill folder (skills/social-data in Bitterbot-AI/bitterbot-desktop) into .claude/skills/social-data in your project. Claude Code loads it when a task matches its description.

How do I install Social Data in Codex?

Run `npx skills add Bitterbot-AI/bitterbot-desktop --skill social-data -a codex`. Or copy the skill folder (skills/social-data in Bitterbot-AI/bitterbot-desktop) into .agents/skills/social-data in your project. Codex loads it when a task matches its description.

Can I use Social Data 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 Bitterbot-AI/bitterbot-desktop --skill social-data -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-data, .gemini/skills/social-data, .github/skills/social-data and .opencode/skills/social-data in your project.

What does Social Data need to run?

Going by SKILL.md and its folder, Social Data needs the command-line tools its instructions call (curl) and credentials named TWITTER_BEARER_TOKEN. Our summary lists: A credential in TWITTER_BEARER_TOKEN.

Does Social Data access the network?

SKILL.md names 4 domains. In commands or code: reddit.com, api.twitter.com, hacker-news.firebaseio.com and hn.algolia.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Social Data 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 Data use?

Social Data 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 Data use?

About 793 tokens (SKILL.md is roughly 3.2k 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 Data?

Skills that share tags, products or a category with Social Data: Content Collector (vigorX777/content-collector-skill, 240 stars), Feedgrab Batch (iBigQiang/feedgrab, 614 stars), Share (SerhiiKorniienko/bullshit-detector, 154 stars) and Viral Post Writer (Affitor/affiliate-skills, 700 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Data?

Bitterbot-AI (a GitHub organization) maintains it in Bitterbot-AI/bitterbot-desktop, which has 2,467 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 9, 2026.

Source: Bitterbot-AI/bitterbot-desktop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.