MCPInstall

deep-research

Runs a deep, survey-grade literature investigation on a research topic: freezes research questions, searches from multiple adversarial perspectives, verifies every citation, synthesizes evidence into a MECE taxonomy with in-sentence cross-comparison, and answers the research questions in an evidence-first report. Use when the user asks for a literature review, a survey of a field, research landscape mapping, or a deep dive into what is known about a topic.

Installs
513
Last 24h
+8
Trending rank
#9413
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/hkustdial/supervisor-skills --skill deep-research
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads deep-research automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Deep Research

Overview

The role is a senior researcher who has written strong surveys and served as a section editor. Someone brings a research topic; the job is to map the terrain, lay out the key works, surface the tensions and the gaps, and end with a judgment the evidence has earned.

This is not a search engine and not a bullet-point answer. The deliverable reads like a real survey paper: questions defined first, evidence developed systematically, conclusions emerging from the evidence rather than announced up front and back-filled.

When to use this skill

  • "Survey this direction for me." "What is the state of X?"
  • "What are the key works, debates, and open problems in this area?"
  • "I need a literature review before committing to this topic."

When NOT to use this skill

  • Judging whether one specific idea is worth pursuing: idea-evaluator.
  • Drafting or polishing paper prose: paper-writer, intro-drafter, paper-polish.
  • A quick lookup of one or two papers: plain search suffices; this skill is for depth.

Capability check

  • Literature search: a scholarly search tool if available; otherwise web search over scholarly indexes; otherwise shell access to public APIs (Crossref, Semantic Scholar, arXiv, DBLP). With no retrieval at all, this skill does not run: say so rather than writing a survey from memory.
  • Sub-agents: when the environment can spawn parallel sub-agents, each search perspective runs as its own agent with a clean context; without them, run the perspectives serially yourself. The method does not change, only the execution.

Step 0: freeze the research brief

Before any searching, pin down what is being investigated.

The brief must contain research questions: not a topic, but two or three specific, answerable questions. They are the survey's promise; the conclusion must answer each one.

If the user gives only a topic ("survey CRISPR for me"), convert it with one or two clarifying questions:

  • "CRISPR clinical progress" becomes RQ1: which diseases have phase-III or approved CRISPR therapies? RQ2: where is the safety boundary for in-vivo editing? RQ3: what limits accessibility?
  • "social media and adolescent mental health" becomes RQ1: does causal (not correlational) evidence support harm? RQ2: what is the effect size? RQ3: who is most affected?

Brief = topic + research questions + angle + intended reader. Every later step answers to this brief; drift is not allowed.

The strongest angles come from unexpected convergence or tension across independent sources. The Angle gate in references/quality-gates.md gives the tests.

Phase 1: scout (search and verify)

Generate three to five search perspectives around the brief, each with its own question and its own keywords:

  • the mainstream school (who advances this direction, and with what);
  • the critics (who doubts it, with what counter-evidence);
  • adjacent fields (what other disciplines say about the same question);
  • methodology (who challenges how the mainstream measures things: meta-analyses, systematic reviews);
  • application and policy (what deployment or regulation evidence exists).

Each perspective searches independently, wide then narrow: a first round on core keywords, a second round narrowed by what the first returned (method names, dataset names, terms of art). Keyword construction patterns and the discipline adjustments: references/search-strategy.md.

When sub-agents are available, run one per perspective in parallel; each returns candidate works with one-line findings. Then merge across perspectives and check blind spots: perspectives that returned almost nothing (a real gap, or bad keywords?), sub-directions no perspective covered, high-frequency works cited by the found papers but missing from the pool, and discarded results that point somewhere uncovered.

Every candidate reference is verified before use. The two-step protocol, five-grade verdict, and the grey-zone rule (unconfirmable means unused): references/citation-protocol.md.

Corpus size has no quota; coverage of every sub-direction (three or more works each) is the bar. Over-collecting is fine; the synthesis phase filters.

Phase 2: synthesize

With the verified corpus in hand: extract per-paper findings, cluster by theme into a MECE taxonomy, assign works to branches, then write the branches serially, each section citing only its assigned works. In-sentence cross-comparison is mandatory; contradictions are presented with condition analysis, never averaged away. The full method: references/synthesis-framework.md.

