Agent skill

Deep Research Literature Survey

by HKUSTDial in HKUSTDial/Supervisor-Skills

Runs a survey-grade literature investigation: fixes the research questions, searches from adversarial angles, verifies citations and writes an evidence-first report.

CC-BY-NC-SA-4.0Auto-check passedResearch & Science

Install Deep Research Literature Survey

skills CLI
$ npx skills add HKUSTDial/Supervisor-Skills --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install HKUSTDial/Supervisor-Skills 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/HKUSTDial/Supervisor-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/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
8.5k
Token cost
~2.4k tokens
SKILL.md length
1,211 words
Files
8 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
CC-BY-NC-SA-4.0

At a glance

Runs a survey-grade literature investigation: fixes the research questions, searches from adversarial angles, verifies citations and writes an evidence-first report.

  • Works in 3 steps: freeze the research brief → scout (search and verify) → synthesize
  • Surveying a research field before committing to a topic
  • SKILL.md covers Overview, When to use this skill, When NOT to use this skill and Capability check, plus 10 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent plays a senior researcher who has written strong surveys, and the deliverable reads like a survey paper rather than a bullet list or search results. Work starts by freezing a brief of topic, two or three specific research questions, an angle and the intended reader; if you give only a topic, it asks one or two clarifying questions to turn it into questions the conclusion must answer. Nothing later is allowed to drift from that brief.

Search runs from several adversarial perspectives, in parallel sub-agents with clean contexts when the environment allows and one after another otherwise. Every citation is verified, and the evidence is organized into a MECE taxonomy with comparisons made inside the sentences. Seven reference files cover citation protocol, hedge calibration, output structure, quality gates, search strategy, self-adversarial checks and the synthesis framework.

It needs real retrieval: a scholarly search tool, web search over scholarly indexes, or shell access to Crossref, Semantic Scholar, arXiv or DBLP, and with none of these it declines to write a survey from memory. Judging a single idea, drafting paper prose and looking up one or two papers belong to other skills. The skill is licensed CC-BY-NC-SA-4.0, which restricts commercial use.

When your agent uses it

  • Surveying a research field before committing to a topic
  • Mapping key works, debates and open problems in an area
  • Turning a broad topic into focused research questions

Example prompts

  • “Survey the state of CRISPR clinical therapies and tell me which diseases have approved treatments.”
  • “I need a literature review on social media and adolescent mental health before choosing my thesis topic.”
  • “Map the key works, debates and open problems in federated learning.”

Requirements

  • A scholarly search tool, web search or shell access to public scholarly APIs
  • Sub-agent support for parallel search (optional)

Workflow steps

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

  1. freeze the research brief
  2. scout (search and verify)
  3. synthesize

What it can do on your machine

Read from SKILL.md and the folder at commit 207bc6f. 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 Literature Survey loads about 2.4k tokens when it runs, and up to ~8.1k if it reads all its reference files. Until then it costs about 119 tokens; SKILL.md has 1,211 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.1k

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

