Agent skill

X Research

by alsk1992 in alsk1992/CloddsBot

X/Twitter research via Composio — search, threads, profiles, watchlists

MITAuto-check passedProductivity & Automation

Install X Research

skills CLI

$ npx skills add alsk1992/CloddsBot --skill x-research -a claude-code

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

GitHub CLI

$ gh skill install alsk1992/CloddsBot x-research --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/alsk1992/CloddsBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/bundled/x-research .claude/skills/x-research && 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/

Paste into Claude Code

Install the "x-research" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/x-research into .claude/skills/x-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-research", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/x-research

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill x-research -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot x-research --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/src/skills/bundled/x-research .agents/skills/x-research && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "x-research" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/x-research into .agents/skills/x-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-research", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill x-research -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot x-research --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/src/skills/bundled/x-research .cursor/skills/x-research && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "x-research" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/x-research into .cursor/skills/x-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-research", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/alsk1992/CloddsBot.git --path src/skills/bundled/x-research

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill x-research -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot x-research --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/src/skills/bundled/x-research .gemini/skills/x-research && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "x-research" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/x-research into .gemini/skills/x-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-research", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install alsk1992/CloddsBot x-research

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add alsk1992/CloddsBot --skill x-research -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .github/skills && cp -r skills-src/src/skills/bundled/x-research .github/skills/x-research && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "x-research" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/x-research into .github/skills/x-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-research", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add alsk1992/CloddsBot --skill x-research -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install alsk1992/CloddsBot x-research --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/src/skills/bundled/x-research .opencode/skills/x-research && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "x-research" agent skill from https://github.com/alsk1992/CloddsBot/tree/main/src/skills/bundled/x-research into .opencode/skills/x-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "x-research", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: x-research
GitHub stars: 2.9k
Token cost: ~700 tokens
SKILL.md length: 231 words
Files: 2
Skills in repo: 116
Repo updated: Oct 2, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

X/Twitter research via Composio — search, threads, profiles, watchlists

