Agent skill

Research Deep

by Weizhena in Weizhena/Deep-Research-skills

读取调研outline,为每个item启动独立agent进行深度调研。禁用task output. An agent skill from Weizhena/Deep-Research-skills.

MITAuto-check: notesResearch & Science

Install Research Deep

skills CLI
$ npx skills add Weizhena/Deep-Research-skills --skill research-deep -a claude-code

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

GitHub CLI
$ gh skill install Weizhena/Deep-Research-skills research-deep --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/Weizhena/Deep-Research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-zh/research-deep .claude/skills/research-deep && 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
research-deep
GitHub stars
2.3k
Used in
1 other repo
Token cost
~521 tokens
SKILL.md length
64 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

读取调研outline,为每个item启动独立agent进行深度调研。禁用task output. An agent skill from Weizhena/Deep-Research-skills.

  • Works in 5 steps: 自动定位Outline → 断点续传检查 → 分批执行 → …
  • Research & Science work in your project
  • SKILL.md covers 触发方式, 执行流程 and Agent配置
  • Calls python

What it does

Research Deep is an agent skill from Weizhena/Deep-Research-skills. 读取调研outline,为每个item启动独立agent进行深度调研。禁用task output。

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

It sits in Research & Science. The repository describes itself as: Structured deep research skill for Claude Code/Open Code/Codex with human-in-the-loop control. The licence is MIT.

When your agent uses it

  • Research & Science work in your project

Example prompts

  • “/research-deep”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash, Read, Write, Glob, WebSearch, Task

Workflow steps

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

  1. 自动定位Outline
  2. 断点续传检查
  3. 分批执行
  4. 等待与监控
  5. 汇总报告

What it can do on your machine

Read from SKILL.md and the folder at commit 6ce38f6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Glob
    • WebSearch
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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

Research Deep loads about 521 tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 64 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Glob, WebSearch, Task

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 Weizhena/Deep-Research-skills at commit 6ce38f6, republished under its MIT licence (© Weizhena). 64 words, ~521 tokens.

