# arize-ai/arize-skills architecture

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

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

## Overview

Arize Skills is a collection of agent-guidance documents and recipes, not an implementation of the Arize platform. An engineer asks a coding agent to perform a task; the agent selects a relevant skill, follows its instructions and uses the `ax` CLI or other named integrations to produce a change, analysis, or managed resource. The graph covers the README’s major skill capabilities. Skill contents were not sampled, so links between individual skills and specific commands or services are limited to the README’s explicit descriptions.

Main entry points: [`skills/arize-ai-provider-integration/SKILL.md`](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-ai-provider-integration/SKILL.md) (Configure Providers), [`skills/arize-phoenix-migration/SKILL.md`](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-phoenix-migration/SKILL.md) (Migrate Phoenix), [`skills/arize-instrumentation/SKILL.md`](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-instrumentation/SKILL.md) (Add Instrumentation), [`skills/arize-span-routing/SKILL.md`](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-span-routing/SKILL.md) (Route Spans)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_observe["Tracing and Observability"]
  node_instrumentation["Add Instrumentation<br/>[SKILL.md]"]
  node_routing["Route Spans<br/>[SKILL.md]"]
  node_trace["Analyze Traces<br/>[SKILL.md]"]
  node_health["Check Instrumentation<br/>[SKILL.md]"]
end

subgraph group_dataeval["Data and Evaluation"]
  node_dataset["Manage Datasets<br/>[SKILL.md]"]
  node_experiment["Run Experiments<br/>[SKILL.md]"]
  node_evaluator["Build Evaluators<br/>[SKILL.md]"]
  node_annotation["Manage Annotations<br/>[SKILL.md]"]
end

subgraph group_promptops["Prompts and Administration"]
  node_provider["Configure Providers<br/>[SKILL.md]"]
  node_prompts["Manage Prompts<br/>[SKILL.md]"]
  node_optimization["Optimize Prompts<br/>[SKILL.md]"]
  node_admin["Administer Arize<br/>[SKILL.md]"]
  node_links["Generate Deep Links<br/>[SKILL.md]"]
end

subgraph group_migration["Migration and Governance"]
  node_phoenix["Migrate Phoenix<br/>[SKILL.md]"]
  node_compliance["Audit Compliance<br/>[SKILL.md]"]
end

node_engineer(("Engineer"))
node_agent(("Coding Agent"))
node_ax["Arize AX CLI"]
node_arize["Arize AX"]
node_app["LLM Application"]
node_model["LLM Provider"]
node_phoenix_service["Phoenix"]

node_engineer -->|"requests work"| node_agent
node_agent -->|"follows guidance"| node_instrumentation
node_agent -->|"follows guidance"| node_routing
node_agent -->|"follows guidance"| node_trace
node_agent -->|"follows guidance"| node_health
node_agent -->|"follows guidance"| node_dataset
node_agent -->|"follows guidance"| node_experiment
node_agent -->|"follows guidance"| node_evaluator
node_agent -->|"follows guidance"| node_annotation
node_agent -->|"follows guidance"| node_provider
node_agent -->|"follows guidance"| node_prompts
node_agent -->|"follows guidance"| node_optimization
node_agent -->|"follows guidance"| node_admin
node_agent -->|"follows guidance"| node_links
node_agent -->|"follows guidance"| node_phoenix
node_agent -->|"follows guidance"| node_compliance
node_instrumentation -->|"guides changes"| node_app
node_app -->|"sends traces"| node_arize
node_trace -->|"guides export"| node_ax
node_dataset -->|"guides management"| node_ax
node_experiment -->|"guides execution"| node_ax
node_evaluator -->|"guides evaluation"| node_ax
node_annotation -->|"guides annotation"| node_ax
node_provider -->|"guides configuration"| node_ax
node_prompts -->|"guides management"| node_ax
node_optimization -->|"guides optimization"| node_ax
node_admin -->|"guides administration"| node_ax
node_links -->|"guides link creation"| node_ax
node_routing -->|"guides routing"| node_app
node_health -->|"guides checks"| node_app
node_phoenix -->|"guides export"| node_phoenix_service
node_phoenix -->|"guides import"| node_arize
node_compliance -->|"produces checklist"| node_engineer
node_agent -->|"returns results"| node_engineer
node_provider -.->|"guides integration"| node_model

