# microsoft/skills architecture

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

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

## Overview

This repository packages domain-specific skills and agent configuration for Azure and Microsoft AI development, alongside a browsable skill catalog. The explorer workflow is: a visitor filters or searches the catalog, selects a skill, then views its details and install command. The README also documents plugins, custom agents, AGENTS.md templates, and MCP configurations as product capabilities. Explorer component relationships are supported by source-index references and excerpts; links to broader package capabilities are documented in the README, while the generated-data handoff to the UI is not fully shown.

Main entry points: [`docs-site/src/components/SkillsSection.tsx`](https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillsSection.tsx) (Catalog section), [`docs-site/src/components/SkillCard.tsx`](https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillCard.tsx) (Skill cards), [`docs-site/src/data`](https://github.com/microsoft/skills/tree/main/docs-site/src/data) (Skill catalog records), [`docs-site/src/components/SkillDetailModal.tsx`](https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillDetailModal.tsx) (Skill details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Skill Explorer"]
  node_explorer["Catalog section<br/>[SkillsSection.tsx]"]
  node_language["Language filters<br/>[LanguageTabs.tsx]"]
  node_category["Category filters<br/>[CategoryTabs.tsx]"]
  node_search["Skill search<br/>[SearchInput.tsx]"]
  node_cards["Skill cards<br/>[SkillCard.tsx]"]
  node_detail["Skill details"]
end

subgraph group_packages["Knowledge Packages"]
  node_core["Core skills<br/>[skills]"]
  node_pluginbundles["Skill plugins<br/>[plugins]"]
end

subgraph group_agentconfig["Agent Configuration"]
  node_agents["Custom agents<br/>[agents]"]
  node_mcp["MCP configurations<br/>[plugins]"]
  node_agenttemplates["AGENTS templates"]
end

subgraph group_catalogdata["Catalog Data"]
  node_extract["Catalog extraction<br/>[extract-skills.ts]"]
  node_catalogrecords["Skill catalog records"]
end

node_visitor(("Catalog visitor"))
node_userproject(("Agent user"))

node_visitor -->|"browses"| node_explorer
node_explorer -->|"renders"| node_language
node_explorer -->|"renders"| node_category
node_explorer -->|"renders"| node_search
node_explorer -->|"renders"| node_cards
node_explorer -->|"opens"| node_detail
node_cards -->|"provides skill type"| node_detail
node_extract -->|"writes records"| node_catalogrecords
node_catalogrecords -.->|"supplies catalog"| node_explorer
node_userproject -->|"installs skills"| node_core
node_userproject -->|"installs plugins"| node_pluginbundles
node_userproject -->|"configures agents"| node_agents
node_userproject -->|"configures MCP"| node_mcp
node_userproject -->|"uses templates"| node_agenttemplates

click node_explorer "https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillsSection.tsx"
click node_language "https://github.com/microsoft/skills/blob/main/docs-site/src/components/LanguageTabs.tsx"
click node_category "https://github.com/microsoft/skills/blob/main/docs-site/src/components/CategoryTabs.tsx"
click node_search "https://github.com/microsoft/skills/blob/main/docs-site/src/components/SearchInput.tsx"
click node_cards "https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillCard.tsx"
click node_detail "https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillDetailModal.tsx"
click node_extract "https://github.com/microsoft/skills/blob/main/docs-site/scripts/extract-skills.ts"
click node_catalogrecords "https://github.com/microsoft/skills/tree/main/docs-site/src/data"
click node_core "https://github.com/microsoft/skills/tree/main/.github/skills"
click node_pluginbundles "https://github.com/microsoft/skills/tree/main/.github/plugins"
click node_agents "https://github.com/microsoft/skills/tree/main/.github/agents"
click node_mcp "https://github.com/microsoft/skills/tree/main/.github/plugins"

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_explorer,node_language,node_category,node_search,node_cards,node_detail,node_userproject toneBlue
class node_core,node_pluginbundles toneAmber
class node_agents,node_mcp,node_agenttemplates toneMint
class node_extract,node_catalogrecords toneRose
class node_visitor toneIndigo
```

## Components

### Skill Explorer

- [Catalog section](https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillsSection.tsx): `docs-site/src/components/SkillsSection.tsx`
- [Language filters](https://github.com/microsoft/skills/blob/main/docs-site/src/components/LanguageTabs.tsx): `docs-site/src/components/LanguageTabs.tsx`
- [Category filters](https://github.com/microsoft/skills/blob/main/docs-site/src/components/CategoryTabs.tsx): `docs-site/src/components/CategoryTabs.tsx`
- [Skill search](https://github.com/microsoft/skills/blob/main/docs-site/src/components/SearchInput.tsx): `docs-site/src/components/SearchInput.tsx`
- [Skill cards](https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillCard.tsx): `docs-site/src/components/SkillCard.tsx`
- [Skill details](https://github.com/microsoft/skills/blob/main/docs-site/src/components/SkillDetailModal.tsx): `docs-site/src/components/SkillDetailModal.tsx`

### Knowledge Packages

- [Core skills](https://github.com/microsoft/skills/tree/main/.github/skills): `.github/skills`
- [Skill plugins](https://github.com/microsoft/skills/tree/main/.github/plugins): `.github/plugins`

### Agent Configuration

- [Custom agents](https://github.com/microsoft/skills/tree/main/.github/agents): `.github/agents`
- [MCP configurations](https://github.com/microsoft/skills/tree/main/.github/plugins): `.github/plugins`
- **AGENTS templates**

### Catalog Data

- [Catalog extraction](https://github.com/microsoft/skills/blob/main/docs-site/scripts/extract-skills.ts): `docs-site/scripts/extract-skills.ts`
- [Skill catalog records](https://github.com/microsoft/skills/tree/main/docs-site/src/data): `docs-site/src/data`

### Other components

- **Catalog visitor**
- **Agent user**

## Connections

- Catalog visitor → Catalog section: browses (evidence: `README.md`)
- Catalog section → Language filters: renders (evidence: `docs-site/src/components/SkillsSection.tsx`)
- Catalog section → Category filters: renders (evidence: `docs-site/src/components/SkillsSection.tsx`)
- Catalog section → Skill search: renders (evidence: `docs-site/src/components/SkillsSection.tsx`)
- Catalog section → Skill cards: renders (evidence: `docs-site/src/components/SkillsSection.tsx`)
- Catalog section → Skill details: opens (evidence: `docs-site/src/components/SkillsSection.tsx`)
- Skill cards → Skill details: provides skill type (evidence: `docs-site/src/components/SkillDetailModal.tsx`)
- Catalog extraction → Skill catalog records: writes records (evidence: `docs-site/scripts/extract-skills.ts`)
- Skill catalog records → Catalog section: supplies catalog
- Agent user → Core skills: installs skills (evidence: `README.md`)
- Agent user → Skill plugins: installs plugins (evidence: `README.md`)
- Agent user → Custom agents: configures agents (evidence: `README.md`)
- Agent user → MCP configurations: configures MCP (evidence: `README.md`)
- Agent user → AGENTS templates: uses templates (evidence: `README.md`)