After synthesis, run the self-adversarial review (three retrospective questions, perspective-omission check, concession rules): references/self-adversarial.md.

The six gates and the iteration loop

Throughout, six internal gates guard quality (never shown to the reader):

GateOne lineSeverityFailure route
Anglea judgment, or just a listing?CRITICALback to Step 0
Coveragekey works all found?MAJORtargeted re-scout
Citationreferences real and honestly quoted?CRITICALre-verify; delete inventions
Taxonomyorganized by theme, MECE?MAJORredesign axes
Calibrationclaim strength matches evidence?MAJORre-calibrate wording
Weavingin-sentence comparison present?MAJORrewrite flagged sections

Detection questions and routes: references/quality-gates.md.

The loop this creates is the point: a Coverage or Citation failure sends the work back to scouting for a targeted supplement (new works append to the corpus; the synthesis updates incrementally), not a restart. Iterate until every gate is CLEAR and the self-adversarial pass stops finding corrections. Depth is driven by the topic's complexity, not by a fixed round count.

Presentation

Organize the final report as a survey paper: abstract; introduction with the research questions; methodology; taxonomy; branches with comparison tables; cross-branch synthesis discussion; open problems; a conclusion that answers the RQs one by one; references. The skeleton, per-part guidance, and formatting discipline: references/output-structure.md.

Wording strength follows the hedge ladder (claim never exceeds evidence): references/hedge-calibration.md.

Evidence-first narration: the introduction poses the questions, the body develops the evidence, the conclusion answers. The reader derives the conclusions alongside the text instead of being told first and shown supporting quotes after. This ordering is the survey's defense against its own confirmation bias.

Cross-discipline evidence standards

Switch what counts as strong evidence by field:

  • CS / AI: benchmarks, ablations, reproducibility; note model versions and evaluation conditions.
  • Biomedicine: trial phase, patient counts, follow-up length, approval status.
  • Social science: causal versus correlational designs (RCT, natural experiments, IV); effect sizes and heterogeneity.
  • Economics and finance: identification strategy (IV, DID, RDD); statistical versus economic significance.
  • Cross-disciplinary: separate model predictions, observational attribution, and field experiments; carry uncertainty ranges.

Non-CS reports include the evidence-type table from the output-structure reference so readers can weigh evidence kinds.

Unconfirmed markers: a deliberate difference from paper prose

A survey report is a working document addressed to the researcher, so an explicit unconfirmed marker ("[unconfirmed: no work retrieved in this direction]") is honest signaling and is allowed, under the uniform convention in references/citation-protocol.md. Paper prose (paper-writer, intro-drafter) forbids all bracketed markers. The two regimes differ on purpose; do not import this convention into paper drafting.

Output language

The report follows the language of the user's request: a question asked in Chinese gets a Chinese survey, English gets English. (This deliberately differs from the drafting skills, which default to English: a survey is read by the researcher, not submitted to a venue.) In Chinese reports, keep technical terms in English with a half-width space around them. An explicit language request always wins.

Delivery

A full survey is written to a workspace file (Markdown), with the structure, tables, and reference list intact. Short literature answers can stay in the conversation. Capability degradations (perspectives run serially, weaker retrieval for some literature) are disclosed in a short note.

Boundaries with sibling skills

  • Wants a verdict on one idea: idea-evaluator.
  • Wants prose written or polished: paper-writer / paper-polish.
  • The evaluator or writer discovers the user actually needs the landscape first: they route here.

FAQ

What does the deep-research skill do?

Runs a deep, survey-grade literature investigation on a research topic: freezes research questions, searches from multiple adversarial perspectives, verifies every citation, synthesizes evidence into a MECE taxonomy with in-sentence cross-comparison, and answers the research questions in an evidence-first report. Use when the user asks for a literature review, a survey of a field, research landscape mapping, or a deep dive into what is known about a topic.

How do I install deep-research?

Run npx skills add https://github.com/hkustdial/supervisor-skills --skill deep-research in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/deep-research/ (personal) or .claude/skills/deep-research/ (project).

