x-research · postplusai — Claude Code skill: X research routes and setup
x-research — a skill that turns a question about public X posts, threads, replies or accounts into a bounded research run. Handy when a marketing or product call needs evidence.
no license 284 installs ★ 26 updated 2026-10-22
npx skills add PostPlusAI/postplus-skills --skill x-research -a claude-codeWhat x-research does
The skill takes over when a request needs public X material: posts, threads, replies, accounts. A routing table inside points the agent at a single reference file — account or competitor audit, post formats, audience wording, creator search, campaign scouting, market comparison. Only that one file gets read.
Collection runs through the postplus CLI. postplus doctor --skill x-research checks readiness, postplus research run x-posts pulls posts for a query or a direct link, x-profiles returns facts on a handle you already know, and x-user-search recalls handles by keyword. A run that stopped mid-way continues with --resume-from and its checkpoint file.
Private accounts, DMs, hidden analytics and ad spend fall outside the public scope, so the skill stops and asks for a supported one. Each run spends PostPlus credits: with no CLI installed or an empty balance, nothing executes. Visible post metrics are observations and do not stand for reach or conversion.
What it helps with
- pull audience phrasing out of public replies
- benchmark a competitor's posts against your own by topic and format
- shortlist creators in a niche for a collaboration
- check how a launch reads in another language
- collect post examples for a hashtag campaign
Example prompts for the agent
- Pull public posts for
ai coding agentswithpostplus research run x-postsand show the three formats that keep repeating. - Walk through the replies on the competitor thread and list the objections people raise.
- Compare the wording German and English posts use for the same topic.
How to install x-research
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill x-research -a claude-code2Manually: put the files in place
~/.claude/skills/x-research/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/x-research/
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill x-research -a codex2Manually: put the files in place
.agents/skills/x-research/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill x-research -a cursor2Manually: put the files in place
.cursor/skills/x-research/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostPlusAI/postplus-skills skills/20-research/x-research2Manually: put the files in place
.github/skills/x-research/SKILL.md1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill x-research -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/20-research/x-researchManually: put the files in place
.devin/skills/x-research/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill x-research -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about x-research
How do I install x-research in Claude Code?
Run npx skills add PostPlusAI/postplus-skills --skill x-research -a claude-code. The skill lands at ~/.claude/skills/x-research/SKILL.md.
What does x-research do?
It maps your question to one public-X research route, runs a narrow collection through the postplus CLI, then reports the evidence with links and the limits of the sample.
What is out of scope for the skill?
Private accounts, direct messages, hidden analytics, the full follower graph and ad spend data. For those it asks you to restate the request inside the public boundary.
What has to be in place before a run?
The postplus CLI plus credits on the account. postplus doctor --skill x-research reports readiness, and estimate-only requests do not execute anything.
Similar skills
All skills for Marketing and content →x-research by other authors comes first.