# open-medica/open-medical-skills architecture

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

- Interactive diagram: https://gitdiagram.com/open-medica/open-medical-skills
- Repository: https://github.com/open-medica/open-medical-skills

## Overview

Open Medical Skills is a physician-reviewed marketplace of medical AI skills and plugins. The main user workflow is to search or browse the catalog, inspect a skill, then install it for an AI coding agent; the CLI can also validate skills and find related skills through the remote API. The repository additionally contains clinical skill implementations and healthcare integrations. Several plugin implementations are not sampled, so their capabilities are represented at the documented subsystem level; no internal plugin call paths are inferred.

Main entry points: [`cli/bin/oms.js`](https://github.com/open-medica/open-medical-skills/blob/main/cli/bin/oms.js) (OMS CLI), [`cli/lib/api-client.js`](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/api-client.js) (OMS API Client), [`cli/lib/skills.js`](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/skills.js) (Search and Catalog), [`cli/lib/installer.js`](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/installer.js) (Agent Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Marketplace CLI"]
  node_cli["OMS CLI<br/>[oms.js]"]
  node_skill_search["Search and Catalog<br/>[skills.js]"]
  node_api["OMS API Client<br/>[api-client.js]"]
  node_config[("Config and Cache<br/>[config.js]")]
  node_presentation["CLI Presentation<br/>[format.js]"]
  node_banner["CLI Banner<br/>[banner.js]"]
  node_installer["Agent Installer<br/>[installer.js]"]
  node_disclaimer["Safety Disclaimer<br/>[disclaimer.js]"]
end

subgraph group_catalog["Clinical Skills"]
  node_skill_catalog["Medical Skill Catalog"]
  node_clinical_tools["Clinical Skill Tools"]
end

subgraph group_integrations["Healthcare Integrations"]
  node_healthcare_suite["Healthcare MCP Suite"]
  node_healthlake["AWS HealthLake FHIR"]
  node_openemr["OpenEMR Integration"]
  node_medikode["Medical Coding Platform"]
  node_api_service["Coding API Service"]
end

node_user(("Clinician or Developer"))
node_remote_api["OpenMedica API"]

node_user -->|"runs commands"| node_cli
node_cli -->|"searches and inspects"| node_skill_search
node_cli -->|"validates and relates"| node_api
node_cli -->|"formats output"| node_presentation
node_cli -->|"prints banner"| node_banner
node_cli -->|"installs skills"| node_installer
node_cli -->|"prints disclaimer"| node_disclaimer
node_cli -->|"loads skill content"| node_skill_catalog
node_skill_search -->|"searches and inspects"| node_api
node_skill_search -->|"reads and writes cache"| node_config
node_api -->|"reads API settings"| node_config
node_api -->|"sends requests"| node_remote_api
node_installer -->|"prints disclaimer"| node_disclaimer
node_skill_catalog -.->|"provides clinical skills"| node_clinical_tools
node_medikode -->|"forwards API requests"| node_api_service

click node_cli "https://github.com/open-medica/open-medical-skills/blob/main/cli/bin/oms.js"
click node_skill_search "https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/skills.js"
click node_api "https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/api-client.js"
click node_config "https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/config.js"
click node_presentation "https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/format.js"
click node_banner "https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/banner.js"
click node_installer "https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/installer.js"
click node_disclaimer "https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/disclaimer.js"
click node_skill_catalog "https://github.com/open-medica/open-medical-skills/tree/main/skills"
click node_clinical_tools "https://github.com/open-medica/open-medical-skills/tree/main/skills"
click node_healthcare_suite "https://github.com/open-medica/open-medical-skills/tree/main/plugins/healthcare-mcp-comprehensive/src"
click node_healthlake "https://github.com/open-medica/open-medical-skills/tree/main/plugins/aws-healthlake-fhir/src/awslabs/healthlake_mcp_server"
click node_openemr "https://github.com/open-medica/open-medical-skills/tree/main/plugins/openemr-integration/src/openemr_mcp"
click node_medikode "https://github.com/open-medica/open-medical-skills/tree/main/plugins/medikode-medical-coding-platform/src"

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_cli,node_skill_search,node_api,node_config,node_presentation,node_banner,node_installer,node_disclaimer toneBlue
class node_skill_catalog,node_clinical_tools toneAmber
class node_healthcare_suite,node_healthlake,node_openemr,node_medikode,node_api_service,node_remote_api toneMint
class node_user toneIndigo
```

## Components

### Marketplace CLI

- [OMS CLI](https://github.com/open-medica/open-medical-skills/blob/main/cli/bin/oms.js): `cli/bin/oms.js`
- [Search and Catalog](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/skills.js): `cli/lib/skills.js`
- [OMS API Client](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/api-client.js): `cli/lib/api-client.js`
- [Config and Cache](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/config.js): `cli/lib/config.js`
- [CLI Presentation](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/format.js): `cli/lib/format.js`
- [CLI Banner](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/banner.js): `cli/lib/banner.js`
- [Agent Installer](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/installer.js): `cli/lib/installer.js`
- [Safety Disclaimer](https://github.com/open-medica/open-medical-skills/blob/main/cli/lib/disclaimer.js): `cli/lib/disclaimer.js`

### Clinical Skills

- [Medical Skill Catalog](https://github.com/open-medica/open-medical-skills/tree/main/skills): `skills`
- [Clinical Skill Tools](https://github.com/open-medica/open-medical-skills/tree/main/skills): `skills`

### Healthcare Integrations

- [Healthcare MCP Suite](https://github.com/open-medica/open-medical-skills/tree/main/plugins/healthcare-mcp-comprehensive/src): `plugins/healthcare-mcp-comprehensive/src`
- [AWS HealthLake FHIR](https://github.com/open-medica/open-medical-skills/tree/main/plugins/aws-healthlake-fhir/src/awslabs/healthlake_mcp_server): `plugins/aws-healthlake-fhir/src/awslabs/healthlake_mcp_server`
- [OpenEMR Integration](https://github.com/open-medica/open-medical-skills/tree/main/plugins/openemr-integration/src/openemr_mcp): `plugins/openemr-integration/src/openemr_mcp`
- [Medical Coding Platform](https://github.com/open-medica/open-medical-skills/tree/main/plugins/medikode-medical-coding-platform/src): `plugins/medikode-medical-coding-platform/src`
- **Coding API Service**

### Other components

- **Clinician or Developer**
- **OpenMedica API**

## Connections

- Clinician or Developer → OMS CLI: runs commands (evidence: `README.md`)
- OMS CLI → Search and Catalog: searches and inspects (evidence: `cli/bin/oms.js`)
- OMS CLI → OMS API Client: validates and relates (evidence: `cli/bin/oms.js`)
- OMS CLI → CLI Presentation: formats output (evidence: `cli/bin/oms.js`)
- OMS CLI → CLI Banner: prints banner (evidence: `cli/bin/oms.js`)
- OMS CLI → Agent Installer: installs skills (evidence: `cli/bin/oms.js`)
- OMS CLI → Safety Disclaimer: prints disclaimer (evidence: `cli/bin/oms.js`)
- OMS CLI → Medical Skill Catalog: loads skill content (evidence: `cli/bin/oms.js`)
- Search and Catalog → OMS API Client: searches and inspects (evidence: `cli/lib/skills.js`)
- Search and Catalog → Config and Cache: reads and writes cache (evidence: `cli/lib/skills.js`)
- OMS API Client → Config and Cache: reads API settings (evidence: `cli/lib/api-client.js`)
- OMS API Client → OpenMedica API: sends requests (evidence: `cli/lib/api-client.js`)
- Agent Installer → Safety Disclaimer: prints disclaimer (evidence: `cli/lib/installer.js`)
- Medical Skill Catalog → Clinical Skill Tools: provides clinical skills (evidence: `README.md`)
- Medical Coding Platform → Coding API Service: forwards API requests (evidence: `plugins/medikode-medical-coding-platform/src/services/apiServiceRouter.js`)
