# joshbricel/claude-omni-skills architecture

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

- Interactive diagram: https://gitdiagram.com/joshbricel/claude-omni-skills
- Repository: https://github.com/joshbricel/claude-omni-skills

## Overview

This repository packages three Claude Code skills for Omni analytics work: branch creation, semantic-layer setup, and Tableau-to-Omni migration. The migration workflow extracts a Tableau workbook, maps its concepts, builds and deploys Omni dashboards, then verifies fidelity. The semantic-layer skill configures and validates model content; branch creation is a separate Omni API workflow. Some relationships come from the README’s documented stages; unsampled implementation details are left unconnected where evidence is unavailable.

Main entry points: [`skills/tableau-to-omni/SKILL.md`](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/SKILL.md) (Migration Guide), [`skills/omni-semantic-layer-setup/SKILL.md`](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/SKILL.md) (Semantic Setup), [`skills/tableau-to-omni/scripts/build_dashboards.py`](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/build_dashboards.py) (Dashboard Builder), [`skills/tableau-to-omni/scripts/extract.py`](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/extract.py) (Workbook Extractor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Skill Workflows"]
  node_branch_skill["Branch Creator<br/>[SKILL.md]"]
  node_semantic_skill["Semantic Setup<br/>[SKILL.md]"]
  node_migration_skill["Migration Guide<br/>[SKILL.md]"]
end

subgraph group_migration["Tableau Migration"]
  node_extract["Workbook Extractor<br/>[extract.py]"]
  node_rules["Rule Mapping<br/>[apply_rules.py]"]
  node_mapping_spec["Mapping Rules<br/>[mapping-rules.yaml]"]
  node_payload["Payload Builder<br/>[build_payload.py]"]
  node_dashboard_builder["Dashboard Builder"]
  node_grid_mapper["Zone Grid Mapper<br/>[zones_to_grid.py]"]
  node_deployer["Dashboard Deployer<br/>[omni_deploy.py]"]
  node_fidelity["Fidelity Scorer<br/>[score_fidelity.py]"]
  node_pdf_verify["Visual Verification"]
end

subgraph group_semantic["Semantic Layer"]
  node_semantic_builder["Model Builder"]
  node_model_validator["Model Validator"]
  node_layer_validator["Layer Validator"]
end

subgraph group_omni["Omni Integration"]
  node_omni{{"Omni Platform"}}
end

node_analyst(("BI Engineer"))
node_tableau["Tableau Workbook"]

node_analyst -->|"requests branch"| node_branch_skill
node_branch_skill -->|"creates branch"| node_omni
node_analyst -->|"sets up model"| node_semantic_skill
node_semantic_skill -->|"runs build"| node_semantic_builder
node_semantic_builder -->|"writes model YAML"| node_omni
node_semantic_skill -->|"validates model"| node_model_validator
node_semantic_skill -->|"validates layer"| node_layer_validator
node_model_validator -->|"checks model"| node_omni
node_layer_validator -->|"checks layer"| node_omni
node_analyst -->|"starts migration"| node_migration_skill
node_tableau -->|"provides workbook"| node_extract
node_migration_skill -->|"guides extraction"| node_extract
node_extract -->|"emits workbook IR"| node_rules
node_mapping_spec -.->|"configures rules"| node_rules
node_rules -->|"emits decisions"| node_payload
node_migration_skill -->|"guides mapping"| node_payload
node_payload -.->|"supplies dashboard payload"| node_dashboard_builder
node_dashboard_builder -->|"maps dashboard zones"| node_grid_mapper
node_dashboard_builder -.->|"drives import"| node_deployer
node_migration_skill -->|"guides deployment"| node_deployer
node_deployer -->|"imports dashboards"| node_omni
node_migration_skill -->|"guides verification"| node_fidelity
node_fidelity -.->|"checks query parity"| node_omni
node_migration_skill -->|"guides visual checks"| node_pdf_verify
node_pdf_verify -->|"exports dashboards"| node_omni

click node_branch_skill "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-branch-creator/SKILL.md"
click node_semantic_skill "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/SKILL.md"
click node_migration_skill "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/SKILL.md"
click node_extract "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/extract.py"
click node_rules "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/apply_rules.py"
click node_mapping_spec "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/context/mapping-rules.yaml"
click node_payload "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/build_payload.py"
click node_dashboard_builder "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/build_dashboards.py"
click node_grid_mapper "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/zones_to_grid.py"
click node_deployer "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/omni_deploy.py"
click node_fidelity "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/score_fidelity.py"
click node_pdf_verify "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/export_and_compare_pdfs.py"
click node_semantic_builder "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/scripts/build_semantic_layer.py"
click node_model_validator "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/scripts/validate_omni_model.py"
click node_layer_validator "https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/scripts/validate_semantic_layer.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_branch_skill,node_semantic_skill,node_migration_skill toneBlue
class node_extract,node_rules,node_mapping_spec,node_payload,node_dashboard_builder,node_grid_mapper,node_deployer,node_fidelity,node_pdf_verify toneAmber
class node_semantic_builder,node_model_validator,node_layer_validator toneMint
class node_omni toneRose
class node_analyst,node_tableau toneIndigo
```

## Components

### Skill Workflows

- [Branch Creator](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-branch-creator/SKILL.md): `skills/omni-branch-creator/SKILL.md`
- [Semantic Setup](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/SKILL.md): `skills/omni-semantic-layer-setup/SKILL.md`
- [Migration Guide](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/SKILL.md): `skills/tableau-to-omni/SKILL.md`

### Tableau Migration

- [Workbook Extractor](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/extract.py): `skills/tableau-to-omni/scripts/extract.py`
- [Rule Mapping](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/apply_rules.py): `skills/tableau-to-omni/scripts/apply_rules.py`
- [Mapping Rules](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/context/mapping-rules.yaml): `skills/tableau-to-omni/context/mapping-rules.yaml`
- [Payload Builder](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/build_payload.py): `skills/tableau-to-omni/scripts/build_payload.py`
- [Dashboard Builder](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/build_dashboards.py): `skills/tableau-to-omni/scripts/build_dashboards.py`
- [Zone Grid Mapper](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/zones_to_grid.py): `skills/tableau-to-omni/scripts/zones_to_grid.py`
- [Dashboard Deployer](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/omni_deploy.py): `skills/tableau-to-omni/scripts/omni_deploy.py`
- [Fidelity Scorer](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/score_fidelity.py): `skills/tableau-to-omni/scripts/score_fidelity.py`
- [Visual Verification](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/tableau-to-omni/scripts/export_and_compare_pdfs.py): `skills/tableau-to-omni/scripts/export_and_compare_pdfs.py`

### Semantic Layer

- [Model Builder](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/scripts/build_semantic_layer.py): `skills/omni-semantic-layer-setup/scripts/build_semantic_layer.py`
- [Model Validator](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/scripts/validate_omni_model.py): `skills/omni-semantic-layer-setup/scripts/validate_omni_model.py`
- [Layer Validator](https://github.com/joshbricel/claude-omni-skills/blob/main/skills/omni-semantic-layer-setup/scripts/validate_semantic_layer.py): `skills/omni-semantic-layer-setup/scripts/validate_semantic_layer.py`

### Omni Integration

- **Omni Platform**

### Other components

- **BI Engineer**
- **Tableau Workbook**

## Connections

- BI Engineer → Branch Creator: requests branch (evidence: `README.md`)
- Branch Creator → Omni Platform: creates branch (evidence: `README.md`)
- BI Engineer → Semantic Setup: sets up model (evidence: `README.md`)
- Semantic Setup → Model Builder: runs build (evidence: `README.md`)
- Model Builder → Omni Platform: writes model YAML (evidence: `skills/omni-semantic-layer-setup/scripts/build_semantic_layer.py`)
- Semantic Setup → Model Validator: validates model (evidence: `README.md`)
- Semantic Setup → Layer Validator: validates layer (evidence: `README.md`)
- Model Validator → Omni Platform: checks model (evidence: `README.md`)
- Layer Validator → Omni Platform: checks layer (evidence: `README.md`)
- BI Engineer → Migration Guide: starts migration (evidence: `README.md`)
- Tableau Workbook → Workbook Extractor: provides workbook (evidence: `README.md`)
- Migration Guide → Workbook Extractor: guides extraction (evidence: `README.md`)
- Workbook Extractor → Rule Mapping: emits workbook IR (evidence: `README.md`)
- Mapping Rules → Rule Mapping: configures rules
- Rule Mapping → Payload Builder: emits decisions (evidence: `skills/tableau-to-omni/scripts/apply_rules.py`)
- Migration Guide → Payload Builder: guides mapping (evidence: `README.md`)
- Payload Builder → Dashboard Builder: supplies dashboard payload
- Dashboard Builder → Zone Grid Mapper: maps dashboard zones (evidence: `skills/tableau-to-omni/scripts/build_dashboards.py`)
- Dashboard Builder → Dashboard Deployer: drives import
- Migration Guide → Dashboard Deployer: guides deployment (evidence: `README.md`)
- Dashboard Deployer → Omni Platform: imports dashboards (evidence: `README.md`)
- Migration Guide → Fidelity Scorer: guides verification (evidence: `README.md`)
- Fidelity Scorer → Omni Platform: checks query parity
- Migration Guide → Visual Verification: guides visual checks (evidence: `README.md`)
- Visual Verification → Omni Platform: exports dashboards (evidence: `skills/tableau-to-omni/scripts/export_and_compare_pdfs.py`)