# weizhena/deep-research-skills architecture

> Architecture diagram of the GitHub repository weizhena/deep-research-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/weizhena/deep-research-skills
- Repository: https://github.com/weizhena/deep-research-skills

## Overview

This repository provides multilingual, platform-specific AI research skills. Its principal user workflow is to generate and optionally extend a research outline, investigate its items with web-search agents, then produce a Markdown report. The README documents these stages and agent usage; skill prompts and agent definitions were not sampled, so internal handoffs beyond those documented are not inferred. The four indexed validator scripts are separate implementations of JSON field-coverage validation.

Main entry points: [`skills/research-en/research-deep/SKILL.md`](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-deep/SKILL.md) (Investigate items), [`skills/research-en/research/SKILL.md`](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research/SKILL.md) (Generate outline), [`skills/research-en/research-add-items/SKILL.md`](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-add-items/SKILL.md) (Add research items), [`skills/research-en/research-add-fields/SKILL.md`](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-add-fields/SKILL.md) (Add field definitions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Research workflow"]
  node_outline["Generate outline<br/>[SKILL.md]"]
  node_add_items["Add research items<br/>[SKILL.md]"]
  node_add_fields["Add field definitions<br/>[SKILL.md]"]
  node_deep_research["Investigate items<br/>[SKILL.md]"]
  node_report["Generate report<br/>[SKILL.md]"]
  node_zh_skills["Chinese skills"]
  node_codex_en["Codex English skills"]
  node_codex_zh["Codex Chinese skills"]
end

subgraph group_agents["Web research agents"]
  node_opencode_agent["OpenCode search agent"]
  node_claude_agent["Claude search agent"]
  node_codex_agent["Codex researcher"]
  node_search_modules["Search modules"]
  node_codex_modules["Codex search modules"]
end

subgraph group_validation["JSON validation"]
  node_validator_en["English validator<br/>[validate_json.py]"]
  node_validator_zh["Chinese validator<br/>[validate_json.py]"]
  node_validator_codex_en["Codex English validator<br/>[validate_json.py]"]
  node_validator_codex_zh["Codex Chinese validator<br/>[validate_json.py]"]
end

node_user(("Researcher"))

node_user -->|"requests research"| node_outline
node_user -->|"extends outline"| node_add_items
node_user -->|"extends outline"| node_add_fields
node_user -->|"starts investigation"| node_deep_research
node_user -->|"requests report"| node_report
node_deep_research -->|"uses parallel agents"| node_claude_agent
node_deep_research -->|"uses search agent"| node_opencode_agent
node_deep_research -->|"uses researcher"| node_codex_agent

click node_outline "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research/SKILL.md"
click node_add_items "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-add-items/SKILL.md"
click node_add_fields "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-add-fields/SKILL.md"
click node_deep_research "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-deep/SKILL.md"
click node_report "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-report/SKILL.md"
click node_zh_skills "https://github.com/weizhena/deep-research-skills/tree/master/skills/research-zh"
click node_codex_en "https://github.com/weizhena/deep-research-skills/tree/master/skills/research-codex-en"
click node_codex_zh "https://github.com/weizhena/deep-research-skills/tree/master/skills/research-codex-zh"
click node_opencode_agent "https://github.com/weizhena/deep-research-skills/blob/master/agents/web-search-opencode.md"
click node_claude_agent "https://github.com/weizhena/deep-research-skills/blob/master/agents/web-search-agent.md"
click node_codex_agent "https://github.com/weizhena/deep-research-skills/blob/master/agents-codex/web-researcher.toml"
click node_search_modules "https://github.com/weizhena/deep-research-skills/tree/master/agents/web-search-modules"
click node_codex_modules "https://github.com/weizhena/deep-research-skills/tree/master/agents-codex/web-search-modules"
click node_validator_en "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research/validate_json.py"
click node_validator_zh "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-zh/research/validate_json.py"
click node_validator_codex_en "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-codex-en/research/validate_json.py"
click node_validator_codex_zh "https://github.com/weizhena/deep-research-skills/blob/master/skills/research-codex-zh/research/validate_json.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_outline,node_add_items,node_add_fields,node_deep_research,node_report,node_zh_skills,node_codex_en,node_codex_zh toneBlue
class node_opencode_agent,node_claude_agent,node_codex_agent,node_search_modules,node_codex_modules toneAmber
class node_validator_en,node_validator_zh,node_validator_codex_en,node_validator_codex_zh toneMint
class node_user toneIndigo
```

## Components

### Research workflow

- [Generate outline](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research/SKILL.md): `skills/research-en/research/SKILL.md`
- [Add research items](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-add-items/SKILL.md): `skills/research-en/research-add-items/SKILL.md`
- [Add field definitions](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-add-fields/SKILL.md): `skills/research-en/research-add-fields/SKILL.md`
- [Investigate items](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-deep/SKILL.md): `skills/research-en/research-deep/SKILL.md`
- [Generate report](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research-report/SKILL.md): `skills/research-en/research-report/SKILL.md`
- [Chinese skills](https://github.com/weizhena/deep-research-skills/tree/master/skills/research-zh): `skills/research-zh`
- [Codex English skills](https://github.com/weizhena/deep-research-skills/tree/master/skills/research-codex-en): `skills/research-codex-en`
- [Codex Chinese skills](https://github.com/weizhena/deep-research-skills/tree/master/skills/research-codex-zh): `skills/research-codex-zh`

### Web research agents

- [OpenCode search agent](https://github.com/weizhena/deep-research-skills/blob/master/agents/web-search-opencode.md): `agents/web-search-opencode.md`
- [Claude search agent](https://github.com/weizhena/deep-research-skills/blob/master/agents/web-search-agent.md): `agents/web-search-agent.md`
- [Codex researcher](https://github.com/weizhena/deep-research-skills/blob/master/agents-codex/web-researcher.toml): `agents-codex/web-researcher.toml`
- [Search modules](https://github.com/weizhena/deep-research-skills/tree/master/agents/web-search-modules): `agents/web-search-modules`
- [Codex search modules](https://github.com/weizhena/deep-research-skills/tree/master/agents-codex/web-search-modules): `agents-codex/web-search-modules`

### JSON validation

- [English validator](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-en/research/validate_json.py): `skills/research-en/research/validate_json.py`
- [Chinese validator](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-zh/research/validate_json.py): `skills/research-zh/research/validate_json.py`
- [Codex English validator](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-codex-en/research/validate_json.py): `skills/research-codex-en/research/validate_json.py`
- [Codex Chinese validator](https://github.com/weizhena/deep-research-skills/blob/master/skills/research-codex-zh/research/validate_json.py): `skills/research-codex-zh/research/validate_json.py`

### Other components

- **Researcher**

## Connections

- Researcher → Generate outline: requests research (evidence: `README.md`)
- Researcher → Add research items: extends outline (evidence: `README.md`)
- Researcher → Add field definitions: extends outline (evidence: `README.md`)
- Researcher → Investigate items: starts investigation (evidence: `README.md`)
- Researcher → Generate report: requests report (evidence: `README.md`)
- Investigate items → Claude search agent: uses parallel agents (evidence: `README.md`)
- Investigate items → OpenCode search agent: uses search agent (evidence: `README.md`)
- Investigate items → Codex researcher: uses researcher (evidence: `README.md`)