Agent skill

Deep X Research

by w-winter in w-winter/dot314

Deep, exhaustive research on a topic across X (Twitter) by driving Grok (x.com/i/grok) through surf.

MITAuto-check passed

Install Deep X Research

skills CLI
$ npx skills add w-winter/dot314 --skill deep-x-research -a claude-code

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

GitHub CLI
$ gh skill install w-winter/dot314 deep-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/w-winter/dot314.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/deep-x-research .claude/skills/deep-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/

Facts

Skill name
deep-x-research
GitHub stars
139
Token cost
~1.4k tokens
SKILL.md length
554 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Deep, exhaustive research on a topic across X (Twitter) by driving Grok (x.com/i/grok) through surf.

  • Works in 6 steps: Decompose the topic and budget the queries → Grok sweep → Video pass (visual topics) → …
  • The user wants comprehensive X research on a concept
  • SKILL.md covers Steps, Fallback: direct search when… and Troubleshooting
  • Reaches x.com and video.twimg.com

What it does

Deep X Research is an agent skill from w-winter/dot314. Deep, exhaustive research on a topic across X (Twitter) by driving Grok (x.com/i/grok) through surf. Use when the user wants comprehensive X research on a concept, technique, trend, tool, or creator scene; needs categorized findings with every claim traceable to post URLs; or when a single Grok query is not enough.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with X (Twitter). The licence is MIT.

When your agent uses it

  • The user wants comprehensive X research on a concept
  • Needs categorized findings with every claim traceable to post URLs
  • A single Grok query is not enough

Example prompts

  • “/deep-x-research”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Decompose the topic and budget the queries
  2. Grok sweep
  3. Video pass (visual topics)
  4. Enrich and verify — quota-free
  5. Categorize and analyze
  6. Report with full traceability

What it can do on your machine

Read from SKILL.md and the folder at commit 0c6bbc7. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • x.com
    • video.twimg.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deep X Research loads about 1.4k tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 554 words of instructions outside code blocks.

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

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 w-winter/dot314 at commit 0c6bbc7, republished under its MIT licence (© w-winter). 554 words, ~1,386 tokens.

