Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
Structured deep research skill for Claude Code/Open Code/Codex with human-in-the-loop control
Saved setup from 5 h ago
Will it work on Linux?
The maintainers included scripts/install-codex.sh. Run it from the cloned folder after reading it.
bash scripts/install-codex.sh
git clone https://github.com/Weizhena/deep-research-skills.git
cd deep-research-skills
# English version
cp -r skills/research-en/* ~/.claude/skills/
# Chinese version
cp -r skills/research-zh/* ~/.claude/skills/
# Required: Install agent and modules
cp agents/web-search-agent.md ~/.claude/agents/
cp -r agents/web-search-modules ~/.claude/agents/
# Required: Install Python dependency
pip install pyyaml
# Skills (same as Claude Code)
cp -r skills/research-en/* ~/.claude/skills/ # or research-zh for Chinese
# Required: Enable web search for current shell
export OPENCODE_ENABLE_EXA=1
# Optional: make it permanent
echo 'export OPENCODE_ENABLE_EXA=1' >> ~/.bashrc
source ~/.bashrc
# Required: Install agent and modules
cp agents/web-search-opencode.md ~/.config/opencode/agents/web-search.md
cp -r agents/web-search-modules ~/.config/opencode/agents/
# Required: Install Python dependency
pip install pyyaml
Important: In OpenCode, ANY model's websearch requires
OPENCODE_ENABLE_EXA=1. A plainexportonly affects the current shell; writing it to~/.bashrcmakes it persistent. Without it, you only getweb fetch, which is weaker for the deep research phase.
# English version
mkdir -p ~/.codex/skills ~/.codex/agents
cp -r skills/research-codex-en/* ~/.codex/skills/
# Chinese version
mkdir -p ~/.codex/skills ~/.codex/agents
cp -r skills/research-codex-zh/* ~/.codex/skills/
# Required: Install web researcher agent and modules
cp agents-codex/web-researcher.toml ~/.codex/agents/
cp -r agents-codex/web-search-modules ~/.codex/agents/
# Required: Install Python dependency
pip install pyyaml
Add or update ~/.codex/config.toml using either method below:
Option A: Automatic script
cd deep-research-skills
bash scripts/install-codex.sh
Option B: Manual edit
suppress_unstable_features_warning = true
[features]
multi_agent = true
default_mode_request_user_input = true
[agents.web_researcher]
description = "Use this agent when you need to research information on the internet, particularly for debugging issues, finding solutions to technical problems, or gathering comprehensive information from multiple sources. This agent excels at finding relevant discussions. Use when you need creative search strategies, thorough investigation, or compilation of findings from multiple sources."
config_file = "agents/web-researcher.toml"
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
git clone https://github.com/Weizhena/Deep-Research-skills.git cd Deep-Research-skills
Python 3
sudo apt install python3 python3-pip
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
cp -r skills/research-en/* ~/.claude/skills/ cp -r skills/research-zh/* ~/.claude/skills/ cp agents/web-search-agent.md ~/.claude/agents/ cp -r agents/web-search-modules ~/.claude/agents/ pip install pyyaml cp -r skills/research-en/* ~/.claude/skills/ # or research-zh for Chinese export OPENCODE_ENABLE_EXA=1 echo 'export OPENCODE_ENABLE_EXA=1' >> ~/.bashrc source ~/.bashrc cp agents/web-search-opencode.md ~/.config/opencode/agents/web-search.md cp -r agents/web-search-modules ~/.config/opencode/agents/ pip install pyyaml mkdir -p ~/.codex/skills ~/.codex/agents cp -r skills/research-codex-en/* ~/.codex/skills/ mkdir -p ~/.codex/skills ~/.codex/agents cp -r skills/research-codex-zh/* ~/.codex/skills/ cp agents-codex/web-researcher.toml ~/.codex/agents/ cp -r agents-codex/web-search-modules ~/.codex/agents/ pip install pyyaml bash scripts/install-codex.sh
No reports for Linux yet.
GitManual AI Agent reads the 1 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.