# hkustdial/supervisor-skills architecture

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

- Interactive diagram: https://gitdiagram.com/hkustdial/supervisor-skills
- Repository: https://github.com/hkustdial/supervisor-skills

## Overview

Supervisor-Skills is a repository of research guidance and reusable AI skill prompts, not a running application. A researcher consults the handbook for background and uses an AI assistant with a selected skill to evaluate ideas, research literature, plan or draft papers, polish and review writing, design figures, or prepare rebuttals. These are distinct capabilities rather than a required linear pipeline. Draw.io reconstruction is a separate optional skill. The README documents this product map; sampled source was limited to utility scripts, so internal skill-to-skill wiring is not asserted.

Main entry points: [`handbook`](https://github.com/hkustdial/supervisor-skills/tree/main/handbook) (Handbook), [`skills/idea-evaluator/SKILL.md`](https://github.com/hkustdial/supervisor-skills/blob/main/skills/idea-evaluator/SKILL.md) (Idea Evaluator), [`skills/deep-research/SKILL.md`](https://github.com/hkustdial/supervisor-skills/blob/main/skills/deep-research/SKILL.md) (Deep Research), [`skills/vibe-research-workflow/SKILL.md`](https://github.com/hkustdial/supervisor-skills/blob/main/skills/vibe-research-workflow/SKILL.md) (Vibe Research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guides["Research Guides"]
  node_handbook["Handbook"]
end

subgraph group_research["Research Skills"]
  node_idea_evaluator["Idea Evaluator<br/>[SKILL.md]"]
  node_deep_research["Deep Research<br/>[SKILL.md]"]
  node_vibe_workflow["Vibe Research<br/>[SKILL.md]"]
end

subgraph group_writing["Writing Skills"]
  node_tech_template["Tech Paper Template<br/>[SKILL.md]"]
  node_benchmark_template["Benchmark Template<br/>[SKILL.md]"]
  node_intro_drafter["Intro Drafter<br/>[SKILL.md]"]
  node_paper_writer["Paper Writer<br/>[SKILL.md]"]
  node_paper_polish["Paper Polish<br/>[SKILL.md]"]
end

subgraph group_review_visual["Review And Visual"]
  node_submission_reviewer["Submission Reviewer<br/>[SKILL.md]"]
  node_figure_designer["Figure Designer<br/>[SKILL.md]"]
  node_rebuttal["Rebuttal Guidance<br/>[SKILL.md]"]
  node_drawio["Draw.io Reconstruction<br/>[SKILL.md]"]
end

node_researcher(("Researcher"))
node_assistant["AI Assistant"]

node_researcher -->|"consults"| node_handbook
node_researcher -->|"requests help"| node_assistant
node_assistant -->|"uses skill"| node_idea_evaluator
node_assistant -->|"uses skill"| node_deep_research
node_assistant -->|"uses skill"| node_vibe_workflow
node_assistant -->|"uses skill"| node_tech_template
node_assistant -->|"uses skill"| node_benchmark_template
node_assistant -->|"uses skill"| node_intro_drafter
node_assistant -->|"uses skill"| node_paper_writer
node_assistant -->|"uses skill"| node_paper_polish
node_assistant -->|"uses skill"| node_submission_reviewer
node_assistant -->|"uses skill"| node_figure_designer
node_assistant -->|"uses skill"| node_rebuttal
node_assistant -.->|"uses skill"| node_drawio

click node_handbook "https://github.com/hkustdial/supervisor-skills/tree/main/handbook"
click node_idea_evaluator "https://github.com/hkustdial/supervisor-skills/blob/main/skills/idea-evaluator/SKILL.md"
click node_deep_research "https://github.com/hkustdial/supervisor-skills/blob/main/skills/deep-research/SKILL.md"
click node_vibe_workflow "https://github.com/hkustdial/supervisor-skills/blob/main/skills/vibe-research-workflow/SKILL.md"
click node_tech_template "https://github.com/hkustdial/supervisor-skills/blob/main/skills/tech-paper-template/SKILL.md"
click node_benchmark_template "https://github.com/hkustdial/supervisor-skills/blob/main/skills/benchmark-paper-template/SKILL.md"
click node_intro_drafter "https://github.com/hkustdial/supervisor-skills/blob/main/skills/intro-drafter/SKILL.md"
click node_paper_writer "https://github.com/hkustdial/supervisor-skills/blob/main/skills/paper-writer/SKILL.md"
click node_paper_polish "https://github.com/hkustdial/supervisor-skills/blob/main/skills/paper-polish/SKILL.md"
click node_submission_reviewer "https://github.com/hkustdial/supervisor-skills/blob/main/skills/pre-submission-reviewer/SKILL.md"
click node_figure_designer "https://github.com/hkustdial/supervisor-skills/blob/main/skills/figure-designer/SKILL.md"
click node_rebuttal "https://github.com/hkustdial/supervisor-skills/blob/main/skills/rebuttal-guidance/SKILL.md"
click node_drawio "https://github.com/hkustdial/supervisor-skills/blob/main/skills/drawio-reconstruction/SKILL.md"

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_handbook toneBlue
class node_idea_evaluator,node_deep_research,node_vibe_workflow toneAmber
class node_tech_template,node_benchmark_template,node_intro_drafter,node_paper_writer,node_paper_polish toneMint
class node_submission_reviewer,node_figure_designer,node_rebuttal,node_drawio toneRose
class node_researcher,node_assistant toneIndigo
```

## Components

### Research Guides

- [Handbook](https://github.com/hkustdial/supervisor-skills/tree/main/handbook): `handbook`

### Research Skills

- [Idea Evaluator](https://github.com/hkustdial/supervisor-skills/blob/main/skills/idea-evaluator/SKILL.md): `skills/idea-evaluator/SKILL.md`
- [Deep Research](https://github.com/hkustdial/supervisor-skills/blob/main/skills/deep-research/SKILL.md): `skills/deep-research/SKILL.md`
- [Vibe Research](https://github.com/hkustdial/supervisor-skills/blob/main/skills/vibe-research-workflow/SKILL.md): `skills/vibe-research-workflow/SKILL.md`

### Writing Skills

- [Tech Paper Template](https://github.com/hkustdial/supervisor-skills/blob/main/skills/tech-paper-template/SKILL.md): `skills/tech-paper-template/SKILL.md`
- [Benchmark Template](https://github.com/hkustdial/supervisor-skills/blob/main/skills/benchmark-paper-template/SKILL.md): `skills/benchmark-paper-template/SKILL.md`
- [Intro Drafter](https://github.com/hkustdial/supervisor-skills/blob/main/skills/intro-drafter/SKILL.md): `skills/intro-drafter/SKILL.md`
- [Paper Writer](https://github.com/hkustdial/supervisor-skills/blob/main/skills/paper-writer/SKILL.md): `skills/paper-writer/SKILL.md`
- [Paper Polish](https://github.com/hkustdial/supervisor-skills/blob/main/skills/paper-polish/SKILL.md): `skills/paper-polish/SKILL.md`

### Review And Visual

- [Submission Reviewer](https://github.com/hkustdial/supervisor-skills/blob/main/skills/pre-submission-reviewer/SKILL.md): `skills/pre-submission-reviewer/SKILL.md`
- [Figure Designer](https://github.com/hkustdial/supervisor-skills/blob/main/skills/figure-designer/SKILL.md): `skills/figure-designer/SKILL.md`
- [Rebuttal Guidance](https://github.com/hkustdial/supervisor-skills/blob/main/skills/rebuttal-guidance/SKILL.md): `skills/rebuttal-guidance/SKILL.md`
- [Draw.io Reconstruction](https://github.com/hkustdial/supervisor-skills/blob/main/skills/drawio-reconstruction/SKILL.md): `skills/drawio-reconstruction/SKILL.md`

### Other components

- **Researcher**
- **AI Assistant**

## Connections

- Researcher → Handbook: consults
- Researcher → AI Assistant: requests help
- AI Assistant → Idea Evaluator: uses skill
- AI Assistant → Deep Research: uses skill
- AI Assistant → Vibe Research: uses skill
- AI Assistant → Tech Paper Template: uses skill
- AI Assistant → Benchmark Template: uses skill
- AI Assistant → Intro Drafter: uses skill
- AI Assistant → Paper Writer: uses skill
- AI Assistant → Paper Polish: uses skill
- AI Assistant → Submission Reviewer: uses skill
- AI Assistant → Figure Designer: uses skill
- AI Assistant → Rebuttal Guidance: uses skill
- AI Assistant → Draw.io Reconstruction: uses skill