auto-researcher

auto-researcher is a skill for Claude Code, Codex from xyva-yuangui/XyvaClaw. It costs 4 tokens per session (2,131 once invoked), scanned A, original, MIT.

A research assistant that takes a topic, searches for information in several rounds, checks sources against each other, and produces a report. It can work in multiple languages and save research sessions for later.

In plain words
What is it for?
Use it to research markets, technology, strategies, or other subjects and export the results as Markdown, HTML, PDF, or a Feishu document.
Why use it?
It removes the need to manually break down a topic, search repeatedly, compare sources, and assemble findings. You still confirm before it starts.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw.

Good fit Use it to research markets, technology, strategies, or other subjects and export the results as Markdown, HTML, PDF, or a Feishu document.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xyva-yuangui/xyvaclaw/auto-researcher
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add xyva-yuangui/XyvaClaw --skill auto-researcher
Clone the repo
git clone --depth 1 https://github.com/xyva-yuangui/XyvaClaw

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for auto-researcher

README.md
[![agentmods](https://agentmods.dev/badge/skills/xyva-yuangui/xyvaclaw/auto-researcher/github.svg)](https://agentmods.dev/skills/xyva-yuangui/xyvaclaw/auto-researcher)
Your own site
<a href="https://agentmods.dev/skills/xyva-yuangui/xyvaclaw/auto-researcher"><img src="https://agentmods.dev/badge/skills/xyva-yuangui/xyvaclaw/auto-researcher/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for auto-researcher

Your own site · 80×15
<a href="https://agentmods.dev/skills/xyva-yuangui/xyvaclaw/auto-researcher"><img src="https://agentmods.dev/badge/skills/xyva-yuangui/xyvaclaw/auto-researcher.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,131 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00004 $0.02131
Opus 5 $0.00002 $0.01066
Sonnet 5 $0.00001 $0.00426
Haiku 4.5 $0.00000 $0.00213

Measured 12d ago against content hash 1021baac1222, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

auto-researcher scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/check.py, scripts/researcher.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

config-base/workspace/skills/auto-researcher/SKILL.md · 249 lines

How it starts

The opening of the file, as written. The whole thing — 249 lines — stays where its author put it; the contents beside it link to each section on GitHub.

🔬 🔬 Auto Researcher 🔬

重要: 触发后必须先询问用户确认,再执行操作。

重要: 触发后必须先询问用户确认,再执行操作。

全自动深度研究引擎:给定主题,自动完成从信息搜集到报告输出的全流程。

核心流程

主题输入 → 问题分解 → 多轮搜索 → 信息提取 → 交叉验证 → 知识入库 → 报告生成
    ↑                                                              |
    └──────────────── 发现子问题,自动追问 ←────────────────────────┘

🔬 🔬 # 快速开始

# 基础研究
python3 scripts/researcher.py --topic "2026年中国新能源汽车市场竞争格局"

# 深度研究(更多轮次、更多来源)
python3 scripts/researcher.py --topic "AI Agent 架构演进" --depth deep

# 指定输出格式
python3 scripts/researcher.py --topic "量化选股策略对比" --format feishu-doc

# 中英文混合研究
python3 scripts/researcher.py --topic "全球半导体供应链风险" --langs "zh,en"

# 恢复中断的研究
python3 scripts/researcher.py --resume session-20260305-abc123

参数

参数 说明 默认值
--topic 研究主题 必填
--depth 研究深度: quick/standard/deep standard
--format 输出格式: markdown/html/feishu-doc/pdf markdown
--langs 搜索语言 zh,en
--max-rounds 最大搜索轮次 5 (deep=10)
--max-sources 最大信息源数量 20 (deep=50)
--output 输出目录 ./output/research/
--resume 恢复之前的研究会话 -
--check 健康检查 -

🔬 🔬 # 研究深度对比

维度 quick (5min) standard (15min) deep (30min+)
搜索轮次 1-2 3-5 5-10
信息源 5-10 10-20 20-50
交叉验证 基础 标准 严格+多语言
子问题追问 1 层 2-3 层递归
报告字数 500-1000 2000-5000 5000-15000
图表 1-2 张 3-5 张

🔬 🔬 # 研究流程详解

Step 1: 问题分解

原始主题: "2026年中国新能源汽车市场竞争格局"
    ↓
子问题:
├── Q1: 2026年中国新能源汽车销量和市场份额数据?
├── Q2: 主要竞争者(比亚迪/特斯拉/蔚来...)最新动态?
├── Q3: 政策环境变化(补贴/碳积分/出口)?
├── Q4: 技术趋势(固态电池/智驾/充电)?
└── Q5: 海外市场拓展情况?

使用 deep-reasoning-chain 进行问题拆解,确保覆盖全面。

Step 2: 多轮搜索

每个子问题独立搜索,使用 multi-search-engine 多引擎并行:

Q1 → Google + Bing + 百度 → 结果集 R1
Q2 → Google + Reddit + 微信搜索 → 结果集 R2
Q3 → Google + 政府网站 → 结果集 R3
...

搜索策略:

  • 每个子问题生成 3-5 个不同角度的搜索词
  • 中英文同时搜索(--langs 控制)
  • 自动过滤低质量来源(广告、SEO 垃圾)
  • 优先权威来源(政府、学术、行业报告)

Read the full file on GitHub · 249 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 249 lines · 4 tokens per session scan A 1021baac1222

Subscribe to this mod's changes

auto-researcher is a skill published in the GitHub repository xyva-yuangui/XyvaClaw (21 stars, last pushed 1mo ago), licensed MIT. It adds 4 tokens to every session and 2,131 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

imap-smtp-email

Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes, mark as read/unread, and send emails with attachments. Works with any IMAP/SMTP server including Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, and vip.188.com.

netease-youdao/LobsterAI · 82 tokens

technology-search

Search tech blogs, developer forums, and IT media (TechCrunch, Hacker News, 36氪, etc.) for software and hardware industry updates with heat ranking and EN↔CN translation. Use this skill only when the topic is clearly about programming, software, hardware, AI, or IT infrastructure.

netease-youdao/LobsterAI · 65 tokens

develop-web-game

Use when Codex is building or iterating on a web game (HTML/JS) and needs a reliable development + testing loop: implement small changes, run a Playwright-based test script with short input bursts and intentional pauses, inspect screenshots/text, and review console errors with rendergametotext.

netease-youdao/LobsterAI · 64 tokens

article-writer

Multi-style article creation skill. Supports 5 writing styles (deep analysis, practical guide, story-driven, opinion, news brief), including complete workflow: material collection → outline → content → formatting. Activated when users mention "write article", "write post", "create", or "draft".

netease-youdao/LobsterAI · 62 tokens

skin-creator

Create and apply a two-asset LobsterAI visual skin from the user's style description. Use only when the AI Skin Designer kit supplies the structured skinpack workflow marker; do not use for ordinary theme or image requests.

netease-youdao/LobsterAI · 48 tokens

content-planner

WeChat Official Account topic planning and content calendar management. Based on WeChat article search and trending analysis, generates differentiated topic recommendations and outputs structured content calendars. Activated when users mention "topic", "planning", "content calendar", "trending", or "what to write next…

netease-youdao/LobsterAI · 63 tokens