Agent skill

Deep Research Course Design

by THU-MAIC in THU-MAIC/OpenMAIC

Builds courses on current or externally checkable topics by researching live sources first, keeping a claim-to-source ledger and grounding every page in what was fetched.

MITAuto-check passedEducation

Install Deep Research Course Design

skills CLI
$ npx skills add THU-MAIC/OpenMAIC --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install THU-MAIC/OpenMAIC deep-research --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/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agent-runtime/deep-research .claude/skills/deep-research && 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
deep-research
GitHub stars
40k
Token cost
~2k tokens
SKILL.md length
1,118 words
Files
2
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Builds courses on current or externally checkable topics by researching live sources first, keeping a claim-to-source ledger and grounding every page in what was fetched.

  • Works in 9 steps: Start from what the session already has → Split the topic into facets → Search with a budget → …
  • Teaching a course on recent events, policy changes or market data
  • SKILL.md covers Structure, Step 1 — Start from what the…, Step 2 — Split the topic into… and Step 3 — Search with a budget, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill orders the work as research, then outline, then generation, and lets a number, date, name or finding into the course only if it came from a fetched source or from your own material. The course opens with one slide that frames the research question, uses slides, interactive scenes and quizzes in the body, and closes on what the evidence establishes and where it runs out. Quizzes test whether a learner can tell supported claims from unsupported ones.

Research starts from what the session already has: the agent lists attached materials before any search and treats them as the main authority on their subject, with `fetch_url` for links you pasted. It then splits the topic into two to four facets, skipping any that are stable textbook knowledge, and searches within a budget of at most eight `web_search` calls for the whole session and at most six URLs fetched in total. A bundled outline-constraints file accompanies the instructions.

When your agent uses it

  • Teaching a course on recent events, policy changes or market data
  • Building lessons about a product release where version details matter
  • Making a course that cites sources for every figure and named case

Example prompts

  • “Make a course on the latest EU AI Act obligations, with every claim traced to a source.”
  • “Build a short course on how current electric vehicle tax credits work, using the PDF I attached first.”
  • “Create lessons on last quarter's chip export rules and add a quiz on which claims are supported.”

Requirements

  • Web search and URL fetch tools in the course-building session

Workflow steps

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

  1. Start from what the session already has
  2. Split the topic into facets
  3. Search with a budget
  4. Pick sources, fetch them
  5. Read deep, keep the ledger
  6. Cross-check conflicts
  7. Know when research is done
  8. Ground the outline
  9. Ground every page

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Deep Research Course Design loads about 2k tokens when it runs. Until then it costs about 133 tokens; SKILL.md has 1,118 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 THU-MAIC/OpenMAIC at commit 7d324aa, republished under its MIT licence (© THU-MAIC). 1,118 words, ~1,964 tokens.

Download SKILL.mdSave it as .claude/skills/deep-research/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
deep-research
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.
title
深度调研

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

  • At most 8 web_search calls for the whole session, planned across the facets. One precise query beats several vague ones; write queries in the language of the course.
  • The session shares one run with planning, set_roster and every page's generation, and every extra call is latency the user watches. Research is one slice of the run, not the main act. If the run gets long, cut facets — never generation.
  • Read each result before searching again: the next query should be shaped by what the last one returned, not a rewording of it.

Step 4 — Pick sources, fetch them

  • From the search results, pick at most 6 URLs in total across all facets. Prefer primary and authoritative origins — official bodies, named institutions, the report or dataset itself — and for time-sensitive claims prefer the most recent. Skip mirrors and aggregators repackaging the same story: fetch one origin, not three copies of it.
  • fetch_url accepts only URLs that appeared in the user's messages or in this session's web_search results. Never assemble or recall a URL from memory — if the source you want did not surface, refine the search instead of guessing an address. A URL that never surfaced does not exist for this course.
  • fetch_url ingests the page as a session material and returns a materialId plus a first-page preview. That materialId is what the ledger cites.