Download SKILL.mdSave it as .claude/skills/research-deep/SKILL.md (or your agent's skills folder).
name
research-deep
description
读取调研outline,为每个item启动独立agent进行深度调研。禁用task output。
allowed-tools
Bash, Read, Write, Glob, WebSearch, Task
user-invocable
true

Research Deep - 深度调研

触发方式

/research-deep

执行流程

Step 1: 自动定位Outline

在当前工作目录查找 */outline.yaml 文件,读取items列表、execution配置(含items_per_agent)。

Step 2: 断点续传检查
  • 检查output_dir下已完成的JSON文件
  • 跳过已完成的items
Step 3: 分批执行
  • 按batch_size分批(完成一批需要得到用户同意才可进行下一批)
  • 每个agent负责items_per_agent个项目
  • 启动web-search-agent(后台并行,禁用task output)

参数获取:

  • {topic}: outline.yaml中的topic字段
  • {item_name}: item的name字段
  • {item_related_info}: item的完整yaml内容(name + category + description等)
  • {output_dir}: outline.yaml中execution.output_dir(默认./results)
  • {fields_path}: {topic}/fields.yaml的绝对路径
  • {output_path}: {output_dir}/{item_name_slug}.json的绝对路径(slugify处理item_name:空格替换为_,移除特殊字符)

硬约束:以下prompt必须严格复述,仅替换{xxx}中的变量,禁止改写结构或措辞。

Prompt模板:

python
prompt = f"""## 任务
调研 {item_related_info},输出结构化JSON到 {output_path}

## 字段定义
读取 {fields_path} 获取所有字段定义

## 输出要求
1. 按fields.yaml定义的字段输出JSON
2. 不确定的字段值标注[不确定]
3. JSON末尾添加uncertain数组,列出所有不确定的字段名
4. 所有字段值必须使用中文输出(调研过程可用英文,但最终JSON值为中文)

## 输出路径
{output_path}

## 验证
完成JSON输出后,运行验证脚本确保字段完整覆盖:
python ~/.claude/skills/research/validate_json.py -f {fields_path} -j {output_path}
验证通过后才算完成任务。
"""

One-shot示例(假设调研GitHub Copilot):

## 任务
调研 name: GitHub Copilot
category: 国际产品
description: Microsoft/GitHub开发,首个主流AI编程助手,市场份额约40%,输出结构化JSON到 {project_dir}/results/GitHub_Copilot.json

## 字段定义
读取 {project_dir}/fields.yaml 获取所有字段定义

## 输出要求
1. 按fields.yaml定义的字段输出JSON
2. 不确定的字段值标注[不确定]
3. JSON末尾添加uncertain数组,列出所有不确定的字段名
4. 所有字段值必须使用中文输出(调研过程可用英文,但最终JSON值为中文)

## 输出路径
{project_dir}/results/GitHub_Copilot.json

## 验证
完成JSON输出后,运行验证脚本确保字段完整覆盖:
python ~/.claude/skills/research/validate_json.py -f {project_dir}/fields.yaml -j {project_dir}/results/GitHub_Copilot.json
验证通过后才算完成任务。
Step 4: 等待与监控
  • 等待当前批次完成
  • 启动下一批
  • 显示进度
Step 5: 汇总报告

全部完成后输出:

  • 完成数量
  • 失败/不确定标记的items
  • 输出目录

Agent配置

  • 后台执行: 是
  • Task Output: 禁用(agent完成时有明确输出文件)
  • 断点续传: 是

© Weizhena, 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/research-zh/research-deep of Weizhena/Deep-Research-skills.

Open the folder on GitHubat commit 6ce38f6

Used in 1 other repository

We found 7 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Weizhena/Deep-Research-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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

Research Deep compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Deep this skillWeizhena/Deep-Research-skills2.3k1 repos~521Automated safety check: NotesMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Peer Reviewspacering-net/codeg3.9k17 repos~5.9kAutomated safety check: NotesMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes

More from Weizhena/Deep-Research-skills

All 10 skills in this repo
  • Research

    Weizhena/Deep-Research-skills

    Conduct preliminary research on a topic and generate research outline.

    2.3k GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Research Deep

    Weizhena/Deep-Research-skills

    Read research outline, launch independent agent for each item for deep research.

    2.3k GitHub starsUsed in 2 repos~850 tokens
    Auto-check: notes
  • Research Report

    Weizhena/Deep-Research-skills

    Summarize deep research results into markdown report, cover all fields, skip uncertain values.

    2.3k GitHub starsUsed in 2 repos~963 tokens
    Auto-check: notes
  • Research

    Weizhena/Deep-Research-skills

    对目标话题进行初步调研,生成调研outline。用于学术调研、benchmark调研、技术选型等场景. An agent skill from Weizhena/Deep-Research-skills.

    2.3k GitHub starsUsed in 1 repo~603 tokens
    Auto-check passed
  • Research Add Fields

    Weizhena/Deep-Research-skills

    Add field definitions to existing research outline. An agent skill from Weizhena/Deep-Research-skills.

    2.3k GitHub starsUsed in 2 repos~238 tokens
    Auto-check: notes
  • Research Add Items

    Weizhena/Deep-Research-skills

    Add items (research objects) to existing research outline. An agent skill from Weizhena/Deep-Research-skills.

    2.3k GitHub starsUsed in 2 repos~204 tokens
    Auto-check: notes

Questions about Research Deep

What does Research Deep do?

读取调研outline,为每个item启动独立agent进行深度调研。禁用task output. An agent skill from Weizhena/Deep-Research-skills. Research Deep is an agent skill from Weizhena/Deep-Research-skills.

When should I use Research Deep?

Research Deep fits situations like: research & Science work in your project.

How do I install Research Deep in Claude Code?

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

How do I install Research Deep in Codex?

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

Can I use Research Deep 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 Weizhena/Deep-Research-skills --skill research-deep -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-deep, .gemini/skills/research-deep, .github/skills/research-deep and .opencode/skills/research-deep in your project.

What does Research Deep need to run?

Going by SKILL.md and its folder, Research Deep needs the command-line tools its instructions call (python). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash, Read, Write, Glob, WebSearch, Task.

Does Research Deep access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Research Deep safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Research Deep use?

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

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

Skills that share tags, products or a category with Research Deep: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Deep?

Weizhena (a GitHub user) maintains it in Weizhena/Deep-Research-skills, which has 2,319 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on August 23, 2026.

Source: Weizhena/Deep-Research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.