Which AI agents can use deep-research?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is deep-research safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains deep-research?

It is published by hkustdial in hkustdial/supervisor-skills. It has 513 recorded installs.

More from hkustdial/supervisor-skills

View all →

figure-designer

hkustdial/supervisor-skills

Advises on the design of the three core figures in a technical paper: the Motivated Example (Figure 1), the Solution Overview (Methodology), and the Experimental Results figures. Recommends the right design paradigm, layout, labelling, and tool for each figure type, then runs a quality-control audit. Use when the user asks to 'design a figure', 'draw Figure 1', 'plot experiment results', 'choose the right chart type', 'which figure tool to use', or 'figure looks unprofessional'.

Frontend & Design747 installs

idea-evaluator

hkustdial/supervisor-skills

Evaluates a preliminary research idea against a five-dimension framework (Higher, Faster, Stronger, Cheaper, Broader) plus idea-lifecycle and student-capability matching, paradigm-shift probing, and a fatal-flaws audit. Returns a reviewer-style verdict; non-STEM ideas route to substitute frameworks. Use when the user has a draft research idea and asks whether it is worth pursuing, asks to 'evaluate this idea', 'score this idea', 'assess feasibility', 'novelty check', 'is this a good research direction', or before committing to a paper scope.

pre-submission-reviewer

hkustdial/supervisor-skills

Runs a pre-submission review of a technical paper across five dimensions: macro logic, writing details, English grammar, LaTeX formatting, and figure quality. Uses a reviewer-style severity taxonomy (CRITICAL / MAJOR / MINOR) and flags banned AI-tone vocabulary and em-dash misuse. Use when the user asks to 'review this paper', 'audit before submission', 'check the draft', 'find issues', 'proofread', or within one week of a submission deadline.

intro-drafter

hkustdial/supervisor-skills

Drafts the Introduction prose for a technical paper, guided internally by a six-paragraph flowchart: background and running example, existing limitations, problem essence and goal, key challenges, solution overview, contributions. Positions the paper as Technique or New Problem/Setting, aligns contributions with challenges, and weaves verified citations. Outputs flowing prose by default, or an outline on request. Use when the user asks to draft, outline, or restructure an Introduction.

tech-paper-template

hkustdial/supervisor-skills

Structures a technical paper's full logical skeleton using a thinking-template table (research background, limitations, key idea or goal, challenges, methodology modules, contributions), positions the paper as Technique or New Problem/Setting, and runs a four-point self-consistency check. Use when the user is brainstorming a paper, discussing progress with an advisor, or planning the paper before drafting. Also use for 'paper skeleton', 'paper logic chain', 'thinking template', 'paper-structure planning'.

vibe-research-workflow

hkustdial/supervisor-skills

Guides AI-assisted research across three sub-flows, Vibe Coding, Vibe Figure, and Vibe Writing, with behavioural rules that keep the user in charge of academic judgment while delegating mechanical work to AI. Recommends the right tool (Cursor, Claude Code, Codex, Figma, Gemini) for the current stage. Use when the user asks 'how to use AI for research', 'Vibe Coding tips', 'AI-assisted writing workflow', 'which AI tool for this', or starts an AI-assisted work session.

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由;/page/ 是妙搭应用,非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

lark-base

open.feishu.cn

飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式(BaseApp/AppMode 页面与组件)、Workspace 目录、workflow、角色权限、模板中心(多维表格模板分类/列表/搜索);遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps;文件导入/导出转 lark-drive,认证/授权转 lark-shared。

lark-drive

open.feishu.cn

飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签(secure labels)和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用;doubao.com 云空间 URL/token 也按资源路径和 token 路由,不回退 WebFetch。不负责:文档内容编辑(走 lark-doc)、表格/Base 表内数据操作(走 lark-sheets/lark-base)、知识空间节点/成员管理(走 lark-wiki)、原生 Markdown 文件读写/patch/diff(走 lark-markdown)。

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

lark-im

open.feishu.cn

飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive Card)、监听卡片按钮回调(card.action.trigger)。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。