Overview
This post is a deep-dive investigation into Deep-Research-skills, a structured research workflow skill library for agentic coding platforms.
- Project: Deep-Research-skills
- Author: Weizhena | License: MIT
- GitHub: https://github.com/Weizhena/Deep-Research-skills
- Target platforms: Claude Code (2.1.0+), OpenCode, Codex
- Use cases: academic research, technical comparison, market analysis, due diligence
- Inspired by the paper *RhinoInsight: Improving Deep Research through Control Mechanisms for Model Behavior and Context* (arXiv:2511.18743, DeepLang AI + Tsinghua University, Nov 2025), which proposes a Verifiable Checklist module and an Evidence Audit module.
- Replaces the linear plan → search → write → report pipeline with a controlled non-linear process to avoid error accumulation and context rot.
- Three principles: two-phase architecture (outline + deep dive), human-in-the-loop (confirmation at each key step), and resumability (JSON files as persistent intermediate state).
- outline.yaml: topic, items (name/category/description), execution config (batch_size, items_per_agent, output_dir).
- fields.yaml: field definitions (name/description/category/detail_level: minimal / brief / detailed) plus an
uncertainarray. - JSON results mark unverifiable values as
"[不确定]"; both flat and category-nested structures are supported. - validate_json.py checks field coverage and JSON validity:
python validate_json.py -f {fields_path} -j {json_path} - Reports skip uncertain fields, only publishing confirmed information.
- Claude Code: copy skills to
~/.claude/skills/, agents to~/.claude/agents/; requirespip install pyyaml. - OpenCode: same skill paths; agents to
~/.config/opencode/agents/; must setOPENCODE_ENABLE_EXA=1for websearch. - Codex: skills to
~/.codex/skills/, agents to~/.codex/agents/; requires enabling multi_agent in~/.codex/config.toml, or use/scripts/install-codex.sh.
Key points
Design philosophy
Skill architecture (5 skills)
| Command | Purpose |
|---------|---------|
| /research | Generate a research outline with items and fields |
| /research-add-items | Add more research objects to the outline |
| /research-add-fields | Add more field definitions |
| /research-deep | Deep-dive each item with parallel agents |
| /research-report | Generate a markdown report from JSON results |
Workflow: outline generation → human confirmation → batched parallel deep research (with checkpoint resume via output_dir/*.json) → validation → report generation.
Search agents
A mainweb-search-agent.md routes to 5 strategy modules in web-search-modules/:| Module | Sources | |--------|---------| | academic-papers | Google Scholar, arXiv, Semantic Scholar | | chinese-tech | CSDN, Juejin, Zhihu, V2EX | | github-debug | GitHub Issues, README, Releases | | stackoverflow | Stack Overflow, Stack Exchange | | general-web | Reddit, official docs, blogs, Hacker News |
Supports mixed Chinese/English searching; field values are output in Chinese.
Data structures
Quality control (3 layers)
1. Field coverage checks via validate_json.py 2. Human confirmation pauses after each batch 3. Automatic filtering of uncertain values in reportsPlatform installation
OpenClaw adaptation
The author verified an OpenClaw deployment (2026-05-27) with four changes: 1. Path remapping to~/.openclaw/skills/research-zh/
2. Tool substitution: WebSearch→kimi_search, WebFetch→kimi_fetch, Task→sessions_spawn, plus a new feishu_ask_user_question for human confirmation
3. Wrapping the 5 skills into a unified /deep-flow <topic> entry point with a 5-step closed loop
4. OpenClaw allowed-tools configuration (e.g., Read,Write,exec,kimi_search,kimi_fetch,feishu_ask_user_question)Known limitations: no native slash-command support, constrained sub-agent parallelism, differing rate limits requiring batch_size tuning, feishu confirmation only on Feishu channels, and minor YAML frontmatter differences.
Conclusion
Deep-Research-skills demonstrates how academic control-mechanism research can be engineered into practical agentic workflows: YAML-driven outlines, resumable JSON state, parallel search agents, and layered quality gates make long-running research auditable and extensible across multiple agent platforms.