click node_instrumentation "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-instrumentation/SKILL.md"
click node_routing "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-span-routing/SKILL.md"
click node_trace "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-trace/SKILL.md"
click node_health "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-instrumentation-health/SKILL.md"
click node_dataset "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-dataset/SKILL.md"
click node_experiment "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-experiment/SKILL.md"
click node_evaluator "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-evaluator/SKILL.md"
click node_annotation "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-annotation/SKILL.md"
click node_provider "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-ai-provider-integration/SKILL.md"
click node_prompts "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-prompts/SKILL.md"
click node_optimization "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-prompt-optimization/SKILL.md"
click node_admin "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-admin/SKILL.md"
click node_links "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-link/SKILL.md"
click node_phoenix "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-phoenix-migration/SKILL.md"
click node_compliance "https://github.com/arize-ai/arize-skills/blob/main/skills/arize-compliance-audit/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_instrumentation,node_routing,node_trace,node_health toneBlue
class node_dataset,node_experiment,node_evaluator,node_annotation toneAmber
class node_provider,node_prompts,node_optimization,node_admin,node_links toneMint
class node_phoenix,node_compliance toneRose
class node_engineer,node_agent,node_ax,node_arize,node_app,node_model,node_phoenix_service toneIndigo
```

## Components

### Tracing and Observability

- [Add Instrumentation](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-instrumentation/SKILL.md): `skills/arize-instrumentation/SKILL.md`
- [Route Spans](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-span-routing/SKILL.md): `skills/arize-span-routing/SKILL.md`
- [Analyze Traces](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-trace/SKILL.md): `skills/arize-trace/SKILL.md`
- [Check Instrumentation](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-instrumentation-health/SKILL.md): `skills/arize-instrumentation-health/SKILL.md`

### Data and Evaluation

- [Manage Datasets](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-dataset/SKILL.md): `skills/arize-dataset/SKILL.md`
- [Run Experiments](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-experiment/SKILL.md): `skills/arize-experiment/SKILL.md`
- [Build Evaluators](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-evaluator/SKILL.md): `skills/arize-evaluator/SKILL.md`
- [Manage Annotations](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-annotation/SKILL.md): `skills/arize-annotation/SKILL.md`

### Prompts and Administration

- [Configure Providers](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-ai-provider-integration/SKILL.md): `skills/arize-ai-provider-integration/SKILL.md`
- [Manage Prompts](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-prompts/SKILL.md): `skills/arize-prompts/SKILL.md`
- [Optimize Prompts](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-prompt-optimization/SKILL.md): `skills/arize-prompt-optimization/SKILL.md`
- [Administer Arize](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-admin/SKILL.md): `skills/arize-admin/SKILL.md`
- [Generate Deep Links](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-link/SKILL.md): `skills/arize-link/SKILL.md`

### Migration and Governance

- [Migrate Phoenix](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-phoenix-migration/SKILL.md): `skills/arize-phoenix-migration/SKILL.md`
- [Audit Compliance](https://github.com/arize-ai/arize-skills/blob/main/skills/arize-compliance-audit/SKILL.md): `skills/arize-compliance-audit/SKILL.md`

### Other components

- **Engineer**
- **Coding Agent**
- **Arize AX CLI**
- **Arize AX**
- **LLM Application**
- **LLM Provider**
- **Phoenix**

## Connections

- Engineer → Coding Agent: requests work
- Coding Agent → Add Instrumentation: follows guidance
- Coding Agent → Route Spans: follows guidance
- Coding Agent → Analyze Traces: follows guidance
- Coding Agent → Check Instrumentation: follows guidance
- Coding Agent → Manage Datasets: follows guidance
- Coding Agent → Run Experiments: follows guidance
- Coding Agent → Build Evaluators: follows guidance
- Coding Agent → Manage Annotations: follows guidance
- Coding Agent → Configure Providers: follows guidance
- Coding Agent → Manage Prompts: follows guidance
- Coding Agent → Optimize Prompts: follows guidance
- Coding Agent → Administer Arize: follows guidance
- Coding Agent → Generate Deep Links: follows guidance
- Coding Agent → Migrate Phoenix: follows guidance
- Coding Agent → Audit Compliance: follows guidance
- Add Instrumentation → LLM Application: guides changes
- LLM Application → Arize AX: sends traces
- Analyze Traces → Arize AX CLI: guides export
- Manage Datasets → Arize AX CLI: guides management
- Run Experiments → Arize AX CLI: guides execution
- Build Evaluators → Arize AX CLI: guides evaluation
- Manage Annotations → Arize AX CLI: guides annotation
- Configure Providers → Arize AX CLI: guides configuration
- Manage Prompts → Arize AX CLI: guides management
- Optimize Prompts → Arize AX CLI: guides optimization
- Administer Arize → Arize AX CLI: guides administration
- Generate Deep Links → Arize AX CLI: guides link creation
- Route Spans → LLM Application: guides routing
- Check Instrumentation → LLM Application: guides checks
- Migrate Phoenix → Phoenix: guides export
- Migrate Phoenix → Arize AX: guides import
- Audit Compliance → Engineer: produces checklist
- Coding Agent → Engineer: returns results
- Configure Providers → LLM Provider: guides integration