How do I install the X Research skill?

Run npx skillmds@latest add majiayu000/x-research-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the X Research skill do?

X/Twitter research via Composio — search, threads, profiles, watchlists It is listed under Research & Search on SkillMD.

Is X Research safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X Research?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is X Research free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published X Research?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X Research by majiayu000 — Agent Skill

Name: X Research
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

X Research Skill

X/Twitter research agent powered by Composio. Zero API cost.

Search for real-time discussions, breaking news, expert opinions, and engagement data.

Commands

Search

/x search <query> [--sort likes|recent] [--since 1h|1d|7d] [--limit N] [--pages N] [--json] [--markdown]

Search recent tweets (last 7 days). Supports engagement sorting, time filtering, pagination, and multiple output formats (default, --json for raw data, --markdown for research documents).

Profile

/x profile <username> [--count N] [--replies] [--json]

Fetch recent tweets from a specific user. Excludes replies by default. Use --json for raw data.

Thread

/x thread <tweet_id> [--pages N]

Reconstruct a full conversation thread from a root tweet ID.

Single Tweet

/x tweet <tweet_id> [--json]

Fetch and display a single tweet with engagement metrics. Use --json for raw data.

Cache

/x cache clear                  Clear search cache

Manage the in-memory search cache (15-minute TTL).

Watchlist

/x watchlist                    Show all tracked accounts
/x watchlist add <user> [note]  Add user to watchlist
/x watchlist remove <user>      Remove user from watchlist
/x watchlist check              Check recent tweets from all watchlist accounts

Track accounts of interest. Watchlist is session-scoped (in-memory).

Research Workflow

For deep research on a topic:

Decompose your question into 3-5 targeted search queries
Search with different sort modes (likes for signal, recent for breaking)
Follow high-engagement threads for context
Check profiles of key accounts found in results
Add important accounts to watchlist for monitoring

Search Operators

Composio supports standard X search operators:

"exact phrase" — Match exact text
from:username — Tweets from a user
-is:retweet — Exclude retweets (added by default)
-is:reply — Exclude replies (use --no-replies)
#hashtag — Filter by hashtag
has:links — Only tweets with links
lang:en — Filter by language

Examples

/x search "prediction markets" --sort likes --since 7d
/x search "polymarket whale" --since 1d --limit 5
/x search "AI agents" --markdown
/x profile polyaborat --count 10
/x thread 1234567890 --pages 3
/x watchlist add vitalikbuterin "ETH creator"
/x watchlist check

Environment Variables

COMPOSIO_API_KEY — Your Composio API key (free tier available)
COMPOSIO_CONNECTION_ID — Your Composio X/Twitter connection ID

Get both at https://composio.dev after connecting your X account.

---name: x-research-3description: X/Twitter research via Composio — search, threads, profiles, watchlists--- # X Research Skill X/Twitter research agent powered by Composio. Zero API cost. Search for real-time discussions, breaking news, expert opinions, and engagement data. ## Commands ### Search ``` /x search <query> [--sort likes|recent] [--since 1h|1d|7d] [--limit N] [--pages N] [--json] [--markdown] ``` Search recent tweets (last 7 days). Supports engagement sorting, time filtering, pagination, and multiple output formats (default, `--json` for raw data, `--markdown` for research documents). ### Profile ``` /x profile <username> [--count N] [--replies] [--json] ``` Fetch recent tweets from a specific user. Excludes replies by default. Use `--json` for raw data. ### Thread ``` /x thread <tweet_id> [--pages N] ``` Reconstruct a full conversation thread from a root tweet ID. ### Single Tweet ``` /x tweet <tweet_id> [--json] ``` Fetch and display a single tweet with engagement metrics. Use `--json` for raw data. ### Cache ``` /x cache clear Clear search cache ``` Manage the in-memory search cache (15-minute TTL). ### Watchlist ``` /x watchlist Show all tracked accounts /x watchlist add <user> [note] Add user to watchlist /x watchlist remove <user> Remove user from watchlist /x watchlist check Check recent tweets from all watchlist accounts ``` Track accounts of interest. Watchlist is session-scoped (in-memory). ## Research Workflow For deep research on a topic: 1. Decompose your question into 3-5 targeted search queries 2. Search with different sort modes (likes for signal, recent for breaking) 3. Follow high-engagement threads for context 4. Check profiles of key accounts found in results 5. Add important accounts to watchlist for monitoring ## Search Operators Composio supports standard X search operators: - `"exact phrase"` — Match exact text - `from:username` — Tweets from a user - `-is:retweet` — Exclude retweets (added by default) - `-is:reply` — Exclude replies (use `--no-replies`) - `#hashtag` — Filter by hashtag - `has:links` — Only tweets with links - `lang:en` — Filter by language ## Examples ``` /x search "prediction markets" --sort likes --since 7d /x search "polymarket whale" --since 1d --limit 5 /x search "AI agents" --markdown /x profile polyaborat --count 10 /x thread 1234567890 --pages 3 /x watchlist add vitalikbuterin "ETH creator" /x watchlist check ``` ## Environment Variables - `COMPOSIO_API_KEY` — Your Composio API key (free tier available) - `COMPOSIO_CONNECTION_ID` — Your Composio X/Twitter connection ID Get both at https://composio.dev after connecting your X account.

Frequently asked questions

X Research