Works in 5 steps: Decompose your question into 3-5… → Search with different sort modes (likes… → Follow high-engagement threads for context → …
Tasks that involve App automation through connectors
SKILL.md covers Commands, Research Workflow, Search Operators and Examples, plus 1 more section
Runs TypeScript scripts from its folder; needs COMPOSIO_API_KEY

What it does

X Research is an agent skill from alsk1992/CloddsBot. X/Twitter research via Composio — search, threads, profiles, watchlists

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

It sits in Productivity & Automation, covering App automation through connectors and Social media posts. It works with X (Twitter) and Composio. The repository describes itself as: Open Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes… The licence is MIT.

When your agent uses it

Tasks that involve App automation through connectors
Tasks that involve Social media posts

Example prompts

“/x-research”

Requirements

Node.js
A credential in COMPOSIO_API_KEY

Workflow steps

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

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

What it can do on your machine

Read from SKILL.md and the folder at commit c930628. 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
Ships script files (TypeScript), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- composio.dev
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- COMPOSIO_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Research loads about 700 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 231 words of instructions outside code blocks.

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

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 alsk1992/CloddsBot at commit c930628, republished under its MIT licence (© alsk1992). 231 words, ~700 tokens.

Download SKILL.mdSave it as .claude/skills/x-research/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: x-research
description: X/Twitter research via Composio — search, threads, profiles, watchlists
emoji: 🐦
gates.envs: COMPOSIO_API_KEY, COMPOSIO_CONNECTION_ID

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.

Files

SKILL.md and 1 other file in src/skills/bundled/x-research of alsk1992/CloddsBot.

SKILL.md
index.ts

Open the folder on GitHubat commit c930628

Compare with similar skills

X Research 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.

X Research compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
X Research this skillalsk1992/CloddsBot	2.9k	—	~700	Automated safety check: Pass	MIT	7 days ago
Twitter Automationdavepoon/buildwithclaude	3.6k	7 repos	~2.3k	Automated safety check: Pass	MIT	today
X Post PublisherJimLiu/baoyu-skills	26k	1 repos	~4.4k	Automated safety check: Warn	MIT	29 days ago
X Bookmarkssharbelxyz/x-bookmarks	289	—	~2k	Automated safety check: Notes	None	7 mo ago
Composioyc-software/qm	15k	—	~1.6k	Automated safety check: Pass	MIT	today
Connect Apps with ComposioComposioHQ/awesome-claude-skills	77k	3 repos	~557	Automated safety check: Pass	None	21 days ago

Similar skills

Twitter Automation
davepoon/buildwithclaude
Automate Twitter/X tasks via Rube MCP (Composio): posts, search, users, bookmarks, lists, media.
3.6k GitHub starsUsed in 7 repos~2.3k tokens
Productivity & AutomationAuto-check passed
X Post Publisher
JimLiu/baoyu-skills
Publishes text posts, images, videos, quote posts and long-form X Articles written in Markdown through a real Chrome browser.
26k GitHub starsUsed in 1 repo~4.4k tokens
Productivity & AutomationAuto-check: warnings
X Bookmarks
sharbelxyz/x-bookmarks
Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2.
289 GitHub stars~2k tokensUpdated 7 mo ago
Productivity & AutomationAuto-check: notes
Composio
yc-software/qm
Show the app connection picker or setup widget when users ask to connect apps, reopen setup, or need an app that isn't connected yet.
15k GitHub stars~1.6k tokensUpdated today
Productivity & AutomationAuto-check passed
Connect Apps with Composio
ComposioHQ/awesome-claude-skills
Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.
77k GitHub starsUsed in 3 repos~557 tokens
Productivity & AutomationAuto-check passed
Abuselpdb Automation
ComposioHQ/awesome-claude-skills
Automate Abuselpdb tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.
77k GitHub starsUsed in 3 repos~738 tokens
Productivity & AutomationAuto-check passed

Questions about X Research

What does X Research do?

X/Twitter research via Composio — search, threads, profiles, watchlists. X Research is an agent skill from alsk1992/CloddsBot.

When should I use X Research?

X Research fits situations like: tasks that involve App automation through connectors; tasks that involve Social media posts.

How do I install X Research in Claude Code?

Run `npx skills add alsk1992/CloddsBot --skill x-research -a claude-code`. Or copy the skill folder (src/skills/bundled/x-research in alsk1992/CloddsBot) into .claude/skills/x-research in your project. Claude Code loads it when a task matches its description.

How do I install X Research in Codex?

Run `npx skills add alsk1992/CloddsBot --skill x-research -a codex`. Or copy the skill folder (src/skills/bundled/x-research in alsk1992/CloddsBot) into .agents/skills/x-research in your project. Codex loads it when a task matches its description.

Can I use X Research 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 alsk1992/CloddsBot --skill x-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-research, .gemini/skills/x-research, .github/skills/x-research and .opencode/skills/x-research in your project.

What does X Research need to run?

Going by SKILL.md and its folder, X Research needs TypeScript for the scripts in its folder and credentials named COMPOSIO_API_KEY. Our summary lists: Node.js; A credential in COMPOSIO_API_KEY.

Does X Research access the network?

SKILL.md names 1 domain. As links in the text: composio.dev. This is read from the text; nothing was executed.

Is X Research 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 X Research use?

X Research 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 X Research use?

About 700 tokens (SKILL.md is roughly 2.8k 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 X Research?

Skills that share tags, products or a category with X Research: Twitter Automation (davepoon/buildwithclaude, 3.6k stars), X Post Publisher (JimLiu/baoyu-skills, 26k stars), X Bookmarks (sharbelxyz/x-bookmarks, 289 stars) and Composio (yc-software/qm, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Research?

alsk1992 (a GitHub user) maintains it in alsk1992/CloddsBot, which has 2,933 GitHub stars. The repository holds 116 skills in this directory. The repository was last updated on October 2, 2026.

Source: alsk1992/CloddsBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install X Research

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

X Research Skill

Commands

Search

Profile

Thread

Single Tweet

Cache

Watchlist

Research Workflow

Search Operators

Examples

Environment Variables

Files

Compare with similar skills

Similar skills

More from alsk1992/CloddsBot

Related

Questions about X Research