Agent skill

Deep Research

by jordan-gibbs in jordan-gibbs/hyperresearch

Deep research with hyperresearch, for Claude Code and OpenAI Codex.

MITAuto-check passedResearch & Science

Install Deep Research

skills CLI
$ npx skills add jordan-gibbs/hyperresearch --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install jordan-gibbs/hyperresearch 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/jordan-gibbs/hyperresearch.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
3.8k
Token cost
~1.2k tokens
SKILL.md length
595 words
Files
2
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Deep research with hyperresearch, for Claude Code and OpenAI Codex.

  • Works in 2 steps: Check the CLI → Pick your branch
  • The user asks for deep research
  • SKILL.md covers 1. Check the CLI, 2. Pick your branch, 3A. Claude Code and 3B. OpenAI Codex
  • Calls pip and codex

What it does

Deep Research is an agent skill from jordan-gibbs/hyperresearch. Deep research with hyperresearch, for Claude Code and OpenAI Codex. Use when the user asks for deep research, a research report, a literature review, or a multi-source analysis with verified citations. Checks that the hyperresearch CLI is installed, sets it up in the current project for the agent you are running in, then hands off to the hyperresearch pipeline (a tier-adaptive 16-step pipeline with a persistent source vault). Not for quick lookups one or two searches can answer.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`). Compatibility notes: Requires Python 3.11+ and the hyperresearch CLI (pip install hyperresearch), plus network access for fetching sources. Works in Claude Code and OpenAI Codex…

It sits in Research & Science, covering Deep research. It works with Model Context Protocol. The repository describes itself as: Convert Claude Code or Codex into the most intelligent Deep Research Agent. Collect, search, and synthesize web research into a persistent, searchable wiki that builds on itself…. The licence is MIT.

When your agent uses it

  • The user asks for deep research
  • A research report
  • A literature review
  • A multi-source analysis with verified citations

Example prompts

  • “/deep-research”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Requires Python 3.11+ and the hyperresearch CLI (pip install hyperresearch), plus network access for fetching sources. Works in Claude Code and OpenAI Codex CLI; under Codex the session needs a writable workspace with network enabled.

Workflow steps

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

  1. Check the CLI
  2. Pick your branch

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • pip
    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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 Python 3.11+ and the hyperresearch CLI (pip install hyperresearch), plus network access for fetching sources. Works in Claude Code and OpenAI Codex CLI; under Codex the session needs a writable workspace with network enabled.

    From compatibility in the SKILL.md frontmatter.

Context cost

Deep Research loads about 1.2k tokens when it runs. Until then it costs about 124 tokens; SKILL.md has 595 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~124
When it runs · the whole SKILL.md, loaded when a task matches
~1.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 jordan-gibbs/hyperresearch at commit 9c16854, republished under its MIT licence (© jordan-gibbs). 595 words, ~1,240 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
Deep research with hyperresearch, for Claude Code and OpenAI Codex. Use when the user asks for deep research, a research report, a literature review, or a multi-source analysis with verified citations. Checks that the hyperresearch CLI is installed, sets it up in the current project for the agent you are running in, then hands off to the hyperresearch pipeline (a tier-adaptive 16-step pipeline with a persistent source vault). Not for quick lookups one or two searches can answer.
compatibility
Requires Python 3.11+ and the hyperresearch CLI (pip install hyperresearch), plus network access for fetching sources. Works in Claude Code and OpenAI Codex CLI; under Codex the session needs a writable workspace with network enabled.
license
MIT

Deep research with hyperresearch

This skill is a bootstrap. The research pipeline itself is an entry skill plus 16 step procedures and a set of subagents, which the hyperresearch Python package renders and installs into the project. This file does not contain the pipeline. Do not try to run the research from here, and do not answer the research question from your own knowledge: the pipeline is the deliverable.

1. Check the CLI

Run:

bash
hyperresearch --version

If the command is not found, stop and tell the user:

hyperresearch is not installed. Install it with pip install hyperresearch (Python 3.11 to 3.14), then ask again.

You may run pip install hyperresearch yourself only if the user says to.

2. Pick your branch

You know which agent you are. Follow exactly one branch.

  • Claude Code (you have Skill and Task tools): section 3A.
  • OpenAI Codex (you edit files with apply_patch, spawn custom agents, and skills are invoked as $name): section 3B.

If you genuinely cannot tell, look at the working directory: a .codex/ or .agents/ directory and no .claude/ means Codex; the reverse means Claude Code. Still unsure: ask the user which one they are using.

3A. Claude Code

If .claude/skills/hyperresearch/SKILL.md does not exist in the working directory, run:

bash
hyperresearch install . --json

This creates the vault (.hyperresearch/, research/), adds a short block to CLAUDE.md, and installs the entry skill, the 16 step skills, the subagents and a PreToolUse hook under .claude/. It is safe to re-run; it no-ops on files that are already current. Tell the user in one line what was installed.

Then invoke the installed router with the user's research request, verbatim:

Skill(skill: "hyperresearch", args: "<the user's research request>")

From then on, follow the hyperresearch skill. It owns the query, the tier choice, and every step.

If the hyperresearch skill is not available yet (Claude Code loads new subagents at session start, and some versions do the same for skills), tell the user that setup is done and ask them to restart Claude Code in this directory and run:

/hyperresearch <their research request>
Show full SKILL.md (268 more words)Show less

3B. OpenAI Codex

If .agents/skills/hyperresearch/SKILL.md does not exist in the working directory, run:

bash
hyperresearch install . --target codex --json

This creates the vault (.hyperresearch/, research/), adds a short block to AGENTS.md, and installs the entry skill at .agents/skills/hyperresearch/, the step procedures under .hyperresearch/codex/steps/, the custom agents under .codex/agents/, and a Stop hook in .codex/hooks.json. It is safe to re-run. Tell the user in one line what was installed.

If the install (or any later hyperresearch fetch) fails with a permission or network error, the session is sandboxed read-only or offline. Stop and tell the user to restart Codex with a writable workspace and network access, for example:

bash
codex --sandbox workspace-write -c sandbox_workspace_write.network_access=true

Then hand off. Codex discovers skills when a session starts, so a skill installed a moment ago may not be listed yet. The robust path is to read the entry skill directly and follow it:

  1. Read .agents/skills/hyperresearch/SKILL.md in full (for example cat .agents/skills/hyperresearch/SKILL.md).
  2. Follow it with the user's research request, verbatim, as the query. It is the same procedure $hyperresearch <request> would load. It owns the query, the tier choice, and every step, and each step tells you which procedure file under .hyperresearch/codex/steps/ to read next.

If $hyperresearch already appears in your skill list, invoking it with the request is equivalent. In later sessions the user can start a run directly with $hyperresearch <question>.

Two things differ from Claude Code, and the entry skill covers both: there is no browser lane (blocked fetches stay queued and are listed for the user at the end), and the Stop hook, once Codex trusts the project's hooks, will not let the session finish while a run is mid-pipeline.

© jordan-gibbs, 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/deep-research of jordan-gibbs/hyperresearch.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 9c16854

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 skilljordan-gibbs/hyperresearch3.8k—~1.2kAutomated safety check: PassMIT
Rival Search MCPdamionrashford/RivalSearchMCP132—~796Automated safety check: PassMIT
Deep Research MCP Guidepminervini/deep-research-mcp114—~5.8kAutomated safety check: PassMIT
Interceptor ResearchHacker-Valley-Media/Interceptor522—~3.8kAutomated safety check: PassCustom licence
Zotero Research AssistantBubble-OoO/zotero-research-assistant-skill117—~1.2kAutomated safety check: WarnNone
Researchstudy8677/repobrain1.3k—~128Automated safety check: PassMIT

Similar skills

  • Rival Search MCP

    damionrashford/RivalSearchMCP

    Deterministic deep research via RivalSearchMCP. An agent skill from damionrashford/RivalSearchMCP.

    132 GitHub stars~796 tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Deep Research MCP Guide

    pminervini/deep-research-mcp

    Explains how to run, integrate and debug the deep-research-mcp project through its CLI, Python API or MCP server, with OpenAI, Gemini and DR-Tulu backends.

    114 GitHub stars~5.8k tokensUpdated 12 days ago
    Research & ScienceAuto-check passed
  • Interceptor Research

    Hacker-Valley-Media/Interceptor

    Deep web-research methodology for the interceptor browser surface — investigate a topic the way researchers, intelligence analysts, investigative journalists, private investigators, and OSINT…

    522 GitHub stars~3.8k tokensUpdated 8 days ago
    Research & ScienceAuto-check passed
  • Zotero Research Assistant

    Bubble-OoO/zotero-research-assistant-skill

    Access and configure a user's local or cloud Zotero library without MCP by executing the bundled JSON CLI.

    117 GitHub stars~1.2k tokensUpdated 2 mo ago
    Research & ScienceAuto-check: warnings
  • Research

    study8677/repobrain

    Performs deep research on a topic via deepresearch. An agent skill from study8677/repobrain.

    1.3k GitHub stars~128 tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Super Research

    breakstageaxe61/genspark-claw

    Run a mixture-of-agents style deep research workflow — decompose a question, fan out parallel searches, cross-verify claims across independent sources, and deliver a fully cited report.

    169 GitHub stars~892 tokensUpdated 14 days ago
    Research & ScienceAuto-check passed

Questions about Deep Research

What does Deep Research do?

Deep research with hyperresearch, for Claude Code and OpenAI Codex. Deep Research is an agent skill from jordan-gibbs/hyperresearch. Deep research with hyperresearch, for Claude Code and OpenAI Codex.

When should I use Deep Research?

Deep Research fits situations like: the user asks for deep research; A research report; A literature review; A multi-source analysis with verified citations.

How do I install Deep Research in Claude Code?

Run `npx skills add jordan-gibbs/hyperresearch --skill deep-research -a claude-code`. Or copy the skill folder (skills/deep-research in jordan-gibbs/hyperresearch) 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 jordan-gibbs/hyperresearch --skill deep-research -a codex`. Or copy the skill folder (skills/deep-research in jordan-gibbs/hyperresearch) 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 jordan-gibbs/hyperresearch --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 the command-line tools its instructions call (pip and codex). Our summary lists: Python 3. Compatibility (from SKILL.md): Requires Python 3.11+ and the hyperresearch CLI (pip install hyperresearch), plus network access for fetching sources. Works in Claude Code and OpenAI Codex CLI; under Codex the session needs a writable workspace with network enabled..

Does Deep Research access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. 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. Review the folder before installing.

What licence does Deep Research use?

Deep Research is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deep Research use?

About 1.2k tokens (SKILL.md is roughly 5k 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?

Skills that share tags, products or a category with Deep Research: Rival Search MCP (damionrashford/RivalSearchMCP, 132 stars), Deep Research MCP Guide (pminervini/deep-research-mcp, 114 stars), Interceptor Research (Hacker-Valley-Media/Interceptor, 522 stars) and Zotero Research Assistant (Bubble-OoO/zotero-research-assistant-skill, 117 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research?

jordan-gibbs (a GitHub user) maintains it in jordan-gibbs/hyperresearch, which has 3,827 GitHub stars. The repository was last updated on October 10, 2026.

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