# tableau/tableau-ai-utilities architecture

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

- Interactive diagram: https://gitdiagram.com/tableau/tableau-ai-utilities
- Repository: https://github.com/tableau/tableau-ai-utilities

## Overview

This repository is a public catalog and distribution site for Tableau Agent skills, not the runtime agent itself. Users browse or filter the catalog, inspect skill details and protection status, then download skills; maintainers’ skill folders feed generated catalog pages, ZIPs, and LLM-oriented indexes. The graph also preserves the documented plugin and site-link capabilities. Relationships are limited to README statements and shown source references; unsampled skill implementations are represented by their exact enclosing directories.

Main entry points: [`scripts/build-index.ts`](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-index.ts) (Catalog and downloads), [`scripts/build-llms.ts`](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-llms.ts) (LLM indexes), [`site/docusaurus.config.ts`](https://github.com/tableau/tableau-ai-utilities/blob/main/site/docusaurus.config.ts) (Site configuration), [`scripts/categories.ts`](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/categories.ts) (Skill categories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Skill Content"]
  node_studio_skills["Studio skills"]
  node_mcp_skills["MCP skills"]
  node_plugins["Plugins"]
end

subgraph group_generation["Catalog Generation"]
  node_categories["Skill categories<br/>[categories.ts]"]
  node_protection["Protection rules<br/>[protection.ts]"]
  node_index_builder["Catalog and downloads<br/>[build-index.ts]"]
  node_zip_writer["ZIP writer<br/>[zip.ts]"]
  node_llm_builder["LLM indexes<br/>[build-llms.ts]"]
  node_plugin_index["Plugin index"]
  node_validation["Skill validation<br/>[validate.ts]"]
end

subgraph group_site["Catalog Site"]
  node_catalog_ui["Filterable catalog<br/>[index.tsx]"]
  node_skill_detail["Skill details<br/>[index.tsx]"]
  node_site_config["Site configuration"]
end

subgraph group_linking["Site Linking"]
  node_ext_resolver["External link resolver<br/>[resolve.ts]"]
  node_ext_remark["External link transform<br/>[extLinks.mjs]"]
  node_variables["Content variables<br/>[variables.mjs]"]
end

node_user(("Catalog user"))

node_user -->|"browses"| node_catalog_ui
node_user -->|"views and downloads"| node_skill_detail
node_studio_skills -->|"provides skills"| node_index_builder
node_mcp_skills -->|"provides skills"| node_index_builder
node_index_builder -->|"orders categories"| node_categories
node_index_builder -->|"assigns protection"| node_protection
node_index_builder -->|"writes downloads"| node_zip_writer
node_index_builder -->|"generates catalog data"| node_catalog_ui
node_index_builder -->|"generates skill pages"| node_skill_detail
node_studio_skills -->|"provides skill content"| node_llm_builder
node_mcp_skills -->|"provides skill content"| node_llm_builder
node_llm_builder -->|"groups by category"| node_categories
node_llm_builder -->|"labels skills"| node_protection
node_llm_builder -->|"rewrites links"| node_ext_resolver
node_llm_builder -->|"substitutes variables"| node_variables
node_plugins -->|"supplies plugin content"| node_plugin_index
node_site_config -->|"configures link environment"| node_ext_resolver
node_site_config -->|"registers transform"| node_ext_remark
node_site_config -->|"registers transform"| node_variables
node_ext_remark -.->|"rewrites links"| node_ext_resolver
node_validation -->|"uses category definitions"| node_categories

click node_studio_skills "https://github.com/tableau/tableau-ai-utilities/tree/main/tableau-studio-skills/tableau-agent"
click node_mcp_skills "https://github.com/tableau/tableau-ai-utilities/tree/main/tableau-mcp-skills"
click node_plugins "https://github.com/tableau/tableau-ai-utilities/tree/main/plugins"
click node_categories "https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/categories.ts"
click node_protection "https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/protection.ts"
click node_index_builder "https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-index.ts"
click node_zip_writer "https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/zip.ts"
click node_llm_builder "https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-llms.ts"
click node_plugin_index "https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-plugins-index.ts"
click node_validation "https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/validate.ts"
click node_catalog_ui "https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/components/CatalogFilter/index.tsx"
click node_skill_detail "https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/components/SkillDetailHeader/index.tsx"
click node_site_config "https://github.com/tableau/tableau-ai-utilities/blob/main/site/docusaurus.config.ts"
click node_ext_resolver "https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/extLinks/resolve.ts"
click node_ext_remark "https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/remark/extLinks.mjs"
click node_variables "https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/remark/variables.mjs"

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_studio_skills,node_mcp_skills,node_plugins,node_user toneBlue
class node_categories,node_protection,node_index_builder,node_zip_writer,node_llm_builder,node_plugin_index,node_validation toneAmber
class node_catalog_ui,node_skill_detail,node_site_config toneMint
class node_ext_resolver,node_ext_remark,node_variables toneRose
```

## Components

### Skill Content

- [Studio skills](https://github.com/tableau/tableau-ai-utilities/tree/main/tableau-studio-skills/tableau-agent): `tableau-studio-skills/tableau-agent`
- [MCP skills](https://github.com/tableau/tableau-ai-utilities/tree/main/tableau-mcp-skills): `tableau-mcp-skills`
- [Plugins](https://github.com/tableau/tableau-ai-utilities/tree/main/plugins): `plugins`

### Catalog Generation

- [Skill categories](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/categories.ts): `scripts/categories.ts`
- [Protection rules](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/protection.ts): `scripts/protection.ts`
- [Catalog and downloads](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-index.ts): `scripts/build-index.ts`
- [ZIP writer](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/zip.ts): `scripts/zip.ts`
- [LLM indexes](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-llms.ts): `scripts/build-llms.ts`
- [Plugin index](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/build-plugins-index.ts): `scripts/build-plugins-index.ts`
- [Skill validation](https://github.com/tableau/tableau-ai-utilities/blob/main/scripts/validate.ts): `scripts/validate.ts`

### Catalog Site

- [Filterable catalog](https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/components/CatalogFilter/index.tsx): `site/src/components/CatalogFilter/index.tsx`
- [Skill details](https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/components/SkillDetailHeader/index.tsx): `site/src/components/SkillDetailHeader/index.tsx`
- [Site configuration](https://github.com/tableau/tableau-ai-utilities/blob/main/site/docusaurus.config.ts): `site/docusaurus.config.ts`

### Site Linking

- [External link resolver](https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/extLinks/resolve.ts): `site/src/extLinks/resolve.ts`
- [External link transform](https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/remark/extLinks.mjs): `site/src/remark/extLinks.mjs`
- [Content variables](https://github.com/tableau/tableau-ai-utilities/blob/main/site/src/remark/variables.mjs): `site/src/remark/variables.mjs`

### Other components

- **Catalog user**

## Connections

- Catalog user → Filterable catalog: browses (evidence: `README.md`)
- Catalog user → Skill details: views and downloads (evidence: `README.md`)
- Studio skills → Catalog and downloads: provides skills (evidence: `scripts/build-index.ts`)
- MCP skills → Catalog and downloads: provides skills (evidence: `scripts/build-index.ts`)
- Catalog and downloads → Skill categories: orders categories (evidence: `scripts/build-index.ts`)
- Catalog and downloads → Protection rules: assigns protection (evidence: `scripts/build-index.ts`)
- Catalog and downloads → ZIP writer: writes downloads (evidence: `scripts/build-index.ts`)
- Catalog and downloads → Filterable catalog: generates catalog data (evidence: `scripts/build-index.ts`)
- Catalog and downloads → Skill details: generates skill pages (evidence: `scripts/build-index.ts`)
- Studio skills → LLM indexes: provides skill content (evidence: `README.md`)
- MCP skills → LLM indexes: provides skill content (evidence: `README.md`)
- LLM indexes → Skill categories: groups by category (evidence: `scripts/build-llms.ts`)
- LLM indexes → Protection rules: labels skills (evidence: `scripts/build-llms.ts`)
- LLM indexes → External link resolver: rewrites links (evidence: `scripts/build-llms.ts`)
- LLM indexes → Content variables: substitutes variables (evidence: `scripts/build-llms.ts`)
- Plugins → Plugin index: supplies plugin content (evidence: `README.md`)
- Site configuration → External link resolver: configures link environment (evidence: `site/docusaurus.config.ts`)
- Site configuration → External link transform: registers transform (evidence: `site/docusaurus.config.ts`)
- Site configuration → Content variables: registers transform (evidence: `site/docusaurus.config.ts`)
- External link transform → External link resolver: rewrites links
- Skill validation → Skill categories: uses category definitions (evidence: `scripts/validate.ts`)
