# microsoft/azure-skills architecture

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

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

## Overview

Azure Skills Plugin packages curated, domain-specific guidance with MCP-backed execution for compatible coding agents. The principal workflow is an agent applying a skill’s decision steps and guardrails, then using Azure or Foundry tools to act on live resources. The repository also contains standalone Foundry fine-tuning utilities for preparing data, submitting and monitoring jobs, evaluating results, and deploying models. The README documents the broad skill and MCP capabilities; detailed edges among unsampled skills are omitted rather than inferred.

Main entry points: [`skills/microsoft-foundry/finetuning/scripts/common.py`](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/common.py) (Client and auth setup), [`skills/microsoft-foundry/finetuning/scripts/submit_training.py`](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/submit_training.py) (Submit training), [`skills/microsoft-foundry/finetuning/scripts/monitor_training.py`](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/monitor_training.py) (Monitor training), [`skills/microsoft-foundry/finetuning/scripts/check_training.py`](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/check_training.py) (Analyze training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Azure skills"]
  node_build["Build and deploy"]
  node_validate["Validate and upgrade"]
  node_operate["Diagnose and govern"]
  node_optimize["Cost and architecture"]
  node_platform["AI and platform"]
end

subgraph group_execution["MCP execution"]
  node_azure_mcp["Azure MCP Server"]
  node_foundry_mcp["Foundry MCP"]
end

subgraph group_finetuning["Foundry fine-tuning"]
  node_dataset["Prepare datasets<br/>[convert_dataset.py]"]
  node_distill["Generate distillation data"]
  node_score["Score datasets<br/>[score_dataset.py]"]
  node_submit["Submit training<br/>[submit_training.py]"]
  node_monitor["Monitor training"]
  node_analyze["Analyze training<br/>[check_training.py]"]
  node_evaluate["Evaluate model<br/>[evaluate_model.py]"]
  node_calibrate["Calibrate grader"]
  node_deploy["Deploy model<br/>[deploy_model.py]"]
  node_cleanup["Manage resources<br/>[cleanup.py]"]
  node_common["Client and auth setup<br/>[common.py]"]
end

node_user(("Engineer"))
node_agent["Compatible agent"]

node_user -->|"requests work"| node_agent
node_agent -->|"applies guidance"| node_build
node_agent -->|"applies guidance"| node_validate
node_agent -->|"applies guidance"| node_operate
node_agent -->|"applies guidance"| node_optimize
node_agent -->|"applies guidance"| node_platform
node_agent -->|"uses tools"| node_azure_mcp
node_agent -->|"uses tools"| node_foundry_mcp
node_dataset -->|"imports"| node_common
node_distill -->|"imports"| node_common
node_score -->|"imports"| node_common
node_submit -->|"imports"| node_common
node_monitor -->|"imports"| node_common
node_analyze -->|"imports"| node_common
node_evaluate -->|"imports"| node_common
node_calibrate -->|"imports"| node_common
node_cleanup -->|"imports"| node_common
node_submit -.->|"uses Foundry API"| node_foundry_mcp
node_monitor -.->|"uses Foundry API"| node_foundry_mcp
node_analyze -.->|"uses Foundry API"| node_foundry_mcp
node_evaluate -.->|"calls model"| node_foundry_mcp
node_calibrate -.->|"calls model"| node_foundry_mcp
node_deploy -.->|"deploys to Foundry"| node_foundry_mcp

click node_build "https://github.com/microsoft/azure-skills/tree/main/skills/azure-prepare"
click node_validate "https://github.com/microsoft/azure-skills/tree/main/skills/azure-validate"
click node_operate "https://github.com/microsoft/azure-skills/tree/main/skills/azure-diagnostics"
click node_platform "https://github.com/microsoft/azure-skills/tree/main/skills/microsoft-foundry"
click node_dataset "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/convert_dataset.py"
click node_distill "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/generate_distillation_data.py"
click node_score "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/score_dataset.py"
click node_submit "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/submit_training.py"
click node_monitor "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/monitor_training.py"
click node_analyze "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/check_training.py"
click node_evaluate "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/evaluate_model.py"
click node_calibrate "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/calibrate_grader.py"
click node_deploy "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/deploy_model.py"
click node_cleanup "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/cleanup.py"
click node_common "https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/common.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_build,node_validate,node_operate,node_optimize,node_platform toneBlue
class node_azure_mcp,node_foundry_mcp toneAmber
class node_dataset,node_distill,node_score,node_submit,node_monitor,node_analyze,node_evaluate,node_calibrate,node_deploy,node_cleanup,node_common toneMint
class node_user,node_agent toneIndigo
```

## Components

### Azure skills

- [Build and deploy](https://github.com/microsoft/azure-skills/tree/main/skills/azure-prepare): `skills/azure-prepare`
- [Validate and upgrade](https://github.com/microsoft/azure-skills/tree/main/skills/azure-validate): `skills/azure-validate`
- [Diagnose and govern](https://github.com/microsoft/azure-skills/tree/main/skills/azure-diagnostics): `skills/azure-diagnostics`
- **Cost and architecture**
- [AI and platform](https://github.com/microsoft/azure-skills/tree/main/skills/microsoft-foundry): `skills/microsoft-foundry`

### MCP execution

- **Azure MCP Server**
- **Foundry MCP**

### Foundry fine-tuning

- [Prepare datasets](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/convert_dataset.py): `skills/microsoft-foundry/finetuning/scripts/convert_dataset.py`
- [Generate distillation data](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/generate_distillation_data.py): `skills/microsoft-foundry/finetuning/scripts/generate_distillation_data.py`
- [Score datasets](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/score_dataset.py): `skills/microsoft-foundry/finetuning/scripts/score_dataset.py`
- [Submit training](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/submit_training.py): `skills/microsoft-foundry/finetuning/scripts/submit_training.py`
- [Monitor training](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/monitor_training.py): `skills/microsoft-foundry/finetuning/scripts/monitor_training.py`
- [Analyze training](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/check_training.py): `skills/microsoft-foundry/finetuning/scripts/check_training.py`
- [Evaluate model](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/evaluate_model.py): `skills/microsoft-foundry/finetuning/scripts/evaluate_model.py`
- [Calibrate grader](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/calibrate_grader.py): `skills/microsoft-foundry/finetuning/scripts/calibrate_grader.py`
- [Deploy model](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/deploy_model.py): `skills/microsoft-foundry/finetuning/scripts/deploy_model.py`
- [Manage resources](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/cleanup.py): `skills/microsoft-foundry/finetuning/scripts/cleanup.py`
- [Client and auth setup](https://github.com/microsoft/azure-skills/blob/main/skills/microsoft-foundry/finetuning/scripts/common.py): `skills/microsoft-foundry/finetuning/scripts/common.py`

### Other components

- **Engineer**
- **Compatible agent**

## Connections

- Engineer → Compatible agent: requests work (evidence: `README.md`)
- Compatible agent → Build and deploy: applies guidance (evidence: `README.md`)
- Compatible agent → Validate and upgrade: applies guidance (evidence: `README.md`)
- Compatible agent → Diagnose and govern: applies guidance (evidence: `README.md`)
- Compatible agent → Cost and architecture: applies guidance (evidence: `README.md`)
- Compatible agent → AI and platform: applies guidance (evidence: `README.md`)
- Compatible agent → Azure MCP Server: uses tools (evidence: `README.md`)
- Compatible agent → Foundry MCP: uses tools (evidence: `README.md`)
- Prepare datasets → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/convert_dataset.py`)
- Generate distillation data → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/generate_distillation_data.py`)
- Score datasets → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/score_dataset.py`)
- Submit training → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/submit_training.py`)
- Monitor training → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/monitor_training.py`)
- Analyze training → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/check_training.py`)
- Evaluate model → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/evaluate_model.py`)
- Calibrate grader → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/calibrate_grader.py`)
- Manage resources → Client and auth setup: imports (evidence: `skills/microsoft-foundry/finetuning/scripts/cleanup.py`)
- Submit training → Foundry MCP: uses Foundry API
- Monitor training → Foundry MCP: uses Foundry API
- Analyze training → Foundry MCP: uses Foundry API
- Evaluate model → Foundry MCP: calls model
- Calibrate grader → Foundry MCP: calls model
- Deploy model → Foundry MCP: deploys to Foundry
