# k-dense-ai/scientific-agent-skills architecture

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

- Interactive diagram: https://gitdiagram.com/k-dense-ai/scientific-agent-skills
- Repository: https://github.com/k-dense-ai/scientific-agent-skills

## Overview

Scientific Agent Skills is a portable library of procedural knowledge for compatible AI agents, spanning 177 scientific and research skills. The principal workflow is that a scientist asks an agent for research help, the agent loads relevant skill guidance, and applies its conventions and validation checks while using scientific packages, databases, or tools. The graph highlights major documented domains and required central modules; most skill implementations were not sampled, so the README supports the broad capability links but not detailed calls between skills.

Main entry points: [`skills`](https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills) (Bioinformatics skills), [`skills/alphagenome/scripts/atlas_query.py`](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/alphagenome/scripts/atlas_query.py) (Atlas queries), [`skills/geniml/scripts/embedding_plan.py`](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/geniml/scripts/embedding_plan.py) (Genomic embeddings), [`skills/neurokit2/scripts/ecg_hrv_pipeline.py`](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/neurokit2/scripts/ecg_hrv_pipeline.py) (Biosignal workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bio["Bio and genomics"]
  node_bio_skills["Bioinformatics skills"]
  node_atlas["Atlas queries<br/>[atlas_query.py]"]
  node_gene_embeddings["Genomic embeddings<br/>[embedding_plan.py]"]
  node_neuro_workflows["Biosignal workflows"]
  node_neuro_pipeline["Neural recordings"]
end

subgraph group_research["Research and evidence"]
  node_research_skills["Research lookup<br/>[research_lookup.py]"]
  node_manuscript_packet["Manuscript packets"]
  node_literature["Literature search"]
  node_citations["Citation search<br/>[search_pubmed.py]"]
  node_peer_review["Peer review"]
  node_brainstorming["Hypothesis development"]
end

subgraph group_analysis["Data and analysis"]
  node_eda["Data exploration"]
  node_single_cell["Single-cell analysis<br/>[run_pipeline.py]"]
  node_visualization["Scientific visualization<br/>[figure_export.py]"]
  node_palette["Palette auditing<br/>[palette_audit.py]"]
  node_styles["Style presets<br/>[style_presets.py]"]
  node_shared_safety["Shared CLI safety<br/>[_common.py]"]
end

subgraph group_science["Scientific domains"]
  node_materials["Materials queries<br/>[mp_query.py]"]
  node_chemistry["Chemistry and drug discovery"]
  node_geospatial["Geospatial workflows"]
end

subgraph group_communication["Communication"]
  node_writing["Scientific writing"]
  node_visual_communication["Scientific communication"]
end

node_scientist(("Scientist"))
node_agent(("Compatible AI agent"))

node_scientist -->|"requests research"| node_agent
node_agent -->|"loads relevant skills"| node_bio_skills
node_agent -->|"loads relevant skills"| node_research_skills
node_agent -->|"loads relevant skills"| node_eda
node_agent -->|"loads relevant skills"| node_single_cell
node_agent -->|"loads relevant skills"| node_visualization
node_agent -->|"loads relevant skills"| node_materials
node_agent -->|"loads relevant skills"| node_writing
node_agent -->|"loads relevant skills"| node_visual_communication
node_agent -->|"uses specialist guidance"| node_atlas
node_agent -->|"uses specialist guidance"| node_gene_embeddings
node_agent -->|"uses specialist guidance"| node_neuro_workflows
node_agent -->|"uses specialist guidance"| node_neuro_pipeline
node_agent -->|"uses specialist guidance"| node_manuscript_packet
node_agent -->|"uses specialist guidance"| node_literature
node_agent -->|"uses specialist guidance"| node_citations
node_agent -->|"uses specialist guidance"| node_peer_review
node_agent -->|"uses specialist guidance"| node_brainstorming
node_agent -->|"uses relevant skills"| node_chemistry
node_agent -->|"uses relevant skills"| node_geospatial
node_agent -->|"uses specialist guidance"| node_palette
node_agent -->|"uses specialist guidance"| node_styles
node_agent -.->|"uses shared helpers"| node_shared_safety

click node_bio_skills "https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills"
click node_atlas "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/alphagenome/scripts/atlas_query.py"
click node_gene_embeddings "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/geniml/scripts/embedding_plan.py"
click node_neuro_workflows "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/neurokit2/scripts/ecg_hrv_pipeline.py"
click node_neuro_pipeline "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/neuropixels-analysis/scripts/neuropixels_pipeline.py"
click node_research_skills "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/research-lookup/scripts/research_lookup.py"
click node_manuscript_packet "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/research-lookup/scripts/manuscript_packet.py"
click node_literature "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/literature-review/scripts/search_databases.py"
click node_citations "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/citation-management/scripts/search_pubmed.py"
click node_peer_review "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/peer-review/scripts/validate_review_intake.py"
click node_brainstorming "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-brainstorming/scripts/session_scaffold.py"
click node_eda "https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/exploratory-data-analysis/scripts"
click node_single_cell "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scanpy/scripts/run_pipeline.py"
click node_visualization "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-visualization/scripts/figure_export.py"
click node_palette "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-visualization/scripts/palette_audit.py"
click node_styles "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-visualization/scripts/style_presets.py"
click node_materials "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/pymatgen/scripts/mp_query.py"
click node_chemistry "https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/rdkit/scripts"
click node_geospatial "https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/geopandas/scripts"
click node_writing "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-writing/scripts/validate_authorship.py"
click node_visual_communication "https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/scientific-slides/scripts"
click node_shared_safety "https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/gtars/scripts/_common.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_bio_skills,node_atlas,node_gene_embeddings,node_neuro_workflows,node_neuro_pipeline toneBlue
class node_research_skills,node_manuscript_packet,node_literature,node_citations,node_peer_review,node_brainstorming toneAmber
class node_eda,node_single_cell,node_visualization,node_palette,node_styles,node_shared_safety toneMint
class node_materials,node_chemistry,node_geospatial toneRose
class node_writing,node_visual_communication,node_scientist,node_agent toneIndigo
```

## Components

### Bio and genomics

- [Bioinformatics skills](https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills): `skills`
- [Atlas queries](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/alphagenome/scripts/atlas_query.py): `skills/alphagenome/scripts/atlas_query.py`
- [Genomic embeddings](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/geniml/scripts/embedding_plan.py): `skills/geniml/scripts/embedding_plan.py`
- [Biosignal workflows](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/neurokit2/scripts/ecg_hrv_pipeline.py): `skills/neurokit2/scripts/ecg_hrv_pipeline.py`
- [Neural recordings](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/neuropixels-analysis/scripts/neuropixels_pipeline.py): `skills/neuropixels-analysis/scripts/neuropixels_pipeline.py`

### Research and evidence

- [Research lookup](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/research-lookup/scripts/research_lookup.py): `skills/research-lookup/scripts/research_lookup.py`
- [Manuscript packets](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/research-lookup/scripts/manuscript_packet.py): `skills/research-lookup/scripts/manuscript_packet.py`
- [Literature search](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/literature-review/scripts/search_databases.py): `skills/literature-review/scripts/search_databases.py`
- [Citation search](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/citation-management/scripts/search_pubmed.py): `skills/citation-management/scripts/search_pubmed.py`
- [Peer review](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/peer-review/scripts/validate_review_intake.py): `skills/peer-review/scripts/validate_review_intake.py`
- [Hypothesis development](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-brainstorming/scripts/session_scaffold.py): `skills/scientific-brainstorming/scripts/session_scaffold.py`

### Data and analysis

- [Data exploration](https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/exploratory-data-analysis/scripts): `skills/exploratory-data-analysis/scripts`
- [Single-cell analysis](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scanpy/scripts/run_pipeline.py): `skills/scanpy/scripts/run_pipeline.py`
- [Scientific visualization](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-visualization/scripts/figure_export.py): `skills/scientific-visualization/scripts/figure_export.py`
- [Palette auditing](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-visualization/scripts/palette_audit.py): `skills/scientific-visualization/scripts/palette_audit.py`
- [Style presets](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-visualization/scripts/style_presets.py): `skills/scientific-visualization/scripts/style_presets.py`
- [Shared CLI safety](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/gtars/scripts/_common.py): `skills/gtars/scripts/_common.py`

### Scientific domains

- [Materials queries](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/pymatgen/scripts/mp_query.py): `skills/pymatgen/scripts/mp_query.py`
- [Chemistry and drug discovery](https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/rdkit/scripts): `skills/rdkit/scripts`
- [Geospatial workflows](https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/geopandas/scripts): `skills/geopandas/scripts`

### Communication

- [Scientific writing](https://github.com/k-dense-ai/scientific-agent-skills/blob/main/skills/scientific-writing/scripts/validate_authorship.py): `skills/scientific-writing/scripts/validate_authorship.py`
- [Scientific communication](https://github.com/k-dense-ai/scientific-agent-skills/tree/main/skills/scientific-slides/scripts): `skills/scientific-slides/scripts`

### Other components

- **Scientist**
- **Compatible AI agent**

## Connections

- Scientist → Compatible AI agent: requests research (evidence: `README.md`)
- Compatible AI agent → Bioinformatics skills: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Research lookup: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Data exploration: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Single-cell analysis: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Scientific visualization: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Materials queries: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Scientific writing: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Scientific communication: loads relevant skills (evidence: `README.md`)
- Compatible AI agent → Atlas queries: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Genomic embeddings: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Biosignal workflows: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Neural recordings: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Manuscript packets: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Literature search: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Citation search: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Peer review: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Hypothesis development: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Chemistry and drug discovery: uses relevant skills (evidence: `README.md`)
- Compatible AI agent → Geospatial workflows: uses relevant skills (evidence: `README.md`)
- Compatible AI agent → Palette auditing: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Style presets: uses specialist guidance (evidence: `README.md`)
- Compatible AI agent → Shared CLI safety: uses shared helpers
