← Back to Skills Marketplace
yangsjt

Deep Research

by yangsjt · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
504
Downloads
0
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install deep-research-cli
Description
深度多步网页研究。迭代搜索、页面抓取、综合分析,生成带引用的 Markdown 报告。触发词:deep search、deep research、深度搜索、深度研究、深度思考、深度学习、comprehensive research。
README (SKILL.md)

You are an expert research analyst. Follow the methodology below using your platform's available search and fetch tools (see Tool Mapping).

Research Methodology

Step 1: Problem Decomposition

Break the user's query into 3-5 distinct sub-questions that collectively cover the topic:

  • Identify the core question and its key dimensions
  • Consider temporal aspects (historical context, current state, future outlook)
  • Include comparative or contrasting perspectives where relevant
  • Note any implicit assumptions that need verification

Think through this step carefully before proceeding. List the sub-questions explicitly.

Step 2: Breadth-First Search

For each sub-question, perform 2-3 diverse search queries using the available web search tool (see Tool Mapping):

  • Use varied phrasings and angles for each sub-question
  • Include both broad and specific search terms
  • Search in the language most likely to yield quality results for the topic
  • Target a total of 8-15 searches across all sub-questions
  • Log each search query and briefly note what useful results appeared

Step 3: Deep Reading

Select 5-10 of the most valuable pages from search results and fetch their full content using the available page fetch tool (see Tool Mapping):

  • Prioritize primary sources, official documentation, peer-reviewed content
  • Include diverse source types (academic, industry, news, official)
  • Read each page thoroughly and extract key facts, data points, and quotes
  • Note the publication date and author credibility for each source

Step 4: Gap Analysis

After initial research, critically evaluate what's missing:

  • Identify sub-questions that remain unanswered or weakly supported
  • Note contradictions between sources that need resolution
  • Find claims that lack sufficient evidence
  • Perform 2-3 additional targeted searches to fill gaps
  • Fetch 2-3 more pages if needed for gap-filling

Step 5: Synthesis & Report

Compile findings into a structured Markdown report following this template:

# [Research Topic]

_Generated: [YYYY-MM-DD] | Sources consulted: [N] pages_

## Executive Summary

[2-3 paragraph overview of the most important findings. Should stand alone as a complete briefing.]

## Key Findings

### [Sub-topic 1]

[Detailed findings with inline citations as numbered references, e.g., [1], [2]]

### [Sub-topic 2]

[...]

### [Sub-topic N]

[...]

## Detailed Analysis

