Agent skill

Deep Research

by staruhub in staruhub/ClaudeSkills

A skill your agent uses when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a…

MITAuto-check passedResearch & Science

Install Deep Research

skills CLI
$ npx skills add staruhub/ClaudeSkills --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install staruhub/ClaudeSkills 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/staruhub/ClaudeSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/Geek-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
727
Token cost
~2.8k tokens
SKILL.md length
1,256 words
Files
17 (incl. scripts, references, assets)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a…

  • Works in 4 steps: This SKILL.md → references/methodology.md → references/report-assembly.md → …
  • The user wants an evidence-based research memo
  • SKILL.md covers What this skill should produce, When NOT to use this skill, Org-policy boundary and Active context bundle, plus 5 more sections
  • Runs Python scripts from its folder

What it does

Deep Research is an agent skill from staruhub/ClaudeSkills. Use this skill when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a clear conclusion. Best for tasks that need synthesis across multiple external sources, iterative follow-up research, or a reusable written artifact. Do not use for quick factual lookups, single-source summaries, simple Q&A, summarizing one document the user already provided, plan-only requests where the user explicitly defers…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts, reference files and assets (for example `assets/report_template.md`, `evals/routing-evals.json` and `evals/runbook.md`). Compatibility notes: Requires web search plus file read/write. Shell/scripts and subagents are optional accelerators, not hard requirements.

It sits in Research & Science, covering Deep research and Literature review. The repository describes itself as: 13 curated Agent Skills for research, product decisions, decks, publishing, audits, and more — portable across skills-compatible agents. The licence is MIT.

When your agent uses it

  • The user wants an evidence-based research memo
  • Literature review
  • Market/policy/technical landscape
  • A multi-source decision brief with citations

Example prompts

  • “技术选型分析”
  • “/deep-research”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Requires web search plus file read/write. Shell/scripts and subagents are optional accelerators, not hard requirements.

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. This SKILL.md
  2. references/methodology.md
  3. references/report-assembly.md
  4. references/research-notes-format.md

What it can do on your machine

Read from SKILL.md and the folder at commit 66e02d2. 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

    Ships 3 files in scripts/ (Python), which the agent can run.

    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.

  • Compatibility

    Requires web search plus file read/write. Shell/scripts and subagents are optional accelerators, not hard requirements.

    From compatibility in the SKILL.md frontmatter.

Context cost

Deep Research loads about 2.8k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 197 tokens; SKILL.md has 1,256 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from staruhub/ClaudeSkills at commit 66e02d2, republished under its MIT licence (© staruhub). 1,256 words, ~2,785 tokens.

