Agent skill

X Research

by minicoohei in minicoohei/ai-agent-camp

X (Twitter) のリアルタイム検索を行い、トピックに関するツイートを収集・分析する. An agent skill from minicoohei/ai-agent-camp.

No licenceAuto-check: notes

Install X Research

skills CLI
$ npx skills add minicoohei/ai-agent-camp --skill x-research -a claude-code

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

GitHub CLI
$ gh skill install minicoohei/ai-agent-camp 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/minicoohei/ai-agent-camp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/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/

Facts

Skill name
x-research
GitHub stars
347
Token cost
~1.1k tokens
SKILL.md length
211 words
Files
5 (incl. scripts)
Skills in repo
37
Repo updated
First seen
Licence
None found

At a glance

X (Twitter) のリアルタイム検索を行い、トピックに関するツイートを収集・分析する. An agent skill from minicoohei/ai-agent-camp.

  • Works in 3 steps: {topic}_report.md - Markdown レポート → {topic}_data.json - 構造化 JSON → {topic}_raw.txt - プレーンテキスト要約
  • SKILL.md covers Description, クイックスタート, Parameters and クエリ構文ガイド, plus 5 more sections
  • Runs Python scripts from its folder; calls python; needs X_BEARER_TOKEN

What it does

X Research is an agent skill from minicoohei/ai-agent-camp. X (Twitter) のリアルタイム検索を行い、トピックに関するツイートを収集・分析する。 検索結果を構造化レポート(Markdown + JSON + TXT)として出力。 「Xで検索して」「Twitterで調べて」「ツイートを分析」等で発動。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `SKILL.en.md`, `SKILL.es.md` and `agents/openai.yaml`).

It works with X (Twitter). The repository describes itself as: AI Agent Camp — non-engineer-friendly AI agent training curriculum. Lessons, skills, commands, and hooks for Claude Code, Cursor, and Codex.

Example prompts

  • “/x-research”

Requirements

  • Python 3
  • A credential in X_BEARER_TOKEN

Workflow steps

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

  1. {topic}_report.md - Markdown レポート
  2. {topic}_data.json - 構造化 JSON
  3. {topic}_raw.txt - プレーンテキスト要約

What it can do on your machine

Read from SKILL.md and the folder at commit 048ba4c. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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):

    • developer.x.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • X_BEARER_TOKEN

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

Context cost

X Research loads about 1.1k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 211 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:132
    # .env に追加
  • NoteMentions a .env fileSKILL.md:140
    4. `.env` ファイルに `X_BEARER_TOKEN=...` を追加

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 211 words (~1,069 tokens).

“X API v2 Recent Search エンドポイントを使用して、指定トピックに関するリアルタイムのツイートを検索・収集・分析します。 取得したツイートをエンゲージメント順にランキングし、ハッシュタグ分析・時系列分布・共有URL一覧を含む構造化レポートを Markdown + JSON + プレーンテキストの3形式で出力します。”

— opening of SKILL.md by minicoohei
name
x-research
version
1.0.0
author
ai-agent-camp
triggers
Xで検索して, Twitterで調べて, ツイートを分析, X上の反応を調べて, SNSリサーチ, トレンドを調査, x-research, search tweets
dependencies
requests>=2.28.0, python-dotenv>=0.19.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts) in skills/x-research of minicoohei/ai-agent-camp.

  • SKILL.md
  • SKILL.en.md
  • SKILL.es.md
  • agents/openai.yaml
  • scripts/x_research.py

Open the folder on GitHubat commit 048ba4c

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Research this skillminicoohei/ai-agent-camp347—~1.1kAutomated safety check: NotesNone
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-Reach95k—~1.4kAutomated safety check: PassMIT
X to Markdown ConverterJimLiu/baoyu-skills27k4 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.

    95k GitHub stars~1.4k tokensUpdated 2 days ago
    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.

    27k 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.

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

More from minicoohei/ai-agent-camp

All 37 skills in this repo
  • Exploratory Data Analysis

    minicoohei/ai-agent-camp

    200以上のファイル形式に対応した探索的データ分析(EDA)スキル. An agent skill from minicoohei/ai-agent-camp.

    347 GitHub stars~3.5k tokensUpdated 3 days ago
    Auto-check passed
  • Content Optimizer

    minicoohei/ai-agent-camp

    コンテンツのA/Bテスト・自己改善ループを支援するプランナースキル. An agent skill from minicoohei/ai-agent-camp.

    347 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check: notes
  • Video Editor

    minicoohei/ai-agent-camp

    TikTok/YouTube向け動画編集スキル。ffmpegでキャプション焼き込み、 Ken Burnsエフェクト、シーン結合、音声合成を行う。

    347 GitHub stars~756 tokensUpdated 3 days ago
    Auto-check passed
  • Article Writer

    minicoohei/ai-agent-camp

    テーマからアウトライン生成→文体プロファイル適用→Markdown記事出力を行う記事執筆スキル. An agent skill from minicoohei/ai-agent-camp.

    347 GitHub stars~990 tokensUpdated 3 days ago
    Auto-check passed
  • Banner Creator

    minicoohei/ai-agent-camp

    各種SNS・広告プラットフォーム向けのバナー/クリエイティブを生成するスキル. An agent skill from minicoohei/ai-agent-camp.

    347 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Check Inbox

    minicoohei/ai-agent-camp

    メールとSlackから返信すべき項目・タスクを抽出する統合型スキル. An agent skill from minicoohei/ai-agent-camp.

    347 GitHub stars~870 tokensUpdated 3 days ago
    Auto-check: notes

Works with

Questions about X Research

What does X Research do?

X (Twitter) のリアルタイム検索を行い、トピックに関するツイートを収集・分析する. An agent skill from minicoohei/ai-agent-camp. X Research is an agent skill from minicoohei/ai-agent-camp.

How do I install X Research in Claude Code?

Run `npx skills add minicoohei/ai-agent-camp --skill x-research -a claude-code`. Or copy the skill folder (skills/x-research in minicoohei/ai-agent-camp) 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 minicoohei/ai-agent-camp --skill x-research -a codex`. Or copy the skill folder (skills/x-research in minicoohei/ai-agent-camp) 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 minicoohei/ai-agent-camp --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 Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named X_BEARER_TOKEN. Our summary lists: Python 3; A credential in X_BEARER_TOKEN.

Does X Research access the network?

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

Is X Research safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does X Research use?

No licence was found for X Research or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does X Research use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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: Social (coreyhaines31/marketingskills, 54k stars), Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 134k stars), Agent Reach (Panniantong/Agent-Reach, 95k stars) and X to Markdown Converter (JimLiu/baoyu-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Research?

minicoohei (a GitHub user) maintains it in minicoohei/ai-agent-camp, which has 347 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 7, 2026.

Source: minicoohei/ai-agent-camp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.