Download SKILL.mdSave it as .claude/skills/deep-x-research/SKILL.md (or your agent's skills folder).
name
deep-x-research
description
Deep, exhaustive research on a topic across X (Twitter) by driving Grok (x.com/i/grok) through surf. Use when the user wants comprehensive X research on a concept, technique, trend, tool, or creator scene; needs categorized findings with every claim traceable to post URLs; or when a single Grok query is not enough.
disable-model-invocation
true

Deep X Research

Research a topic across X by putting Grok to work from multiple angles — it runs keyword and semantic X searches and watches videos natively — then deliver categorized findings where every claim is traceable to a post URL.

Requires: surf installed and connected (surf doctor), Chrome logged into x.com. Command reference: the surf skill or surf --help.

Quota: X caps Grok requests (typically 15 per 20 hours on a standard plan). Every surf grok call spends one. Budget the session before the first query and make each query do multi-angle work — never spend a request on what a quota-free step can answer.

Steps

1. Decompose the topic and budget the queries

Break the topic into angles: showcases/examples, techniques & tutorials, tools, notable creators, community discussion — adapt to the topic. Plan a Grok budget of 4-8 queries covering every angle (combine related angles into one query rather than spending two). Done when each angle is assigned to a budgeted query.

2. Grok sweep

Run the budgeted queries sequentially. Engineer each so Grok does the fan-out internally and returns traceable sources:

bash
# Broad pass — force multi-angle search and URLs
surf grok "Do deep research on TOPIC on X. Search both latest and top posts, keyword and semantic. Return the most relevant posts with full post URLs (x.com/user/status/ID) and a one-line description of each."

# Focused passes — one per remaining angle group
surf grok "TOPIC on X: tutorials, techniques, and the tools people use. Include post URLs for every example."

# Deepest pass — spend DeepSearch on the highest-value angle
surf grok "TOPIC: notable creators, how the trend is evolving, and the standout posts of the last 6 months. Post URLs required." --deep-search

Record every post Grok cites: author, one-line gist, full https://x.com/USER/status/ID URL. If a response gives claims without URLs, the next query in the budget re-asks for sources — never leave an angle sourceless. Done when every planned angle has been queried and the final response adds no new relevant posts, or the budget is spent.

3. Video pass (visual topics)

When the topic involves video, editing, or visual style, spend 1-3 budgeted queries having Grok analyze the strongest video posts — it can watch X videos natively:

bash
surf grok "Analyze the videos in these posts: URL1 URL2 URL3 — for each, describe the techniques, pacing, and style, and why it works."

Batch several URLs per query to conserve budget. Done when each analyzed video has notes on what it shows and why it matters for the topic.

4. Enrich and verify — quota-free

For each cited post, open it directly with surf (no Grok spend) to verify the URL resolves and harvest detail Grok didn't give:

bash
surf navigate "https://x.com/USER/status/ID" && surf wait 2
surf page.read --compact          # engagement numbers, thread context
surf network | grep video.twimg   # direct video URL after playback

Done when every URL destined for the References section has been resolved (dead or hallucinated links dropped or replaced).

Show full SKILL.md (216 more words)Show less
5. Categorize and analyze

Group findings into categories that fit the topic. Extract trends: momentum on X, recurring techniques, notable creators, how the topic is evolving. Done when every recorded post is either placed in a category or deliberately dropped as irrelevant.

6. Report with full traceability
md
# Deep Research on [Topic]

## Summary
[2-4 paragraphs: state of the topic on X]

## Key Trends
- ...

## Categorized Findings
### [Category]
- [Finding with inline post reference]

## Notable Creators & Techniques
- ...

## References
1. [Author — one-line description]
   https://x.com/USER/status/ID
   Video: https://video.twimg.com/... (when captured)

The report is done when every post mentioned anywhere in it appears in References with its full, verified URL — no bare @handles, no "a viral post showed…" without a link.

Fallback: direct search when the Grok quota is exhausted

The x.com search UI costs no Grok requests. Slower and keyword-only, but it keeps the sweep going:

bash
surf navigate "https://x.com/search?q=QUERY&f=live" && surf wait 3   # Latest
surf page.read --compact
surf scroll down 2000    # then page.read again — repeat to load more

Modes via the f= param: Top is the default (no f param) — there is no f=top; f=live = Latest, f=user = People, f=media = Media. Operators compose into the URL-encoded q=: "exact phrase", filter:videos, min_faves:100, min_retweets:50, from:user, since:2026-01-01, until:2026-06-01.

Troubleshooting

  • Grok replies with a rate-limit message → quota exhausted; switch to the fallback sweep and tell the user when the quota resets.
  • Grok queries fail outright → surf grok --validate, then retry with a model from the validation output (see the surf skill's AI troubleshooting section).
  • Grok cites posts without URLs → re-ask in the next budgeted query; do not invent URLs.
  • Search page shows a login wall → Chrome isn't logged into x.com; ask the user to log in.

© w-winter, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/deep-x-research of w-winter/dot314.

Open the folder on GitHubat commit 0c6bbc7

Compare with similar skills

Deep 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.

Deep X Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep X Research this skillw-winter/dot314139—~1.4kAutomated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Banner Design Systemnextlevelbuilder/ui-ux-pro-max-skill134k1 repos~1.8kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach94k—~1.4kAutomated safety check: PassMIT
X to Markdown ConverterJimLiu/baoyu-skills26k4 repos~1.8kAutomated safety check: WarnMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    134k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    94k GitHub stars~1.4k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • X to Markdown Converter

    JimLiu/baoyu-skills

    Saves tweets, threads and X Articles as Markdown files with YAML front matter, using an unofficial API that asks for your consent first.

    26k GitHub starsUsed in 4 repos~1.8k tokens
    Knowledge ManagementAuto-check: warnings
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed
  • X Article Publisher

    wshuyi/x-article-publisher-skill

    Publish Markdown articles to X (Twitter) Articles editor with proper formatting.

    871 GitHub starsUsed in 2 repos~3.6k tokens
    Documents & OfficeAuto-check passed

More from w-winter/dot314

  • Refresh RepoPrompt tool guidance when the CLI/MCP surface changes.

    139 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Text Search

    w-winter/dot314

    Search indexed text corpora with qmd. An agent skill from w-winter/dot314.

    139 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Prose Review

    w-winter/dot314

    Review prose written for others (e.g., user-facing documentation, prompts for other LLMs, reports, plans, inline comments, docstrings) for local jargon leakage, orphaned references, missing…

    139 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Rp

    w-winter/dot314

    Always read this skill when the user mentions "rp" or "repoprompt", or before accessing a repository outside the current RepoPrompt workspace.

    139 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Surf

    w-winter/dot314

    Control Chrome browser via CLI for testing, automation, and debugging.

    139 GitHub stars~7.6k tokensUpdated 2 days ago
    Auto-check: warnings
  • Xcodebuildmcp

    w-winter/dot314

    Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support).

    139 GitHub stars~196 tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Deep X Research

What does Deep X Research do?

Deep, exhaustive research on a topic across X (Twitter) by driving Grok (x.com/i/grok) through surf. Deep X Research is an agent skill from w-winter/dot314.com/i/grok) through surf.

When should I use Deep X Research?

Deep X Research fits situations like: the user wants comprehensive X research on a concept; needs categorized findings with every claim traceable to post URLs; A single Grok query is not enough.

How do I install Deep X Research in Claude Code?

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

How do I install Deep X Research in Codex?

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

Can I use Deep 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 w-winter/dot314 --skill deep-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/deep-x-research, .gemini/skills/deep-x-research, .github/skills/deep-x-research and .opencode/skills/deep-x-research in your project.

What does Deep X Research need to run?

SKILL.md names no scripts, command-line tools or credentials: Deep X Research is instructions for the agent only.

Does Deep X Research access the network?

SKILL.md names 2 domains. In commands or code: x.com and video.twimg.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

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

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

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

Skills that share tags, products or a category with Deep X Research: Social (coreyhaines31/marketingskills, 54k stars), Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 134k stars), Agent Reach (Panniantong/Agent-Reach, 94k stars) and X to Markdown Converter (JimLiu/baoyu-skills, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep X Research?

w-winter (a GitHub user) maintains it in w-winter/dot314, which has 139 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

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