Menu

#755 by GitHub stars

rohunvora/x-research-skill

General-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert opinions. Works like a web research agent but uses X as the source. Use when: (1) user says "x research", "search x for", "search twitter for"

Research

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

623cca7f41f2 → 623cca7f41f2

Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 623cca7f41f2

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 623cca7f41f2fb859bdd01dd7328b7b15da110ed

1.2kGitHub stars
1star in 7 days
1skill in this repository
0commits in 30 days

Heat

2.8
  • Star growth, last 7 daysAhead of 36% of tracked repositories
  • Star growth, last 24 hoursAhead of 72% of tracked repositories
  • Rank movement, last 7 daysAhead of 7% of tracked repositories
  • Commits, last 30 daysAhead of 0% of tracked repositories
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekAhead of 0% of tracked repositories

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Aug 1, 2026Nov 7, 20261,244

Individual skills in this repository

How it works

x-research

When your agent uses it

General-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert opinions. Works like a web research agent but uses X as the source. Use when: (1) user says "x research", "search x for", "search twitter for", "what are people saying about", "what's twitter saying", "check x for", "x search", "/x-research", (2) user is working on something where recent X discourse would provide useful context (new library releases, API changes, product launches, cultural events, industry drama), (3) user wants to find what devs/experts/community thinks about a topic. NOT for: posting tweets or account management. Note: currently uses recent search (last 7 days). Full-archive search is available on the same pay-per-use X API plan but not yet implemented in this skill.

What it loads into context

Frontmatter

208 tokens

Always available to the agent

SKILL.md

1,730 tokens

When the skill is activated

Reference documents

4,710 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. CLI Tool
  2. Research Loop (Agentic)
  3. Refinement Heuristics
  4. Heartbeat Integration
  5. File Structure

Scripts executed separately

  • lib/api.ts
  • lib/cache.ts
  • lib/format.ts
  • x-search.ts

Files

  • .gitignoreasset52 bytes
  • CHANGELOG.mddoc4,984 bytes
  • README.mddoc7,962 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • SKILL.mdcore6,648 bytes
  • data/.gitkeepasset0 bytes
  • data/cache/.gitkeepasset0 bytes
  • data/watchlist.example.jsonasset200 bytes
  • lib/api.tsruns8,566 bytes
  • lib/cache.tsruns2,412 bytes
  • lib/format.tsruns4,559 bytes
  • references/x-api.mddoc5,343 bytes
  • x-search.tsruns13,498 bytes

No excerpt is shown for this license. Read the source on GitHub.

View the complete source on GitHub

Skills included

  • x-research

Repository facts

License
No license detected
Created
Feb 8, 2026
Last pushed
Feb 19, 2026
Forks
114
Open issues
3
Project activity
Slowing

Rank over the last 12 weeks

Now #755 · best #495 · down 123 in 30 days

  1. #736 on Nov 1
  2. #740 on Nov 2
  3. #748 on Nov 3
  4. #751 from Nov 4 to Nov 5
  5. #753 on Nov 6
  6. #755 since Nov 7
39 earlier periods
  1. #522 on Aug 1
  2. #484 on Aug 8
  3. #506 on Aug 10
  4. #504 on Aug 11
  5. #507 on Aug 14
  6. #499 on Aug 16
  7. #512 on Aug 21
  8. #495 on Aug 22
  9. #520 on Aug 24
  10. #532 on Aug 25
  11. #522 on Aug 26
  12. #533 on Aug 27
  13. #532 on Aug 28
  14. #507 on Aug 30
  15. #542 on Sep 1
  16. #521 on Sep 5
  17. #536 on Sep 6
  18. #542 on Sep 7
  19. #557 on Sep 8
  20. #543 on Sep 9
  21. #550 on Sep 10
  22. #541 on Sep 11
  23. #560 on Sep 14
  24. #558 on Sep 17
  25. #554 on Sep 25
  26. #555 on Sep 26
  27. #606 on Sep 29
  28. #565 on Oct 3
  29. #597 on Oct 6
  30. #632 on Oct 8
  31. #617 on Oct 9
  32. #603 on Oct 10
  33. #606 on Oct 11
  34. #638 on Oct 14
  35. #715 on Oct 25
  36. #723 on Oct 28
  37. #728 on Oct 29
  38. #729 on Oct 30
  39. #735 on Oct 31

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 3, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 10 notes
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 48 signals by file

