# x-research

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 284 installs · ★ 26 repo stars
- Author: PostPlusAI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/20-research/x-research/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/postplusai-x-research

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill x-research -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/x-research/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/x-research/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill x-research -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/x-research/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill x-research -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/x-research/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostPlusAI/postplus-skills skills/20-research/x-research
```

2. **Manually: put the files in place**
- File: `.github/skills/x-research/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill x-research -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/20-research/x-research
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/x-research/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill x-research -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/20-research/x-research/SKILL.md

## When to use it
- 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
- Pull public posts for `ai coding agents` with `postplus research run x-posts` and 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.

## Similar
- [audience-research](https://affpapa.org/en/nevibecode/skills/james-dickerson-at-boringmarke-audience-research.md) — skill · ★ 778 repo stars
- [keyword-research](https://affpapa.org/en/nevibecode/skills/keyword-research-2.md) — skill · 1600 installs
- [audience-mapper](https://affpapa.org/en/nevibecode/skills/audience-mapper.md) — skill · 1200 installs
- [extracting-youtube-comments-for-research](https://affpapa.org/en/nevibecode/skills/extracting-youtube-comments-for-research.md) — skill · 942 installs
- [customer-research](https://affpapa.org/en/nevibecode/skills/customer-research.md) — skill · 128400 installs
- [research-sources](https://affpapa.org/en/nevibecode/skills/research-sources.md) — skill · 1100 installs

## Other versions with the same name
- [x-research · bradautomates](https://affpapa.org/en/nevibecode/skills/bradautomates-x-research.md) — 286 installs
- [x-research · trailofbits](https://affpapa.org/en/nevibecode/skills/x-research.md) — ★ 540 repo stars

From the same set: [postplusai/postplus-skills](https://affpapa.org/en/nevibecode/by/postplusai/postplus-skills.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