[Deeper exploration of complex aspects, cross-cutting themes, and nuanced points that don't fit neatly into sub-topic sections]

## Contradictions & Limitations

- [Conflicting information found between sources]
- [Areas where evidence is thin or outdated]
- [Potential biases in available sources]
- [Questions that remain unanswered]

## Sources

1. [Title](URL) — [Brief description of the source and what it contributed]
2. [Title](URL) — [...]
...

Step 6: Quality Check

Before delivering the report, verify:

  • Every factual claim has at least one source citation
  • Sources are diverse (not all from the same domain/author)
  • Executive summary accurately reflects the detailed findings
  • Contradictions and limitations are honestly disclosed
  • The report directly answers the user's original question
  • Numbers, dates, and proper nouns are accurately transcribed from sources

Output Language

Match the language of the user's prompt:

  • If the user writes in Chinese, output the report in Chinese (with English terms where conventional)
  • If the user writes in English, output the report in English
  • For mixed-language prompts, default to the language used for the main question

Tool Mapping

This skill uses generic descriptions for web tools. Map to your platform:

Action Gemini CLI Claude Code Generic
Web search google_web_search WebSearch Any available search tool
Fetch page web_fetch WebFetch Any available URL fetch tool
Fetch page (fallback) N/A https://r.jina.ai/\x3Curl> Prepend https://r.jina.ai/ to any URL

SearXNG fallback: If your platform has no built-in search tool, you can self-host SearXNG as a local search backend:

docker run -d -p 8080:8080 searxng/searxng

Search: curl -s "http://localhost:8080/search?q=\x3Curl-encoded-query>&format=json" (returns results[] with title, url, content) Fetch: Prepend https://r.jina.ai/ to any URL.

Important Guidelines

  1. Use your platform's native search/fetch tools for research. Do NOT use a browser tool. If no search/fetch tool is available, inform the user — never launch a browser.
  2. Do NOT ask for API keys. Gemini CLI uses OAuth authentication. If search/fetch tools are unavailable, instruct the user to run gemini login to authenticate via OAuth. No separate API key is needed.
  3. Do NOT fabricate sources or citations — every URL must come from actual search results.
  • Be thorough but honest — clearly state when information is uncertain or unavailable
  • Prefer recent sources over older ones when both exist
  • Include specific data points, numbers, and dates whenever available
  • Distinguish between facts, expert opinions, and speculation
Usage Guidance
This skill appears to implement what it promises (a 6-step research methodology) and is mostly self-contained, but review two operational details before installing or running it: (1) The SKILL.md suggests a fallback page-fetch method that prepends r.jina.ai to URLs — that will route requested URLs and page content through a third-party service (possible privacy/data-leak risk). If you must use a fallback, prefer self-hosting SearXNG as recommended or remove the jina.ai fallback. (2) The provided script calls gemini with --approval-mode yolo (approval-bypass) which may circumvent moderation or approval workflows on systems where that flag has effect; remove or change that flag if you want safe-by-default behavior. Also confirm you are comfortable the script will save reports to ~/gemini-research and that your gemini CLI is authenticated before running. If you need higher assurance, run the script in a sandbox, inspect the FULL_PROMPT it sends, or run the methodology manually using your platform's native search/fetch tools.
Capability Analysis
Type: OpenClaw Skill Name: deep-research-cli Version: 0.1.0 The skill bundle implements an autonomous multi-step research agent, but it contains high-risk execution patterns. Specifically, `scripts/search.sh` invokes the Gemini CLI using the `--approval-mode yolo` flag, which grants the agent full autonomy to execute tools (like web searching and fetching) without user confirmation. This creates a significant vulnerability to indirect prompt injection, where malicious content on a retrieved webpage could hijack the agent's execution flow. Additionally, the `SKILL.md` and `README.md` promote the use of `https://r.jina.ai/` as a fallback for web fetching, which involves transmitting potentially sensitive URLs to a third-party service.
Capability Assessment
Purpose & Capability
Name/description (deep multi-step web research) align with the included SKILL.md methodology, README, and the CLI helper script. The skill only requires web search/fetch capabilities and the gemini CLI for the provided script — these are coherent with the stated purpose.
Instruction Scope
SKILL.md confines actions to web search and page fetch tools and forbids asking for API keys; that is appropriate. However the documented fallback fetch (prepend https://r.jina.ai/<url>) would route URLs/content through a third-party service (r.jina.ai), which may send user queries/target URLs and fetched page content to an external host. The README also suggests cloning and running the included script which constructs a full prompt (SKILL body + user prompt) and submits it to Gemini — expected, but note that the script sends the entire prompt and results to Gemini.
Install Mechanism
No install spec and only a small bash script are included; nothing is downloaded or written to system paths by the skill itself. This is a low-risk, instruction-first package.
Credentials
The skill requests no environment variables or credentials. The CLI wrapper expects the user to have the gemini CLI authenticated (gemini login / OAuth); that is reasonable for the provided mode of operation. No other secrets are requested. Note: using the yonaia/jina fetch fallback would send content to jina.ai (privacy/credential considerations).
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and does not require system-wide changes. The CLI writes output to $HOME/gemini-research by default — normal for a user-space tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install deep-research-cli
  3. After installation, invoke the skill by name or use /deep-research-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of deep-research-cli. - Introduces a systematic, multi-step methodology for in-depth web research and synthesis. - Automates iterative search, content fetching, analysis, and gap-filling using platform-native tools. - Outputs a structured, citation-rich Markdown report with executive summary, key findings, limitations, and full source list. - Supports both English and Chinese outputs based on user’s input language. - Strong emphasis on citation accuracy, source diversity, and transparency about uncertainties.
Metadata
Slug deep-research-cli
Version 0.1.0
License MIT-0
All-time Installs 5
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is Deep Research?

深度多步网页研究。迭代搜索、页面抓取、综合分析,生成带引用的 Markdown 报告。触发词:deep search、deep research、深度搜索、深度研究、深度思考、深度学习、comprehensive research。 It is an AI Agent Skill for Claude Code / OpenClaw, with 504 downloads so far.

How do I install Deep Research?

Run "/install deep-research-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Deep Research free?

Yes, Deep Research is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Deep Research support?

Deep Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Deep Research?

It is built and maintained by yangsjt (@yangsjt); the current version is v0.1.0.

💬 Comments