# google-deepmind/science-skills architecture

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

- Interactive diagram: https://gitdiagram.com/google-deepmind/science-skills
- Repository: https://github.com/google-deepmind/science-skills

## Overview

Science Skills is a collection of agent-facing scientific research capabilities, not one unified analysis pipeline. An agent selects a skill for a task; its scripts perform a focused lookup, search, analysis, or visualization and return results. The tree and README establish the collection’s scope, while sampled scripts confirm representative API and analysis behavior. Most individual skill instructions and scripts were not sampled, so the graph shows capability branches rather than inferred handoffs between them.

Main entry points: [`skills/embl_ebi_ols/scripts`](https://github.com/google-deepmind/science-skills/tree/main/skills/embl_ebi_ols/scripts) (Ontology lookup), [`skills/alphagenome_single_variant_analysis/scripts`](https://github.com/google-deepmind/science-skills/tree/main/skills/alphagenome_single_variant_analysis/scripts) (Variant analysis), [`skills/alphagenome_variant_impact_score/scripts/alphagenome_atlas_avi.py`](https://github.com/google-deepmind/science-skills/blob/main/skills/alphagenome_variant_impact_score/scripts/alphagenome_atlas_avi.py) (Variant impact score), [`skills/ucsc_conservation_and_tfbs/scripts`](https://github.com/google-deepmind/science-skills/tree/main/skills/ucsc_conservation_and_tfbs/scripts) (Genome tracks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_genomics["Genomics"]
  node_variant["Variant analysis"]
  node_impact["Variant impact score"]
  node_genomic_tracks["Genome tracks"]
  node_sequence["Sequence retrieval<br/>[ncbi_fetch.py]"]
end

subgraph group_structure["Structural Biology"]
  node_protein_search["Protein similarity<br/>[mmseqs2_search.py]"]
  node_msa["Sequence alignment<br/>[msa_align.py]"]
  node_foldseek["Structure search<br/>[search.py]"]
  node_alphafold["Structure analysis"]
  node_pdb["PDB search<br/>[search_pdb.py]"]
end

subgraph group_knowledge["Knowledge &amp; Literature"]
  node_ontology["Ontology lookup"]
  node_literature["Literature search<br/>[search_arxiv.py]"]
  node_pubmed["PubMed search<br/>[pubmed_api.py]"]
  node_preprints["Preprint search<br/>[search_by_dates.py]"]
  node_ols_client["OLS request utilities<br/>[ols_utils.py]"]
end

subgraph group_databases["Scientific Databases"]
  node_gene_resources["Gene resources<br/>[ensembl_api.py]"]
  node_variant_resources["Variant resources<br/>[clinvar_api.py]"]
  node_drug_resources["Drug resources<br/>[chembl_api.py]"]
  node_expression["Expression resources<br/>[gtex_cli.py]"]
end

subgraph group_analysis["Analysis Workflows"]
  node_predicting_past["Historical inference<br/>[run_inference.py]"]
end

node_researcher(("Research agent"))

node_researcher -->|"selects skill"| node_variant
node_researcher -->|"selects skill"| node_impact
node_researcher -->|"selects skill"| node_genomic_tracks
node_researcher -->|"selects skill"| node_sequence
node_researcher -->|"selects skill"| node_protein_search
node_researcher -->|"selects skill"| node_msa
node_researcher -->|"selects skill"| node_foldseek
node_researcher -->|"selects skill"| node_alphafold
node_researcher -->|"selects skill"| node_pdb
node_researcher -->|"selects skill"| node_ontology
node_researcher -->|"selects skill"| node_literature
node_researcher -->|"selects skill"| node_pubmed
node_researcher -->|"selects skill"| node_preprints
node_researcher -->|"selects skill"| node_gene_resources
node_researcher -->|"selects skill"| node_variant_resources
node_researcher -->|"selects skill"| node_drug_resources
node_researcher -->|"selects skill"| node_expression
node_researcher -->|"selects skill"| node_predicting_past
node_ontology -->|"uses utilities"| node_ols_client

click node_variant "https://github.com/google-deepmind/science-skills/tree/main/skills/alphagenome_single_variant_analysis/scripts"
click node_impact "https://github.com/google-deepmind/science-skills/blob/main/skills/alphagenome_variant_impact_score/scripts/alphagenome_atlas_avi.py"
click node_genomic_tracks "https://github.com/google-deepmind/science-skills/tree/main/skills/ucsc_conservation_and_tfbs/scripts"
click node_sequence "https://github.com/google-deepmind/science-skills/blob/main/skills/ncbi_sequence_fetch/scripts/ncbi_fetch.py"
click node_protein_search "https://github.com/google-deepmind/science-skills/blob/main/skills/protein_sequence_similarity_search/scripts/mmseqs2_search.py"
click node_msa "https://github.com/google-deepmind/science-skills/blob/main/skills/protein_sequence_msa/scripts/msa_align.py"
click node_foldseek "https://github.com/google-deepmind/science-skills/blob/main/skills/foldseek_structural_search/scripts/search.py"
click node_alphafold "https://github.com/google-deepmind/science-skills/tree/main/skills/alphafold_database_fetch_and_analyze/scripts"
click node_pdb "https://github.com/google-deepmind/science-skills/blob/main/skills/pdb_database/scripts/search_pdb.py"
click node_ontology "https://github.com/google-deepmind/science-skills/tree/main/skills/embl_ebi_ols/scripts"
click node_literature "https://github.com/google-deepmind/science-skills/blob/main/skills/literature_search_arxiv/scripts/search_arxiv.py"
click node_pubmed "https://github.com/google-deepmind/science-skills/blob/main/skills/pubmed_database/scripts/pubmed_api.py"
click node_preprints "https://github.com/google-deepmind/science-skills/blob/main/skills/literature_search_biorxiv/scripts/search_by_dates.py"
click node_gene_resources "https://github.com/google-deepmind/science-skills/blob/main/skills/ensembl_database/scripts/ensembl_api.py"
click node_variant_resources "https://github.com/google-deepmind/science-skills/blob/main/skills/clinvar_database/scripts/clinvar_api.py"
click node_drug_resources "https://github.com/google-deepmind/science-skills/blob/main/skills/chembl_database/scripts/chembl_api.py"
click node_expression "https://github.com/google-deepmind/science-skills/blob/main/skills/gtex_database/scripts/gtex_cli.py"
click node_predicting_past "https://github.com/google-deepmind/science-skills/blob/main/skills/predictingthepast/scripts/run_inference.py"
click node_ols_client "https://github.com/google-deepmind/science-skills/blob/main/skills/embl_ebi_ols/scripts/ols_utils.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_variant,node_impact,node_genomic_tracks,node_sequence toneBlue
class node_protein_search,node_msa,node_foldseek,node_alphafold,node_pdb toneAmber
class node_ontology,node_literature,node_pubmed,node_preprints,node_ols_client toneMint
class node_gene_resources,node_variant_resources,node_drug_resources,node_expression toneRose
class node_predicting_past,node_researcher toneIndigo
```

## Components

### Genomics

- [Variant analysis](https://github.com/google-deepmind/science-skills/tree/main/skills/alphagenome_single_variant_analysis/scripts): `skills/alphagenome_single_variant_analysis/scripts`
- [Variant impact score](https://github.com/google-deepmind/science-skills/blob/main/skills/alphagenome_variant_impact_score/scripts/alphagenome_atlas_avi.py): `skills/alphagenome_variant_impact_score/scripts/alphagenome_atlas_avi.py`
- [Genome tracks](https://github.com/google-deepmind/science-skills/tree/main/skills/ucsc_conservation_and_tfbs/scripts): `skills/ucsc_conservation_and_tfbs/scripts`
- [Sequence retrieval](https://github.com/google-deepmind/science-skills/blob/main/skills/ncbi_sequence_fetch/scripts/ncbi_fetch.py): `skills/ncbi_sequence_fetch/scripts/ncbi_fetch.py`

### Structural Biology

- [Protein similarity](https://github.com/google-deepmind/science-skills/blob/main/skills/protein_sequence_similarity_search/scripts/mmseqs2_search.py): `skills/protein_sequence_similarity_search/scripts/mmseqs2_search.py`
- [Sequence alignment](https://github.com/google-deepmind/science-skills/blob/main/skills/protein_sequence_msa/scripts/msa_align.py): `skills/protein_sequence_msa/scripts/msa_align.py`
- [Structure search](https://github.com/google-deepmind/science-skills/blob/main/skills/foldseek_structural_search/scripts/search.py): `skills/foldseek_structural_search/scripts/search.py`
- [Structure analysis](https://github.com/google-deepmind/science-skills/tree/main/skills/alphafold_database_fetch_and_analyze/scripts): `skills/alphafold_database_fetch_and_analyze/scripts`
- [PDB search](https://github.com/google-deepmind/science-skills/blob/main/skills/pdb_database/scripts/search_pdb.py): `skills/pdb_database/scripts/search_pdb.py`

### Knowledge & Literature

- [Ontology lookup](https://github.com/google-deepmind/science-skills/tree/main/skills/embl_ebi_ols/scripts): `skills/embl_ebi_ols/scripts`
- [Literature search](https://github.com/google-deepmind/science-skills/blob/main/skills/literature_search_arxiv/scripts/search_arxiv.py): `skills/literature_search_arxiv/scripts/search_arxiv.py`
- [PubMed search](https://github.com/google-deepmind/science-skills/blob/main/skills/pubmed_database/scripts/pubmed_api.py): `skills/pubmed_database/scripts/pubmed_api.py`
- [Preprint search](https://github.com/google-deepmind/science-skills/blob/main/skills/literature_search_biorxiv/scripts/search_by_dates.py): `skills/literature_search_biorxiv/scripts/search_by_dates.py`
- [OLS request utilities](https://github.com/google-deepmind/science-skills/blob/main/skills/embl_ebi_ols/scripts/ols_utils.py): `skills/embl_ebi_ols/scripts/ols_utils.py`

### Scientific Databases

- [Gene resources](https://github.com/google-deepmind/science-skills/blob/main/skills/ensembl_database/scripts/ensembl_api.py): `skills/ensembl_database/scripts/ensembl_api.py`
- [Variant resources](https://github.com/google-deepmind/science-skills/blob/main/skills/clinvar_database/scripts/clinvar_api.py): `skills/clinvar_database/scripts/clinvar_api.py`
- [Drug resources](https://github.com/google-deepmind/science-skills/blob/main/skills/chembl_database/scripts/chembl_api.py): `skills/chembl_database/scripts/chembl_api.py`
- [Expression resources](https://github.com/google-deepmind/science-skills/blob/main/skills/gtex_database/scripts/gtex_cli.py): `skills/gtex_database/scripts/gtex_cli.py`

### Analysis Workflows

- [Historical inference](https://github.com/google-deepmind/science-skills/blob/main/skills/predictingthepast/scripts/run_inference.py): `skills/predictingthepast/scripts/run_inference.py`

### Other components

- **Research agent**

## Connections

- Research agent → Variant analysis: selects skill (evidence: `README.md`)
- Research agent → Variant impact score: selects skill (evidence: `README.md`)
- Research agent → Genome tracks: selects skill (evidence: `README.md`)
- Research agent → Sequence retrieval: selects skill (evidence: `README.md`)
- Research agent → Protein similarity: selects skill (evidence: `README.md`)
- Research agent → Sequence alignment: selects skill (evidence: `README.md`)
- Research agent → Structure search: selects skill (evidence: `README.md`)
- Research agent → Structure analysis: selects skill (evidence: `README.md`)
- Research agent → PDB search: selects skill (evidence: `README.md`)
- Research agent → Ontology lookup: selects skill (evidence: `README.md`)
- Research agent → Literature search: selects skill (evidence: `README.md`)
- Research agent → PubMed search: selects skill (evidence: `README.md`)
- Research agent → Preprint search: selects skill (evidence: `README.md`)
- Research agent → Gene resources: selects skill (evidence: `README.md`)
- Research agent → Variant resources: selects skill (evidence: `README.md`)
- Research agent → Drug resources: selects skill (evidence: `README.md`)
- Research agent → Expression resources: selects skill (evidence: `README.md`)
- Research agent → Historical inference: selects skill (evidence: `README.md`)
- Ontology lookup → OLS request utilities: uses utilities (evidence: `skills/embl_ebi_ols/scripts/search_ols.py`)
