# oracle/skills architecture

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

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

## Overview

Oracle Skills is a curated, installable knowledge repository for Oracle technologies—not a single application runtime. The documented workflow is for a developer or agent to choose a domain, install that domain’s skills, then use its entry point to find relevant guidance. The graph preserves the major domain capability areas described in the README. Evidence is based on the README, tree, and sampled APEXlang source; unsampled domain internals are represented only at documented directory level.

Main entry points: [`oci`](https://github.com/oracle/skills/tree/main/oci) (OCI guidance), [`README.md`](https://github.com/oracle/skills/blob/main/README.md) (Choose a domain), [`db`](https://github.com/oracle/skills/tree/main/db) (Database guidance), [`apex`](https://github.com/oracle/skills/tree/main/apex) (APEX guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Selection and install"]
  node_domain_choice["Choose a domain<br/>[README.md]"]
  node_skills_cli["Skills installer"]
  node_claude_marketplace["Claude marketplace<br/>[marketplace.json]"]
end

subgraph group_database["Database skills"]
  node_db["Database guidance"]
  node_db_topics["Database topics"]
end

subgraph group_cloud["Cloud skills"]
  node_oci["OCI guidance"]
  node_oci_ai["Enterprise AI"]
  node_oci_functions["Functions"]
  node_oci_oke["Kubernetes Engine"]
  node_oci_iot["IoT Platform"]
end

subgraph group_other["Other Oracle skills"]
  node_apex["APEX guidance"]
  node_apexlang["APEXlang workflows"]
  node_apexlang_runtime["APEXlang runtime"]
  node_fusion["Fusion skills"]
  node_graal["GraalVM guidance"]
  node_native_image["Native Image"]
end

node_user(("Developer or agent"))

node_user -->|"selects"| node_domain_choice
node_domain_choice -->|"installs with"| node_skills_cli
node_domain_choice -.->|"may install via"| node_claude_marketplace
node_skills_cli -->|"installs"| node_db
node_skills_cli -->|"installs"| node_oci
node_skills_cli -->|"installs"| node_apex
node_skills_cli -->|"installs"| node_fusion
node_skills_cli -->|"installs"| node_graal
node_db -->|"routes to"| node_db_topics
node_oci -->|"routes to"| node_oci_ai
node_oci -->|"routes to"| node_oci_functions
node_oci -->|"routes to"| node_oci_oke
node_oci -->|"routes to"| node_oci_iot
node_apex -->|"includes"| node_apexlang
node_apexlang -->|"provides runtime"| node_apexlang_runtime
node_graal -->|"routes to"| node_native_image

click node_domain_choice "https://github.com/oracle/skills/blob/main/README.md"
click node_claude_marketplace "https://github.com/oracle/skills/blob/main/.claude-plugin/marketplace.json"
click node_db "https://github.com/oracle/skills/tree/main/db"
click node_db_topics "https://github.com/oracle/skills/tree/main/db"
click node_oci "https://github.com/oracle/skills/tree/main/oci"
click node_oci_ai "https://github.com/oracle/skills/tree/main/oci/enterprise-ai"
click node_oci_functions "https://github.com/oracle/skills/tree/main/oci/functions"
click node_oci_oke "https://github.com/oracle/skills/tree/main/oci/oke"
click node_oci_iot "https://github.com/oracle/skills/tree/main/oci/iot-platform"
click node_apex "https://github.com/oracle/skills/tree/main/apex"
click node_apexlang "https://github.com/oracle/skills/tree/main/apex/apexlang"
click node_apexlang_runtime "https://github.com/oracle/skills/tree/main/apex/apexlang/runtime"
click node_fusion "https://github.com/oracle/skills/tree/main/fusion"
click node_graal "https://github.com/oracle/skills/tree/main/graal"
click node_native_image "https://github.com/oracle/skills/tree/main/graal/native-image"

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_domain_choice,node_skills_cli,node_claude_marketplace toneBlue
class node_db,node_db_topics toneAmber
class node_oci,node_oci_ai,node_oci_functions,node_oci_oke,node_oci_iot toneMint
class node_apex,node_apexlang,node_apexlang_runtime,node_fusion,node_graal,node_native_image toneRose
class node_user toneIndigo
```

## Components

### Selection and install

- [Choose a domain](https://github.com/oracle/skills/blob/main/README.md): `README.md`
- **Skills installer**
- [Claude marketplace](https://github.com/oracle/skills/blob/main/.claude-plugin/marketplace.json): `.claude-plugin/marketplace.json`

### Database skills

- [Database guidance](https://github.com/oracle/skills/tree/main/db): `db`
- [Database topics](https://github.com/oracle/skills/tree/main/db): `db`

### Cloud skills

- [OCI guidance](https://github.com/oracle/skills/tree/main/oci): `oci`
- [Enterprise AI](https://github.com/oracle/skills/tree/main/oci/enterprise-ai): `oci/enterprise-ai`
- [Functions](https://github.com/oracle/skills/tree/main/oci/functions): `oci/functions`
- [Kubernetes Engine](https://github.com/oracle/skills/tree/main/oci/oke): `oci/oke`
- [IoT Platform](https://github.com/oracle/skills/tree/main/oci/iot-platform): `oci/iot-platform`

### Other Oracle skills

- [APEX guidance](https://github.com/oracle/skills/tree/main/apex): `apex`
- [APEXlang workflows](https://github.com/oracle/skills/tree/main/apex/apexlang): `apex/apexlang`
- [APEXlang runtime](https://github.com/oracle/skills/tree/main/apex/apexlang/runtime): `apex/apexlang/runtime`
- [Fusion skills](https://github.com/oracle/skills/tree/main/fusion): `fusion`
- [GraalVM guidance](https://github.com/oracle/skills/tree/main/graal): `graal`
- [Native Image](https://github.com/oracle/skills/tree/main/graal/native-image): `graal/native-image`

### Other components

- **Developer or agent**

## Connections

- Developer or agent → Choose a domain: selects
- Choose a domain → Skills installer: installs with
- Choose a domain → Claude marketplace: may install via
- Skills installer → Database guidance: installs
- Skills installer → OCI guidance: installs
- Skills installer → APEX guidance: installs
- Skills installer → Fusion skills: installs
- Skills installer → GraalVM guidance: installs
- Database guidance → Database topics: routes to
- OCI guidance → Enterprise AI: routes to
- OCI guidance → Functions: routes to
- OCI guidance → Kubernetes Engine: routes to
- OCI guidance → IoT Platform: routes to
- APEX guidance → APEXlang workflows: includes
- APEXlang workflows → APEXlang runtime: provides runtime
- GraalVM guidance → Native Image: routes to