# aipoch/medical-research-skills architecture

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

- Interactive diagram: https://gitdiagram.com/aipoch/medical-research-skills
- Repository: https://github.com/aipoch/medical-research-skills

## Overview

Medical Research Agent Skills is a curated collection of 550+ independently invoked, SKILL.md-compatible tools for biomedical researchers, rather than one integrated application. A researcher’s broad workflow moves from evidence discovery to protocol design, data analysis, and academic communication; individual skills perform focused tasks and return artifacts. The graph preserves those documented domains plus sampled implementations for PubMed search, trial discovery, and poster output. Most skill-to-skill orchestration is not shown, so category transitions are documented relationships, not claims of runtime calls.

Main entry points: [`scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/clinical_trial_finder.py) (Trial Finder CLI), [`scientific-skills/Evidence Insight/reference-search/scripts/pubmed_search.py`](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/reference-search/scripts/pubmed_search.py) (PubMed Search), [`scientific-skills/Evidence Insight/clinical-trial-finder/writers.py`](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/writers.py) (Trial Reports), [`scientific-skills/Evidence Insight`](https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Evidence%20Insight) (Evidence Skills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_evidence["Evidence Insight"]
  node_pubmed["PubMed Search<br/>[pubmed_search.py]"]
  node_trial_cli["Trial Finder CLI"]
  node_trial_api["Trial API Client<br/>[api.py]"]
  node_trial_writers["Trial Reports<br/>[writers.py]"]
  node_trial_constants["Trial Mappings<br/>[constants.py]"]
  node_opentargets["Gene Lookup<br/>[opentargets.py]"]
  node_gwas["GWAS Bridge<br/>[gwas_bridge.py]"]
  node_euctr["EU Trial Search<br/>[euctr.py]"]
  node_evidence_skills["Evidence Skills"]
end

subgraph group_protocol["Protocol Design"]
  node_protocol_skills["Study Planning"]
  node_trial_feasibility["Trial Feasibility<br/>[trial_pipeline.py]"]
end

subgraph group_analysis["Data Analysis"]
  node_analysis_skills["Analysis Skills"]
end

subgraph group_writing["Academic Writing"]
  node_writing_skills["Writing Skills"]
  node_abstract_writer["Abstract Writer<br/>[main.py]"]
  node_journal_matcher["Journal Matcher<br/>[main.py]"]
end

subgraph group_other["Other Skills"]
  node_poster_generator["Poster Generator<br/>[main.py]"]
  node_pptx_validator["PPTX Validator<br/>[pptx.py]"]
  node_other_skills["General Skills"]
end

node_researcher(("Researcher / Agent"))

node_researcher -->|"invokes search"| node_pubmed
node_pubmed -->|"returns results"| node_researcher
node_researcher -->|"runs query"| node_trial_cli
node_trial_cli -->|"fetches trials"| node_trial_api
node_trial_cli -->|"resolves genes"| node_opentargets
node_trial_cli -->|"resolves variants"| node_gwas
node_trial_cli -->|"optionally searches"| node_euctr
node_trial_cli -->|"writes outputs"| node_trial_writers
node_trial_writers -->|"uses mappings"| node_trial_constants
node_trial_cli -->|"uses constants"| node_trial_constants
node_researcher -->|"discovers evidence"| node_evidence_skills
node_evidence_skills -->|"informs study design"| node_protocol_skills
node_protocol_skills -.->|"supports research"| node_analysis_skills
node_analysis_skills -.->|"supports reporting"| node_writing_skills
node_researcher -->|"assesses feasibility"| node_trial_feasibility
node_researcher -.->|"drafts abstract"| node_abstract_writer
node_researcher -.->|"matches journal"| node_journal_matcher
node_researcher -->|"creates poster"| node_poster_generator
node_poster_generator -->|"validates output"| node_pptx_validator
node_researcher -->|"uses other tools"| node_other_skills

click node_pubmed "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/reference-search/scripts/pubmed_search.py"
click node_trial_cli "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/clinical_trial_finder.py"
click node_trial_api "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/api.py"
click node_trial_writers "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/writers.py"
click node_trial_constants "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/constants.py"
click node_opentargets "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/opentargets.py"
click node_gwas "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/gwas_bridge.py"
click node_euctr "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/euctr.py"
click node_evidence_skills "https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Evidence%20Insight"
click node_protocol_skills "https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Protocol%20Design"
click node_trial_feasibility "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Protocol%20Design/tooluniverse-clinical-trial-design/trial_pipeline.py"
click node_analysis_skills "https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Data%20Analysis"
click node_writing_skills "https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Academic%20Writing"
click node_abstract_writer "https://github.com/aipoch/medical-research-skills/blob/main/awesome-med-research-skills/Academic%20Writing/conference-abstract-writer/scripts/main.py"
click node_journal_matcher "https://github.com/aipoch/medical-research-skills/blob/main/awesome-med-research-skills/Academic%20Writing/target-journal-matcher/scripts/main.py"
click node_poster_generator "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Other/pptx-posters/scripts/main.py"
click node_pptx_validator "https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Other/PPTX-Skill/scripts/office/validators/pptx.py"
click node_other_skills "https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Other"

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_pubmed,node_trial_cli,node_trial_api,node_trial_writers,node_trial_constants,node_opentargets,node_gwas,node_euctr,node_evidence_skills toneBlue
class node_protocol_skills,node_trial_feasibility toneAmber
class node_analysis_skills toneMint
class node_writing_skills,node_abstract_writer,node_journal_matcher toneRose
class node_poster_generator,node_pptx_validator,node_other_skills,node_researcher toneIndigo
```

## Components

### Evidence Insight

- [PubMed Search](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/reference-search/scripts/pubmed_search.py): `scientific-skills/Evidence Insight/reference-search/scripts/pubmed_search.py`
- [Trial Finder CLI](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/clinical_trial_finder.py): `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`
- [Trial API Client](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/api.py): `scientific-skills/Evidence Insight/clinical-trial-finder/api.py`
- [Trial Reports](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/writers.py): `scientific-skills/Evidence Insight/clinical-trial-finder/writers.py`
- [Trial Mappings](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/constants.py): `scientific-skills/Evidence Insight/clinical-trial-finder/constants.py`
- [Gene Lookup](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/opentargets.py): `scientific-skills/Evidence Insight/clinical-trial-finder/opentargets.py`
- [GWAS Bridge](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/gwas_bridge.py): `scientific-skills/Evidence Insight/clinical-trial-finder/gwas_bridge.py`
- [EU Trial Search](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Evidence%20Insight/clinical-trial-finder/euctr.py): `scientific-skills/Evidence Insight/clinical-trial-finder/euctr.py`
- [Evidence Skills](https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Evidence%20Insight): `scientific-skills/Evidence Insight`

### Protocol Design

- [Study Planning](https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Protocol%20Design): `scientific-skills/Protocol Design`
- [Trial Feasibility](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Protocol%20Design/tooluniverse-clinical-trial-design/trial_pipeline.py): `scientific-skills/Protocol Design/tooluniverse-clinical-trial-design/trial_pipeline.py`

### Data Analysis

- [Analysis Skills](https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Data%20Analysis): `scientific-skills/Data Analysis`

### Academic Writing

- [Writing Skills](https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Academic%20Writing): `scientific-skills/Academic Writing`
- [Abstract Writer](https://github.com/aipoch/medical-research-skills/blob/main/awesome-med-research-skills/Academic%20Writing/conference-abstract-writer/scripts/main.py): `awesome-med-research-skills/Academic Writing/conference-abstract-writer/scripts/main.py`
- [Journal Matcher](https://github.com/aipoch/medical-research-skills/blob/main/awesome-med-research-skills/Academic%20Writing/target-journal-matcher/scripts/main.py): `awesome-med-research-skills/Academic Writing/target-journal-matcher/scripts/main.py`

### Other Skills

- [Poster Generator](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Other/pptx-posters/scripts/main.py): `scientific-skills/Other/pptx-posters/scripts/main.py`
- [PPTX Validator](https://github.com/aipoch/medical-research-skills/blob/main/scientific-skills/Other/PPTX-Skill/scripts/office/validators/pptx.py): `scientific-skills/Other/PPTX-Skill/scripts/office/validators/pptx.py`
- [General Skills](https://github.com/aipoch/medical-research-skills/tree/main/scientific-skills/Other): `scientific-skills/Other`

### Other components

- **Researcher / Agent**

## Connections

- Researcher / Agent → PubMed Search: invokes search
- PubMed Search → Researcher / Agent: returns results (evidence: `scientific-skills/Evidence Insight/reference-search/scripts/pubmed_search.py`)
- Researcher / Agent → Trial Finder CLI: runs query (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`)
- Trial Finder CLI → Trial API Client: fetches trials (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`)
- Trial Finder CLI → Gene Lookup: resolves genes (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`)
- Trial Finder CLI → GWAS Bridge: resolves variants (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`)
- Trial Finder CLI → EU Trial Search: optionally searches (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`)
- Trial Finder CLI → Trial Reports: writes outputs (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`)
- Trial Reports → Trial Mappings: uses mappings (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/writers.py`)
- Trial Finder CLI → Trial Mappings: uses constants (evidence: `scientific-skills/Evidence Insight/clinical-trial-finder/clinical_trial_finder.py`)
- Researcher / Agent → Evidence Skills: discovers evidence (evidence: `README.md`)
- Evidence Skills → Study Planning: informs study design (evidence: `README.md`)
- Study Planning → Analysis Skills: supports research
- Analysis Skills → Writing Skills: supports reporting
- Researcher / Agent → Trial Feasibility: assesses feasibility (evidence: `scientific-skills/Protocol Design/tooluniverse-clinical-trial-design/trial_pipeline.py`)
- Researcher / Agent → Abstract Writer: drafts abstract
- Researcher / Agent → Journal Matcher: matches journal
- Researcher / Agent → Poster Generator: creates poster (evidence: `scientific-skills/Other/pptx-posters/scripts/main.py`)
- Poster Generator → PPTX Validator: validates output (evidence: `scientific-skills/Other/pptx-posters/scripts/main.py`)
- Researcher / Agent → General Skills: uses other tools (evidence: `README.md`)