Its licence (CC-BY-NC-SA-4.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,211 words (~2,357 tokens).

“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…”

— opening of SKILL.md by HKUSTDial, CC-BY-NC-SA-4.0
name
deep-research
license
CC-BY-NC-SA-4.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (references) in skills/deep-research of HKUSTDial/Supervisor-Skills.

  • SKILL.md
  • references/citation-protocol.md
  • references/hedge-calibration.md
  • references/output-structure.md
  • references/quality-gates.md
  • references/search-strategy.md
  • references/self-adversarial.md
  • references/synthesis-framework.md

Open the folder on GitHubat commit 207bc6f

Compare with similar skills

Deep Research Literature Survey 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 Literature Survey compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Research Literature Survey this skillHKUSTDial/Supervisor-Skills8.5k—~2.4kAutomated safety check: PassCC-BY-NC-SA-4.0
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT
Paper Research on arXivXiaomiMiMo/MiMo-Code14k1 repos~1.5kAutomated safety check: PassMIT
Literature Review AgentAr9av/PaperOrchestra6772 repos~5.2kAutomated safety check: PassCustom licence
Paper AutoratersAr9av/PaperOrchestra6772 repos~1.6kAutomated safety check: PassCustom licence
Literature ReviewK-Dense-AI/scientific-agent-skills48k1 repos~3.2kAutomated safety check: NotesMIT

Similar skills

  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Paper Research on arXiv

    XiaomiMiMo/MiMo-Code

    Searches arXiv, fetches metadata, generates BibTeX, downloads PDFs and finds citations and related papers using a bundled Python script.

    14k GitHub starsUsed in 1 repo~1.5k tokens
    Research & ScienceAuto-check passed
  • Literature Review Agent

    Ar9av/PaperOrchestra

    Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). An agent skill from Ar9av/PaperOrchestra.

    677 GitHub starsUsed in 2 repos~5.2k tokens
    Research & ScienceAuto-check passed
  • Paper Autoraters

    Ar9av/PaperOrchestra

    Run the four paper-quality autoraters from PaperOrchestra (arXiv:2604.05018, App.

    677 GitHub starsUsed in 2 repos~1.6k tokens
    Research & ScienceAuto-check passed
  • Literature Review

    K-Dense-AI/scientific-agent-skills

    Runs systematic, scoping or narrative literature reviews across PubMed, arXiv, bioRxiv and Semantic Scholar, with citation checks and Markdown or PDF output.

    48k GitHub starsUsed in 1 repo~3.2k tokens
    Research & ScienceAuto-check: notes
  • Literature Review

    Norman-bury/research-writing-skill

    A skill your agent uses when writing literature review sections - guides searching, organizing, and synthesizing academic sources

    3.4k GitHub stars~2.2k tokensUpdated 4 mo ago
    Research & ScienceAuto-check: notes

More from HKUSTDial/Supervisor-Skills

All 12 skills in this repo
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.5k GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Draw.io Diagram Reconstruction

    HKUSTDial/Supervisor-Skills

    Rebuilds a reference diagram image as an editable, high-fidelity Draw.io file, mixing native elements, SVG icons and cropped PNGs, with a batch workflow for a folder of images.

    8.5k GitHub stars~5.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Introduction Drafter

    HKUSTDial/Supervisor-Skills

    Drafts the Introduction of a technical paper as six paragraphs of flowing prose, positioning the work and matching contributions to challenges, with an outline on request.

    8.5k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Rebuttal Guidance

    HKUSTDial/Supervisor-Skills

    Turns pasted peer-review comments into a per-concern rebuttal plan, with reviewer mindset matching and strategy priorities, but not the final rebuttal text.

    8.5k GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Figure Designer

    HKUSTDial/Supervisor-Skills

    Advises on designing the three core figures of a technical paper, then audits them against rules for format, fonts, color and captions.

    8.5k GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Research Idea Evaluator

    HKUSTDial/Supervisor-Skills

    Evaluates a draft research idea like a top-venue reviewer and advisor, scoring it on five dimensions, checking fit with your capacity and returning a clear verdict.

    8.5k GitHub stars~3.4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Deep Research Literature Survey

What does Deep Research Literature Survey do?

Runs a survey-grade literature investigation: fixes the research questions, searches from adversarial angles, verifies citations and writes an evidence-first report. The agent plays a senior researcher who has written strong surveys, and the deliverable reads like a survey paper rather than a bullet list or search results. Work starts by freezing a brief of topic, two or three specific research questions, an angle and the intended reader; if you give only a topic, it asks one or two clarifying questions to turn it into questions the conclusion must answer.

When should I use Deep Research Literature Survey?

Deep Research Literature Survey fits situations like: surveying a research field before committing to a topic; mapping key works, debates and open problems in an area; turning a broad topic into focused research questions.

How do I install Deep Research Literature Survey in Claude Code?

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

How do I install Deep Research Literature Survey in Codex?

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

Can I use Deep Research Literature Survey 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 HKUSTDial/Supervisor-Skills --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 Literature Survey need to run?

SKILL.md names no scripts, command-line tools or credentials: Deep Research Literature Survey is instructions for the agent only. Our summary lists: A scholarly search tool, web search or shell access to public scholarly APIs; Sub-agent support for parallel search (optional).

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

Deep Research Literature Survey is published under the CC-BY-NC-SA-4.0 licence (declared in SKILL.md).

How many tokens does Deep Research Literature Survey use?

About 2.4k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.7k tokens, read only when the agent opens those files.

What are the alternatives to Deep Research Literature Survey?

Skills that share tags, products or a category with Deep Research Literature Survey: Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Paper Research on arXiv (XiaomiMiMo/MiMo-Code, 14k stars), Literature Review Agent (Ar9av/PaperOrchestra, 677 stars) and Paper Autoraters (Ar9av/PaperOrchestra, 677 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research Literature Survey?

HKUSTDial (a GitHub organization) maintains it in HKUSTDial/Supervisor-Skills, which has 8,523 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 5, 2026.

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