# deonticai/deontic-skills architecture

> Architecture diagram of the GitHub repository deonticai/deontic-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/deonticai/deontic-skills
- Repository: https://github.com/deonticai/deontic-skills

## Overview

This repository packages four Claude skills for creating, expanding, editing, and visualizing driving scenarios. The documented user workflow is to enable a skill with the Deontic MCP server connected, make a request, and receive generated scenario files or a video download link. ODD generation adds an attribute proposal and user-approval stage before file creation. Only README relationships are shown; skill internals and the exact MCP call flow are not available in source excerpts.

Main entry points: [`deontic-odd-scenario-generator/SKILL.md`](https://github.com/deonticai/deontic-skills/blob/main/deontic-odd-scenario-generator/SKILL.md) (ODD scenario generator), [`deontic-scenario-generator/SKILL.md`](https://github.com/deonticai/deontic-skills/blob/main/deontic-scenario-generator/SKILL.md) (Scenario generator), [`deontic-scenario-editor/SKILL.md`](https://github.com/deonticai/deontic-skills/blob/main/deontic-scenario-editor/SKILL.md) (Scenario editor), [`deontic-video-creator/SKILL.md`](https://github.com/deonticai/deontic-skills/blob/main/deontic-video-creator/SKILL.md) (Video creator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scenario_creation["Scenario creation"]
  node_scenario_skill["Scenario generator<br/>[SKILL.md]"]
  node_scenario_files["OpenDRIVE and OpenSCENARIO files"]
end

subgraph group_odd_generation["ODD generation"]
  node_odd_skill["ODD scenario generator<br/>[SKILL.md]"]
  node_odd_proposals["Scenario attribute proposals"]
  node_odd_files["ODD scenario files"]
end

subgraph group_scenario_editing["Scenario editing"]
  node_editor_skill["Scenario editor<br/>[SKILL.md]"]
  node_updated_scenario["Updated scenario"]
end

subgraph group_video_creation["Video creation"]
  node_video_skill["Video creator<br/>[SKILL.md]"]
  node_scenario_video["Scenario video"]
end

node_user(("User"))
node_claude["Claude skill runtime"]
node_mcp["Deontic MCP server"]

node_user -->|"requests scenario"| node_claude
node_claude -->|"triggers on request"| node_scenario_skill
node_scenario_skill -.->|"uses server"| node_mcp
node_scenario_skill -->|"creates files"| node_scenario_files
node_user -->|"requests ODD set"| node_claude
node_claude -->|"triggers on request"| node_odd_skill
node_odd_skill -->|"suggests attributes"| node_odd_proposals
node_odd_proposals -->|"requests approval"| node_user
node_user -->|"approves attributes"| node_odd_skill
node_odd_skill -.->|"uses server"| node_mcp
node_odd_skill -->|"creates files"| node_odd_files
node_user -->|"gives feedback"| node_claude
node_claude -->|"triggers on feedback"| node_editor_skill
node_editor_skill -.->|"uses server"| node_mcp
node_editor_skill -->|"edits scenario"| node_updated_scenario
node_user -->|"requests video"| node_claude
node_claude -->|"triggers on request"| node_video_skill
node_video_skill -.->|"uses server"| node_mcp
node_video_skill -->|"creates video"| node_scenario_video

click node_scenario_skill "https://github.com/deonticai/deontic-skills/blob/main/deontic-scenario-generator/SKILL.md"
click node_odd_skill "https://github.com/deonticai/deontic-skills/blob/main/deontic-odd-scenario-generator/SKILL.md"
click node_editor_skill "https://github.com/deonticai/deontic-skills/blob/main/deontic-scenario-editor/SKILL.md"
click node_video_skill "https://github.com/deonticai/deontic-skills/blob/main/deontic-video-creator/SKILL.md"

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_scenario_skill,node_scenario_files,node_user toneBlue
class node_odd_skill,node_odd_proposals,node_odd_files toneAmber
class node_editor_skill,node_updated_scenario,node_mcp toneMint
class node_video_skill,node_scenario_video toneRose
class node_claude toneIndigo
```

## Components

### Scenario creation

- [Scenario generator](https://github.com/deonticai/deontic-skills/blob/main/deontic-scenario-generator/SKILL.md): `deontic-scenario-generator/SKILL.md`
- **OpenDRIVE and OpenSCENARIO files**

### ODD generation

- [ODD scenario generator](https://github.com/deonticai/deontic-skills/blob/main/deontic-odd-scenario-generator/SKILL.md): `deontic-odd-scenario-generator/SKILL.md`
- **Scenario attribute proposals**
- **ODD scenario files**

### Scenario editing

- [Scenario editor](https://github.com/deonticai/deontic-skills/blob/main/deontic-scenario-editor/SKILL.md): `deontic-scenario-editor/SKILL.md`
- **Updated scenario**

### Video creation

- [Video creator](https://github.com/deonticai/deontic-skills/blob/main/deontic-video-creator/SKILL.md): `deontic-video-creator/SKILL.md`
- **Scenario video**

### Other components

- **User**
- **Claude skill runtime**
- **Deontic MCP server**

## Connections

- User → Claude skill runtime: requests scenario (evidence: `README.md`)
- Claude skill runtime → Scenario generator: triggers on request (evidence: `README.md`)
- Scenario generator → Deontic MCP server: uses server (evidence: `README.md`)
- Scenario generator → OpenDRIVE and OpenSCENARIO files: creates files (evidence: `README.md`)
- User → Claude skill runtime: requests ODD set (evidence: `README.md`)
- Claude skill runtime → ODD scenario generator: triggers on request (evidence: `README.md`)
- ODD scenario generator → Scenario attribute proposals: suggests attributes (evidence: `README.md`)
- Scenario attribute proposals → User: requests approval (evidence: `README.md`)
- User → ODD scenario generator: approves attributes (evidence: `README.md`)
- ODD scenario generator → Deontic MCP server: uses server (evidence: `README.md`)
- ODD scenario generator → ODD scenario files: creates files (evidence: `README.md`)
- User → Claude skill runtime: gives feedback (evidence: `README.md`)
- Claude skill runtime → Scenario editor: triggers on feedback (evidence: `README.md`)
- Scenario editor → Deontic MCP server: uses server (evidence: `README.md`)
- Scenario editor → Updated scenario: edits scenario (evidence: `README.md`)
- User → Claude skill runtime: requests video (evidence: `README.md`)
- Claude skill runtime → Video creator: triggers on request (evidence: `README.md`)
- Video creator → Deontic MCP server: uses server (evidence: `README.md`)
- Video creator → Scenario video: creates video (evidence: `README.md`)