Download SKILL.mdSave it as .claude/skills/deep-research/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
deep-research
description
Use this skill when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a clear conclusion. Best for tasks that need synthesis across multiple external sources, iterative follow-up research, or a reusable written artifact. Do not use for quick factual lookups, single-source summaries, simple Q&A, summarizing one document the user already provided, plan-only requests where the user explicitly defers the actual research, or when the user wants a short answer with no need for cited evidence (a short but evidence-backed conclusion is still a brief memo, which this skill covers). Chinese trigger examples: "帮我调研", "深度研究", "综述报告", "技术选型分析", "竞品研究", "政策分析".
compatibility
Requires web search plus file read/write. Shell/scripts and subagents are optional accelerators, not hard requirements.
version
8.1.2
metadata.version
8.1.2
metadata.owner
enterprise-research
metadata.category
research
metadata.maturity
production-candidate
metadata.outputs
workspace/research-plan.md workspace/research-notes/*.md workspace/registry.md workspace/draft.md workspace/evaluation.md workspace/run-summary.json

Deep Research V8.1

This skill is for evidence-rich research outputs, not for every question that happens to mention “analysis”.

The V8 shift is simple:

  • Single-agent first. Start with one lead agent and only fan out when parallel work will clearly help.
  • Thin harness, fat skill. Put reusable judgment and workflow here; keep deterministic checks in scripts.
  • Context organization over prompt stuffing. Load the minimum active context bundle, then pull in references only when needed.
  • Eval and observability built in. A good report is not enough; the run must also be diagnosable and improvable.

What this skill should produce

Choose the lightest artifact that satisfies the task.

Output typeUse whenTypical lengthRequired artifacts
Brief memouser wants a concise answer with evidence800-1800 wordsresearch-plan.md, registry.md, draft.md, run-summary.json
Full reportuser asks for comprehensive analysis / literature review / decision document2500-6000 wordsall core artifacts + evaluation.md
Delta updateuser says “continue”, “second round”, “what changed”, “deepen round 2”600-1800 wordsprior round handoff (references/handoff-format.md) + new notes + delta draft

If the user did not ask for a long report, default to Brief memo.

When NOT to use this skill

Do not activate for:

  • quick fact lookups or simple definitions
  • summarizing a single provided article/PDF/page
  • short comparisons the model can answer directly from 1-2 sources
  • brainstorming without evidence requirements
  • tasks where the user explicitly wants a short answer, not a report

If in doubt, ask yourself: Does this task need a reusable evidence artifact and multi-source synthesis? If not, do something simpler.

Org-policy boundary

This skill does not replace system policies, enterprise guardrails, or repo-level instructions. Put these outside the skill:

  • data handling / PII / compliance rules
  • approval requirements for external access or irreversible actions
  • org-wide style and review policy
  • environment-specific permissions

Keep those in system prompts, AGENTS/CLAUDE/OpenAI config, or the harness. This skill owns the workflow, not the company’s permanent red lines.

Active context bundle

At activation time, keep the active bundle small.

Always load first

  1. This SKILL.md
  2. references/methodology.md
  3. references/report-assembly.md
  4. references/research-notes-format.md

Load on demand

  • references/subagent-prompt.md only if you actually dispatch subagents
  • references/handoff-format.md only when a delta update continues a prior round
  • references/evaluator-prompt.md only if you run the evaluator
  • references/quality-gates.md before finalization
  • references/observability.md when emitting metrics or diagnosing regressions
  • references/tension-discovery.md only for contested / decision-heavy topics
  • references/landscape-scan.md only when literature or ecosystem mapping matters

After compaction or context reset Reload only:

  • research-plan.md
  • active task notes
  • registry.md
  • unresolved issues list
  • the one reference file for the current phase

Do not reload the whole skill tree unless the run drifted badly.

Workflow

P0 — Scope, route, and choose the lightest mode

Create workspace/research-plan.md with:

  • research question
  • intended audience
  • freshness requirement
  • geography / market / jurisdiction
  • output type (brief / full / delta)
  • stakes: low / medium / high
  • why this skill is justified

Then choose the orchestration mode:

ModeDefault choice
Single-agentdefault for most tasks
Lead + subagentsonly when there are 3+ separable research threads or obvious parallel value
Delta updatewhen continuing prior research

Do not fan out just because subagents exist.

P0.5 — Optional modules (not mandatory by default)

Use optional modules only when they earn their keep:

  • Tension discovery (references/tension-discovery.md): use for contested, hype-heavy, or decision topics where mainstream framing may be wrong.
  • Landscape scan (references/landscape-scan.md): use when the domain is unfamiliar, broad, or literature-heavy. For non-academic topics, this can be an ecosystem/standards/vendor scan rather than arXiv.
  • Reverse search: use when costs, failure modes, counter-evidence, or operational constraints are missing.
P1 — Plan the evidence work

Break the task into 1-5 research threads. Each thread needs:

  • one crisp objective
  • starting queries
  • what “done” looks like
  • what evidence would change the conclusion

If using subagents, each subagent gets one focused thread. Avoid overlapping ownership.

P2 — Investigate, extract, and write notes

Follow references/research-notes-format.md.

Rules:

  • search broadly first, then chase named entities, standards, datasets, products, trials, laws, or papers
  • fetch and read the best supporting sources for the highest-value claims
  • write notes that separate facts, analysis, gaps, and unresolved conflicts
  • capture support snippets/paraphrases for the top claims so later verification is easier

The lead agent should work from notes by default, but may inspect raw/fetched sources again when:

  • two sources materially conflict
  • a claim is high-stakes or decision-critical
  • a note looks suspiciously weak or over-compressed
P3 — Build registry and verify evidence

Create workspace/registry.md from approved sources only.

Use scripts/source_evaluator.py as a helper, not an oracle. Authority scores are heuristics. Final acceptance depends on claim fit, evidence type, and whether the source can actually bear the weight of the claim.

Use scripts/verify_citations.py before finalization.

Evidence rules:

  • core claims should lean on the strongest available evidence for that claim type
  • anecdotes illustrate; they do not anchor the conclusion
  • conflicting evidence must be surfaced, not silently averaged away
  • if the topic is high-stakes, spot-check raw support for top claims before shipping
Show full SKILL.md (468 more words)Show less
P4 — Synthesize the output

Follow references/report-assembly.md. For full reports, assets/report_template.md is an optional skeleton; adapt it rather than inventing a new structure.

Always include:

  • clear answer to the user’s question
  • explicit limitations / trade-offs
  • separation of source-backed findings vs your own synthesis
  • uncertainty calibrated to evidence quality

Only include a dedicated Decision Framework when the user is choosing between options. Only require a contrarian section when the topic actually has a mainstream narrative worth challenging. Otherwise produce a non-obvious insight instead of forcing fake contrarianism.

P5 — Evaluate and gate

For full reports and medium/high-stakes briefs, run the evaluator using references/evaluator-prompt.md.

Before finalization, check references/quality-gates.md:

  • routing correctness
  • process completeness
  • grounding / citation integrity
  • output quality
  • efficiency and operational health
P6 — Finalize, summarize, and learn

Emit:

  • final draft.md
  • evaluation.md if run
  • run-summary.json via scripts/emit_run_summary.py

In the run summary, record what actually helped: single-agent, subagents, tension discovery, landscape scan, reverse search, evaluator, or manual spot-checks. This is what makes the skill improve over time.

“Finalize” means deliver research artifacts to the user. Do not publish to an external site, send messages, request credentials, or make irreversible changes unless a separate explicit user request and the host policy authorize it.

Deterministic helpers

Use scripts for the parts that should be boring and repeatable:

  • scripts/source_evaluator.py — baseline source scoring / diversity checks
  • scripts/verify_citations.py — fail-closed citation integrity and source-pool checks
  • scripts/emit_run_summary.py — structured observability output for the run

For reproducible recency scoring, pass an explicit evidence cutoff: scripts/source_evaluator.py sources.json --as-of YYYY-MM-DD. Record the same cutoff in the research plan and run summary.

If a deterministic check fails, fix the artifact first. Do not argue with the script unless you have a concrete reason.

Evaluation and observability

This skill is only “good” if it performs well on:

  1. Routing — does it trigger when it should, and stay out of the way when it should not?
  2. Process — did it create the right artifacts and evidence trail?
  3. Outcome — is the final brief/report genuinely useful and grounded?
  4. Efficiency — did it get there with acceptable tool/time/token cost?
  5. Safety / governance — did it respect policy boundaries and handle uncertainty honestly?

See:

  • evals/routing-evals.json
  • evals/runbook.md — how to run the routing and mode checks
  • references/quality-gates.md
  • references/observability.md

Degraded mode

If subagents, shell, or a writable workspace are unavailable, keep the workflow but shrink the surface area:

  • one lead agent only
  • inline notes instead of files if needed
  • fewer searches, but still enough to support the conclusion
  • lightweight evaluator or self-check if full evaluation is impossible
  • still keep limitations, uncertainty, and citation integrity

Stop conditions

Stop and ask for help only when the blocker is real and specific, for example:

  • no credible sources exist for a critical claim
  • the user’s requested scope conflicts with available evidence
  • policy or access restrictions block the required research

Otherwise, continue with the best justified artifact and say where the confidence drops.

© staruhub, 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 16 other files (scripts, references, assets) in skills/Geek-skills-deep-research of staruhub/ClaudeSkills.

  • SKILL.md
  • assets/report_template.md
  • evals/routing-evals.json
  • evals/runbook.md
  • references/evaluator-prompt.md
  • references/handoff-format.md
  • references/landscape-scan.md
  • references/methodology.md
  • references/observability.md
  • references/quality-gates.md
  • references/report-assembly.md
  • references/research-notes-format.md
  • references/subagent-prompt.md
  • references/tension-discovery.md
  • scripts/emit_run_summary.py
  • scripts/source_evaluator.py
  • scripts/verify_citations.py

Open the folder on GitHubat commit 66e02d2

Compare with similar skills

Deep Research 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Research this skillstaruhub/ClaudeSkills727—~2.8kAutomated safety check: PassMIT
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0
Deep Researchsanjay3290/ai-skills4319 repos~683Automated safety check: NotesApache-2.0
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence
Academic Research Suite for CodexImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence
Deep Research Agent TeamImbad0202/academic-research-skills51k—~13kAutomated safety check: PassCustom licence

Similar skills

  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated today
    Research & ScienceAuto-check passed
  • Deep Research

    sanjay3290/ai-skills

    Execute autonomous multi-step research using Google Gemini Deep Research Agent.

    431 GitHub starsUsed in 9 repos~683 tokens
    Research & ScienceAuto-check: notes
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 6 days ago
    Research & ScienceAuto-check passed
  • 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
  • Bmad Deep Recon

    delorenj/mcp-server-trello

    Decision-grade research, three ways: draft a deep-research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), process a finished research report — file it, distill…

    445 GitHub stars~2.3k tokensUpdated 16 days ago
    Research & ScienceAuto-check passed

More from staruhub/ClaudeSkills

All 20 skills in this repo
  • Wechat Article Writer

    staruhub/ClaudeSkills

    专业微信公众号文章助手,支持四个独立且可组合模式:article 写正文;image-prompts 从文章生成版本化、provider-neutral 的图片提示词 manifest 与稳定占位符,但不调用生图;layout 把文章和 manifest 确定性转换为微信安全的内联 HTML;full-pipeline…

    727 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • A Share Analyst

    staruhub/ClaudeSkills

    A股分析研究助手,提供行情数据获取与技术面/基本面分析框架(仅供研究参考,不构成投资建议)。适用于:(1) 获取A股行情和历史数据,(2) 技术面分析(K线形态、MACD、KDJ、RSI、布林带等),(3) 基本面分析(财务指标、估值分析),(4) 板块热点追踪,(5) 选股策略筛选与量化因子分析,(6)…

    727 GitHub stars~871 tokensUpdated 1 mo ago
    Auto-check passed
  • C Drive Cleaner

    staruhub/ClaudeSkills

    Windows C盘清理和磁盘空间管理。当用户说C盘满了、磁盘空间不足、清理临时文件/缓存/回收站/系统日志、查找大文件、分析磁盘占用时使用。仅适用于 Windows 环境。不用于:macOS/Linux 磁盘清理、卸载软件(引导用户走系统卸载)、清理用户个人文件(只报告位置,删除决定权在用户)。

    727 GitHub stars~518 tokensUpdated 1 mo ago
    Auto-check passed
  • Gaokao Expert

    staruhub/ClaudeSkills

    资深高考命题专家助手,提供专业的命题指导和评审服务。适用于创作高考试题、评审试题质量、分析试卷结构、了解命题趋势等场景。结合文档工具提取解压文件,使用网络搜索了解当年最新命题趋势,使用分析工具评估题目质量和试卷结构。涵盖"一核四层四翼"评价体系、题型规范、评分标准、命题流程等多个维度。不用于:大学/考研/中考命题(体系不同,仅可借鉴)、日常作业题编写、直接替考生解题。

    727 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • LLM Wiki

    staruhub/ClaudeSkills

    Build and maintain a structured LLM-generated wiki for any codebase.

    727 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Mineru PDF Parser

    staruhub/ClaudeSkills

    用 MinerU 将复杂PDF文档转换为LLM友好的Markdown/JSON格式。适用于:(1) PDF转Markdown/JSON,(2) 提取PDF中的文本、表格、公式、图像,(3) 解析学术论文、技术文档、商业报告,(4) 为RAG应用准备文档数据,(5) 批量处理PDF。触发关键词:"PDF解析"、"PDF转Markdown"、"提取PDF表格/公式"、"MinerU"、"parse…

    727 GitHub stars~671 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Deep Research

What does Deep Research do?

A skill your agent uses when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a…. Deep Research is an agent skill from staruhub/ClaudeSkills. Use this skill when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a clear conclusion.

When should I use Deep Research?

Deep Research fits situations like: the user wants an evidence-based research memo; literature review; market/policy/technical landscape; A multi-source decision brief with citations.

How do I install Deep Research in Claude Code?

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

How do I install Deep Research in Codex?

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

Can I use Deep Research 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 staruhub/ClaudeSkills --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 need to run?

Going by SKILL.md and its folder, Deep Research needs Python for the scripts in its folder. Our summary lists: Python 3. Compatibility (from SKILL.md): Requires web search plus file read/write. Shell/scripts and subagents are optional accelerators, not hard requirements..

Does Deep Research 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 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Deep Research use?

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

About 2.8k tokens (SKILL.md is roughly 11k 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 8.1k tokens, read only when the agent opens those files.

What are the alternatives to Deep Research?

Skills that share tags, products or a category with Deep Research: Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars), Deep Research (sanjay3290/ai-skills, 431 stars), Academic Research Pipeline (Imbad0202/academic-research-skills, 51k stars) and Academic Research Suite for Codex (Imbad0202/academic-research-skills-codex, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research?

staruhub (a GitHub user) maintains it in staruhub/ClaudeSkills, which has 727 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on August 13, 2026.

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