Step 5 — Read deep, keep the ledger

  • Page through each fetched material with read_material — at least far enough to verify every claim you plan to take from it. Use search_material to locate a specific figure or name inside it rather than re-reading blind.
  • Maintain a running ledger: claim → source (materialId or URL, plus the source's name and publication date when visible). Only ledgered claims may enter the course as researched facts. Record the date: a stale figure presented as current is a factual error, not a styling choice.

Step 6 — Cross-check conflicts

  • Prefer primary over secondary sources, recent over outdated for time-sensitive claims, and domain authorities over general media. Two independent origins outweigh one story republished ten times.
  • If a conflict survives — genuinely contested figures, diverging official accounts — teach the range or the disagreement with both attributions. Do not silently pick a side, and never average conflicting numbers into an invented middle.
  • A load-bearing claim with a single source is single-sourced: soften the wording, attribute it explicitly, or drop it.
Show full SKILL.md (450 more words)Show less

Step 7 — Know when research is done

Research is complete when both hold:

  • every facet the outline will lean on has at least one ledgered source, or is marked as stable knowledge needing none;
  • every number, date and name the course will state is in the ledger.

Then stop. Polishing searches after coverage is reached steal budget from generation.

Step 8 — Ground the outline

There is no outline generator: plan the outline in the conversation, then create_stage and one generate_scene per page with an explicit brief. The page generator sees each page's brief and nothing you remember. Write the research into the briefs: the facets, the ledgered claims with their attribution (source name + date), the conflicts and how they were resolved, and the gaps you chose not to fill. Anything you want to shape the course must live in this text. Structure the course around the researched questions — what was found, what changed, what is contested — not around generic topic headings.

Step 9 — Ground every page

  • When generating a scene, pass that page's sourced facts in generate_scene.materialFacts — quoted concretely (figures, names, findings) with their attribution. The page generator only receives what you hand it; which fact belongs on which page is your choice.
  • Inside page content, cite naturally — the institution, the report, the year. Do not dump raw URLs at the learner.
  • Quiz distractors and interactive scenarios draw on ledgered facts too: a quiz that tests a number nobody verified teaches noise.

Scene naming

Titles name the finding or the question, not the folder.

  • Good: 「五年里成本降了多少?」「数据从哪里来」「两种口径差在哪」
  • Bad: 「行业概述」「研究背景」「本课总结」

Hard rules

  • Never invent sources, citations, URLs or publication dates. A claim with no ledger entry is taught as stable knowledge with honest wording, or not taught at all.
  • If web_search is not registered in this deployment, or searches keep failing: say so in chat, build from the user's materials and stable knowledge, and mark clearly what could not be verified. Never present memory as research.
  • Time-sensitive claims without a source do not enter the course. Timeless knowledge needs no source — do not spend budget verifying what a textbook already settles.
  • When user material and web findings conflict: on facts about the user's own subject (their data, their product, their case) the user's material wins. On external context, the better-verified recent source wins — and you surface the discrepancy to the user in chat instead of overriding silently.

If the requirement is not research-driven

If the topic is timeless textbook knowledge with no external fact to verify — a maths derivation, a classic text, an established skill — say so in one sentence in your chat message and plan an ordinary course instead. Do not run research theatre on a topic that needs no research.

© THU-MAIC, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/agent-runtime/deep-research of THU-MAIC/OpenMAIC.

  • SKILL.md
  • outline-constraints.json

Open the folder on GitHubat commit 7d324aa

Compare with similar skills

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

Deep Research Course Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Research Course Design this skillTHU-MAIC/OpenMAIC40k—~2kAutomated safety check: PassMIT
AnythingAtlasLiuziyu77/AnythingAtlas195—~3.6kAutomated safety check: PassApache-2.0
Tavily Web Searchallenpeng0705/EnvoyMesh3.1k3 repos~2.5kAutomated safety check: NotesNone
Deep Research Agent TeamImbad0202/academic-research-skills51k—~13kAutomated safety check: PassCustom licence
Architect ResearchDanMcInerney/architect-loop626—~2.3kAutomated safety check: PassMIT
Ray Trend Searchimraywang/rayskills159—~2.1kAutomated safety check: PassCustom licence

Similar skills

  • AnythingAtlas

    Liuziyu77/AnythingAtlas

    Researches an unfamiliar topic and delivers a verified resource guide and a staged, timed learning roadmap as matching Markdown and HTML files.

    195 GitHub stars~3.6k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Tavily Web Search

    allenpeng0705/EnvoyMesh

    Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content.

    3.1k GitHub starsUsed in 3 repos~2.5k tokens
    Productivity & AutomationAuto-check: notes
  • Deep Research Agent Team

    Imbad0202/academic-research-skills

    Runs a 13-agent pipeline for rigorous academic research, from forming the question through systematic search, synthesis, bias checks and an APA 7.0 report.

    51k GitHub stars~13k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Architect Research

    DanMcInerney/architect-loop

    A skill your agent uses when the user asks for discovery-scale research that informs a decision: brainstorming a project or feature, choosing a technology, or requests like "research X", "what's the…

    626 GitHub stars~2.3k tokensUpdated 27 days ago
    Research & ScienceAuto-check passed
  • Ray Trend Search

    imraywang/rayskills

    Researches what people are saying about a topic over a recent window across X, Reddit, YouTube and the public web, reporting each source's status with links.

    159 GitHub stars~2.1k tokensUpdated 17 days ago
    Research & ScienceAuto-check passed
  • Unified web search, page fetching and evidence checking across hundreds of sources, with result verification, a research-dossier mode and vertical search engines.

    188 GitHub stars~1.2k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed

More from THU-MAIC/OpenMAIC

All 25 skills in this repo
  • Guides setup, classroom generation and secondary development for OpenMAIC, the multi-agent interactive classroom, one confirmed phase at a time.

    40k GitHub stars~1.7k tokensUpdated today
    Auto-check: notes
  • Designs a Chinese K-12 classroom for one OpenMAIC stage around the core-literacy model, using authentic tasks, performance assessment and observable evidence.

    40k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Maps the structure of an OpenMAIC stage document so an agent can find the right path, read it and patch quizzes, widgets, actions and project pages without guessing.

    40k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Derives a reusable personal skill for course-making from a representative sample of the user's own past classrooms and chat history, confirmed with them before saving.

    40k GitHub stars~678 tokensUpdated today
    Auto-check passed
  • Curriculum Planner

    THU-MAIC/OpenMAIC

    Plans a multi-classroom series such as a seven-day course, clarifies the brief in rounds, gets sign-off on the full lesson list, then builds each stage in a shared folder.

    40k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Questions about Deep Research Course Design

What does Deep Research Course Design do?

Builds courses on current or externally checkable topics by researching live sources first, keeping a claim-to-source ledger and grounding every page in what was fetched. The skill orders the work as research, then outline, then generation, and lets a number, date, name or finding into the course only if it came from a fetched source or from your own material. The course opens with one slide that frames the research question, uses slides, interactive scenes and quizzes in the body, and closes on what the evidence establishes and where it runs out.

When should I use Deep Research Course Design?

Deep Research Course Design fits situations like: teaching a course on recent events, policy changes or market data; building lessons about a product release where version details matter; making a course that cites sources for every figure and named case.

How do I install Deep Research Course Design in Claude Code?

Run `npx skills add THU-MAIC/OpenMAIC --skill deep-research -a claude-code`. Or copy the skill folder (skills/agent-runtime/deep-research in THU-MAIC/OpenMAIC) into .claude/skills/deep-research in your project. Claude Code loads it when a task matches its description.

How do I install Deep Research Course Design in Codex?

Run `npx skills add THU-MAIC/OpenMAIC --skill deep-research -a codex`. Or copy the skill folder (skills/agent-runtime/deep-research in THU-MAIC/OpenMAIC) into .agents/skills/deep-research in your project. Codex loads it when a task matches its description.

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

What does Deep Research Course Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Deep Research Course Design is instructions for the agent only. Our summary lists: Web search and URL fetch tools in the course-building session.

Does Deep Research Course Design 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 Deep Research Course Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Deep Research Course Design use?

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

About 2k tokens (SKILL.md is roughly 7.9k 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 Deep Research Course Design?

Skills that share tags, products or a category with Deep Research Course Design: AnythingAtlas (Liuziyu77/AnythingAtlas, 195 stars), Tavily Web Search (allenpeng0705/EnvoyMesh, 3.1k stars), Deep Research Agent Team (Imbad0202/academic-research-skills, 51k stars) and Architect Research (DanMcInerney/architect-loop, 626 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research Course Design?

THU-MAIC (a GitHub organization) maintains it in THU-MAIC/OpenMAIC, which has 40,274 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 10, 2026.

Source: THU-MAIC/OpenMAIC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.