# voidful/academic-skills architecture

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

- Interactive diagram: https://gitdiagram.com/voidful/academic-skills
- Repository: https://github.com/voidful/academic-skills

## Overview

Academic Research Skills is a documentation-driven skill suite for AI agents, not a conventional runtime application. A researcher activates the root skill or a platform command, then uses specialist skills across professor-fit analysis, paper reading, idea generation, experiment design, proof writing, paper writing, and review. The README documents the research pipeline and review-to-writing revision loop; it also describes root-level skill discovery and Claude command routing. References, templates, and shared guidance support these skills, but their specific use relationships are not documented here.

Main entry points: [`SKILL.md`](https://github.com/voidful/academic-skills/blob/main/SKILL.md) (Skill Entry), [`CLAUDE.md`](https://github.com/voidful/academic-skills/blob/main/CLAUDE.md) (Claude Router), [`paper-writing/SKILL.md`](https://github.com/voidful/academic-skills/blob/main/paper-writing/SKILL.md) (Paper Writing), [`paper-reading/SKILL.md`](https://github.com/voidful/academic-skills/blob/main/paper-reading/SKILL.md) (Paper Reading)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Research Discovery"]
  node_professor_fit["Professor Fit<br/>[SKILL.md]"]
  node_paper_reading["Paper Reading<br/>[SKILL.md]"]
  node_idea_generation["Idea Generation<br/>[SKILL.md]"]
end

subgraph group_development["Research Development"]
  node_experiment_design["Experiment Design<br/>[SKILL.md]"]
  node_proof_writer["Proof Writer<br/>[SKILL.md]"]
end

subgraph group_publication["Publication"]
  node_paper_writing["Paper Writing<br/>[SKILL.md]"]
  node_paper_review["Paper Review<br/>[SKILL.md]"]
end

subgraph group_guidance["Shared Guidance"]
  node_shared_guidance["Shared Guidance"]
end

node_researcher(("Researcher"))
node_root_skill["Skill Entry<br/>[SKILL.md]"]
node_claude_router["Claude Router<br/>[CLAUDE.md]"]

node_researcher -->|"activates"| node_root_skill
node_root_skill -->|"discovers"| node_paper_reading
node_root_skill -->|"discovers"| node_idea_generation
node_root_skill -->|"discovers"| node_experiment_design
node_root_skill -->|"discovers"| node_proof_writer
node_root_skill -->|"discovers"| node_paper_writing
node_root_skill -->|"discovers"| node_paper_review
node_root_skill -->|"discovers"| node_professor_fit
node_researcher -->|"uses commands"| node_claude_router
node_claude_router -->|"routes commands"| node_paper_reading
node_claude_router -->|"routes commands"| node_idea_generation
node_claude_router -->|"routes commands"| node_experiment_design
node_claude_router -->|"routes commands"| node_proof_writer
node_claude_router -->|"routes commands"| node_paper_writing
node_claude_router -->|"routes commands"| node_paper_review
node_claude_router -->|"routes commands"| node_professor_fit
node_professor_fit -->|"precedes"| node_paper_reading
node_paper_reading -->|"informs"| node_idea_generation
node_idea_generation -->|"precedes"| node_experiment_design
node_experiment_design -->|"precedes"| node_proof_writer
node_proof_writer -->|"precedes"| node_paper_writing
node_paper_writing -->|"submits to"| node_paper_review
node_paper_review -->|"returns revisions"| node_paper_writing

click node_root_skill "https://github.com/voidful/academic-skills/blob/main/SKILL.md"
click node_claude_router "https://github.com/voidful/academic-skills/blob/main/CLAUDE.md"
click node_professor_fit "https://github.com/voidful/academic-skills/blob/main/professor-fit-analyser/SKILL.md"
click node_paper_reading "https://github.com/voidful/academic-skills/blob/main/paper-reading/SKILL.md"
click node_idea_generation "https://github.com/voidful/academic-skills/blob/main/idea-generation/SKILL.md"
click node_experiment_design "https://github.com/voidful/academic-skills/blob/main/experiment-design/SKILL.md"
click node_proof_writer "https://github.com/voidful/academic-skills/blob/main/proof-writer/SKILL.md"
click node_paper_writing "https://github.com/voidful/academic-skills/blob/main/paper-writing/SKILL.md"
click node_paper_review "https://github.com/voidful/academic-skills/blob/main/paper-review/SKILL.md"
click node_shared_guidance "https://github.com/voidful/academic-skills/tree/main/shared"

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_professor_fit,node_paper_reading,node_idea_generation toneBlue
class node_experiment_design,node_proof_writer toneAmber
class node_paper_writing,node_paper_review,node_claude_router toneMint
class node_shared_guidance toneRose
class node_researcher toneIndigo
class node_root_skill toneTeal
```

## Components

### Research Discovery

- [Professor Fit](https://github.com/voidful/academic-skills/blob/main/professor-fit-analyser/SKILL.md): `professor-fit-analyser/SKILL.md`
- [Paper Reading](https://github.com/voidful/academic-skills/blob/main/paper-reading/SKILL.md): `paper-reading/SKILL.md`
- [Idea Generation](https://github.com/voidful/academic-skills/blob/main/idea-generation/SKILL.md): `idea-generation/SKILL.md`

### Research Development

- [Experiment Design](https://github.com/voidful/academic-skills/blob/main/experiment-design/SKILL.md): `experiment-design/SKILL.md`
- [Proof Writer](https://github.com/voidful/academic-skills/blob/main/proof-writer/SKILL.md): `proof-writer/SKILL.md`

### Publication

- [Paper Writing](https://github.com/voidful/academic-skills/blob/main/paper-writing/SKILL.md): `paper-writing/SKILL.md`
- [Paper Review](https://github.com/voidful/academic-skills/blob/main/paper-review/SKILL.md): `paper-review/SKILL.md`

### Shared Guidance

- [Shared Guidance](https://github.com/voidful/academic-skills/tree/main/shared): `shared`

### Other components

- **Researcher**
- [Skill Entry](https://github.com/voidful/academic-skills/blob/main/SKILL.md): `SKILL.md`
- [Claude Router](https://github.com/voidful/academic-skills/blob/main/CLAUDE.md): `CLAUDE.md`

## Connections

- Researcher → Skill Entry: activates (evidence: `README.md`)
- Skill Entry → Paper Reading: discovers (evidence: `README.md`)
- Skill Entry → Idea Generation: discovers (evidence: `README.md`)
- Skill Entry → Experiment Design: discovers (evidence: `README.md`)
- Skill Entry → Proof Writer: discovers (evidence: `README.md`)
- Skill Entry → Paper Writing: discovers (evidence: `README.md`)
- Skill Entry → Paper Review: discovers (evidence: `README.md`)
- Skill Entry → Professor Fit: discovers (evidence: `README.md`)
- Researcher → Claude Router: uses commands (evidence: `README.md`)
- Claude Router → Paper Reading: routes commands (evidence: `README.md`)
- Claude Router → Idea Generation: routes commands (evidence: `README.md`)
- Claude Router → Experiment Design: routes commands (evidence: `README.md`)
- Claude Router → Proof Writer: routes commands (evidence: `README.md`)
- Claude Router → Paper Writing: routes commands (evidence: `README.md`)
- Claude Router → Paper Review: routes commands (evidence: `README.md`)
- Claude Router → Professor Fit: routes commands (evidence: `README.md`)
- Professor Fit → Paper Reading: precedes (evidence: `README.md`)
- Paper Reading → Idea Generation: informs (evidence: `README.md`)
- Idea Generation → Experiment Design: precedes (evidence: `README.md`)
- Experiment Design → Proof Writer: precedes (evidence: `README.md`)
- Proof Writer → Paper Writing: precedes (evidence: `README.md`)
- Paper Writing → Paper Review: submits to (evidence: `README.md`)
- Paper Review → Paper Writing: returns revisions (evidence: `README.md`)