CHANGELOG.md

  • Network accessline 67
    ### How it compares to v1 - v1 was a prompt-only skill — Claude assembled raw curl commands with inline Python parsers each time
  • Network accessline 68
    - v1 was a prompt-only skill — Claude assembled raw curl commands with inline Python parsers each time

README.md

  • Network accessline 3
    X/Twitter research agent for [Claude Code](https://code.claude.com) and [OpenClaw](https://openclaw.ai). Search, filter, monitor — all from the terminal.
  • Network accessline 7
    Wraps the X API into a fast CLI so your AI agent (or you) can search tweets, pull threads, monitor accounts, and get sourced research without writing curl commands.
  • Network accessline 20
    mkdir -p .claude/skills cd .claude/skills git clone https://github.com/rohunvora/x-research-skill.git x-research
  • Network accessline 22
    git clone https://github.com/rohunvora/x-research-skill.git x-research
  • Network accessline 28
    mkdir -p skills cd skills git clone https://github.com/rohunvora/x-research-skill.git x-research
  • Network accessline 30
    git clone https://github.com/rohunvora/x-research-skill.git x-research
  • Network accessline 35
    1. **X API Bearer Token** — Get one from the [X Developer Portal](https://developer.x.com)
  • Access to secretsline 38
    [Credential-related source omitted]
  • Network accessline 44
    3. **Install Bun** (for CLI tooling): https://bun.sh
  • Network accessline 148
    As of February 2026, the X API uses **pay-per-use pricing** with prepaid credits. No subscriptions, no monthly caps. You buy credits in the [Developer Console](https://console.x.com) and they're deducted per request.
  • Network accessline 172
    **xAI credit bonus:** Spend $200+/cycle on X API → earn 10-20% back as xAI/Grok API credits. See [pricing docs](https://docs.x.com/x-api/getting-started/pricing).
  • Network accessline 210
    - Search covers last 7 days only (uses `/2/tweets/search/recent` — the full-archive `/2/tweets/search/all` endpoint is available on the same pay-per-use plan but not yet implemented in this skill) - Read-only — never posts or interacts - Re
  • Network accessline 211
    - Read-only — never posts or interacts - Requires X API access with prepaid credits ([sign up](https://console.x.com)) - `min_likes` / `min_retweets` search operators unavailable (filtered post-hoc instead)
  • Network accessline 212
    - Requires X API access with prepaid credits ([sign up](https://console.x.com))
  • Network accessline 214
    - Full-archive search (beyond 7 days) is available on pay-per-use (same credits). See [X API search docs](https://docs.x.com/x-api/posts/search/introduction). This skill currently only uses recent search — full-archive support coming soon.
  • Network accessline 218
    [![Star History Chart](https://api.star-history.com/svg?repos=rohunvora/x-research-skill&type=Date)](https://star-history.com/#rohunvora/x-research-skill&Date)

lib/api.ts

  • Executable scriptline 1
    Executable file
  • Access to secretsline 3
    [Credential-related source omitted]
  • Network accessline 8
    const BASE = "https://api.x.com/2";
  • Access to secretsline 13
    [Credential-related source omitted]
  • Access to secretsline 21
    [Credential-related source omitted]
  • Network accessline 99
    .map((h: any) => h.tag)         .filter(Boolean),       tweet_url: `https://x.com/${u.username || "?"}/status/${t.id}`,
  • Network accessline 100
    .filter(Boolean),       tweet_url: `https://x.com/${u.username || "?"}/status/${t.id}`,     };
  • Network accessline 101
    tweet_url: `https://x.com/${u.username || "?"}/status/${t.id}`,
  • Network accessline 140
    [Credential-related source omitted]
  • Network accessline 141
    [Credential-related source omitted]
  • Network accessline 142
    const res = await fetch(url, {

lib/cache.ts

  • Executable scriptline 1
    Executable file

lib/format.ts

  • Executable scriptline 1
    Executable file

references/x-api.md

  • Access to secretsline 5
    [Credential-related source omitted]
  • Access to secretsline 8
    [Credential-related source omitted]
  • Network accessline 15
    GET https://api.x.com/2/tweets/search/recent
  • Network accessline 21
    GET https://api.x.com/2/tweets/search/all
  • Network accessline 83
    },     "entities": {       "urls": [{"expanded_url": "https://..."}],
  • Network accessline 84
    "entities": {       "urls": [{"expanded_url": "https://..."}],       "mentions": [{"username": "..."}],
  • Network accessline 85
    "urls": [{"expanded_url": "https://..."}],
  • Network accessline 100
    https://x.com/{username}/status/{tweet_id}
  • Network accessline 130
    **Billing details:** - Purchase credits upfront at [console.x.com](https://console.x.com)
  • Network accessline 131
    - Purchase credits upfront at [console.x.com](https://console.x.com)
  • Network accessline 139
    GET https://api.x.com/2/usage/tweets
  • Access to secretsline 140
    [Credential-related source omitted]
  • Network accessline 163
    GET https://api.x.com/2/tweets/{id}

x-search.ts

  • Executable scriptline 1
    #!/usr/bin/env bun
  • Network accessline 18
    *   --min-likes N              Filter by minimum likes  *   --min-impressions N        Filter by minimum impressions  *   --pages N                  Number of pages to fetch (default: 1, max 5)
  • Network accessline 19
    *   --min-impressions N        Filter by minimum impressions  *   --pages N                  Number of pages to fetch (default: 1, max 5)  *   --no-replies               Exclude replies
  • Network accessline 20
    *   --pages N                  Number of pages to fetch (default: 1, max 5)

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 4 facts
  • Network access in prose of documentationREADME.md:3Low confidence
  • Network access in code of documentationREADME.md:22Low confidence
  • Network access in code of documentationREADME.md:30Low confidence
  • Access to secrets in code of documentation: a variable, placeholder or call, not a stored valueREADME.md:38Low confidence

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeCompatibleStandard SKILL.md SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

You might also use

mvanhorn/last30days-skill

Research what people actually say about any topic in the last 30 days. Pulls posts and engagement from Reddit, X, YouTube, TikTok, Hacker News, Polymarket, GitHub, and the web. In…

66.9kGitHub stars

K-Dense-AI/scientific-agent-skills

Turn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 250,000+ scientists worldwide. 177 ready-to-use validated skills plus 100+ scientific data…

56.3kGitHub stars

wanshuiyin/Auto-claude-code-research-in-sleep

ARIS ⚔️ (Auto-Research-In-Sleep) — Lightweight Markdown-only skills for autonomous ML research: cross-model review loops, idea discovery, and experiment automation. No framework, …

18.8kGitHub stars

Imbad0202/academic-research-skills-codex

Codex-native Academic Research Skills suite for human-in-the-loop academic research workflows

14.1kGitHub stars

HKUSTDial/Supervisor-Skills

将博导十年科研经验炼化为可直接调用的 AI 技能。从 Idea 构思到论文投稿，你的 AI 科研副导师。

11.9kGitHub stars

Master-cai/Research-Paper-Writing-Skills

Improve academic paper writing quality for ML/CV/NLP-style papers with clear section structure, paragraph flow, and reviewer-facing presentation. Use when drafting or revising Abs…

8.1kGitHub stars

Explore alternatives and comparisons

Add this badge to your README

It updates every night and links to this page.

rohunvora/x-research-skill: #755 on hotskills, 1.2k stars

[![rohunvora/x-research-skill on hotskills](https://hotskills.dev/badge/rohunvora-x-research-skill.svg)](https://hotskills.dev/skill/rohunvora-x-research-skill/)