Hyperresearch Deep Research
Runs a cited multi-source research pipeline with the hyperresearch CLI.
Install
npx skills add jordan-gibbs/hyperresearch --skill deep-research -g -a claude-code -y- Repository
- jordan-gibbs/hyperresearch4.3k
- Category
- AI and agents
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 1,042 tokens
- Runs scripts
- No, instructions only
What it does
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.
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:
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
SkillandTasktools): 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:
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.
