# Deep Research

Courses whose content rests on current, external or real-world facts that must be...

- Repository: https://github.com/THU-MAIC/OpenMAIC (42385 stars)
- Category: Data and ML
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add THU-MAIC/OpenMAIC --skill deep-research -g -a claude-code -y`
Codex: `npx skills add THU-MAIC/OpenMAIC --skill deep-research -g -a codex -y`
Cursor: `npx skills add THU-MAIC/OpenMAIC --skill deep-research -g -a cursor -y`
Gemini CLI: `npx skills add THU-MAIC/OpenMAIC --skill deep-research -g -a gemini-cli -y`

## Description

Courses whose content rests on current, external or real-world facts that must be verified against live sources before being taught, recent events, market or policy data, product and version specifics, scientific developments, named cases. Researches the topic first, keeps a claim-to-source ledger, and grounds the outline and every page in what was actually fetched. Use when the request depends on up-to-date or externally checkable facts; not for timeless textbook topics that stand on established knowledge alone.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Deep Research course design

You are designing a course whose content rests on facts you must **verify,
not recall**. Research first, outline second, generate third. A number, date,
name or finding enters the course only because you saw it in a source you
fetched or in the user's own material, and you can say which one.

## Structure

- Open with one `slide`: it frames the research question and previews what
  kind of evidence the course will examine. Not a definitions or
  history-of-the-field page.
- The body carries the findings, in whatever scene types fit: slides for
  sourced exposition, `interactive` for evidence the learner can inspect,
  `quiz` for checking whether the learner can tell a supported claim from an
  unsupported one.
- Close on what the evidence establishes and where it runs out, not on a
  generic summary.

## Step 1, Start from what the session already has

Call `list_materials` before any search. Materials the user attached, documents, links, data, recordings, are the primary authority on their own
subject; web research supplements them, it does not replace them. If a
derivative is still extracting, `extract_material` or `wait_for_materials` as
in any other course. URLs the user pasted in chat can be fetched directly with
`fetch_url`.

## Step 2, Split the topic into facets

Break the request into 2, 4 searchable facets, distinct questions the course
must answer with evidence. Typical facets: current state or latest
developments; authoritative figures and baseline data; concrete cases and
incidents; risks, controversies or open questions. Write the facet list down
before searching. Not every facet needs a search: a facet that is stable
textbook knowledge is skipped and taught as such.

## Step 3, Search with a budget

The rest: https://github.com/THU-MAIC/OpenMAIC/blob/HEAD/skills/agent-runtime/deep-research/SKILL.md