# microsoft/skills-for-fabric architecture

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

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

## Overview

1. This repository is not a running application; it is a content-and-package repository for AI assistant instructions around Microsoft Fabric. Its “architecture” is a distribution system for reusable skills, prompts, and tool configuration, not a service or UI stack.

2. The top-level repository acts as the source and umbrella bundle. The `README.md` describes the public packaging model, while `CHANGELOG.md`, `LICENSE`, `SECURITY.md`, and governance files support release, legal, and security boundaries.

3. The main payload is organized into bundles:
   - `skills/` for the full Microsoft Fabric skill set
   - `plugins/fabric-skills/` as the packaged full bundle
   - focused bundles under `plugins/` such as `fabric-authoring`, `fabric-consumption`, `fabric-operations`, and `powerbi-authoring`
   These bundles are the primary unit of installation and consumption by AI tools.

4. Each bundle follows the same internal pattern: `skills/` contains individual task-oriented skills, `common/` contains shared cross-skill guidance, and `agents/` contains role-specific instruction sets. The bundle-level `.github/plugin/plugin.json` and `.mcp.json` files define how the bundle is surfaced to plugin systems and MCP-aware tools.

5. `common/` is the shared architecture layer. It contains workload-neutral fundamentals such as CLI usage, core Fabric concepts, and workload-specific “core” guidance for Spark, SQLDW, Eventhouse, Eventstream, Dataflows, and item definitions. The nested `common/notebook-authoring/` directory provides reusable notebook-specific patterns and constraints.

6. `skills/` is the workflow layer. Each skill folder maps to a distinct operator use case, such as authoring, consumption, operations, migration, or report design. The repo covers major Fabric surfaces: Spark, SQL data warehouse, Eventhouse/KQL, Eventstream, Dataflows Gen2, semantic models, Power BI reports, Activator, Fabric IQ, and migration scenarios from Databricks, HDInsight, and Synapse.

7. The `agents/` folders define persona-based entry points. Agent files such as `FabricAdmin.agent.md`, `FabricAppDev.agent.md`, `FabricDataEngineer.agent.md`, `FabricIQ.agent.md`, and `FabricMigrationEngineer.agent.md` give the assistant role-specific behavior layered on top of the shared skill content.

8. The `plugins/` subtree is the packaging/distribution boundary. It mirrors the content into installable bundles with their own manifests and scoped skill sets:
   - `fabric-skills` = full library
   - `fabric-authoring` = creation and automation workflows
   - `fabric-consumption` = read-only discovery and querying
   - `fabric-operations` = diagnostics and performance
   - `powerbi-authoring` = report and semantic model authoring
   This split is important for understanding what a user gets when installing a specific bundle.

9. The `mcp-setup/` and `docs/mcp-servers-guide.md` area is the live-tool integration boundary. Skills provide instruction; MCP servers provide actual runtime access to Fabric APIs and data sources. The setup scripts and config template show that live capability is optional and environment-dependent.

10. `prompt_examples/` provides validation and onboarding examples, not runtime logic. These examples show the kinds of end-user requests the skill bundles are designed to answer, such as medallion architecture, report generation, and workspace documentation.

11. The repository is content-heavy and code-light. The key “interfaces” are markdown instructions, plugin manifests, and configuration files rather than source code modules or compiled artifacts. That means the architecture diagram should emphasize content flows and packaging relationships instead of application runtime components.

12. The end-to-end data flow is: author writes or updates skill/common/agent markdown → bundle manifests expose that content to Copilot CLI or compatible tools → user installs a focused or full bundle → assistant reads the appropriate skill/agent instructions → if enabled, MCP tools connect to Fabric services for live operations. The repo’s purpose is to make that flow repeatable across many Fabric workloads.

Main entry points: [`skills`](https://github.com/microsoft/skills-for-fabric/tree/main/skills) (Skills), [`plugins/fabric-skills/.github/plugin/plugin.json`](https://github.com/microsoft/skills-for-fabric/blob/main/plugins/fabric-skills/.github/plugin/plugin.json) (Plugin manifests), [`common`](https://github.com/microsoft/skills-for-fabric/tree/main/common) (Common), [`plugins/fabric-skills`](https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-skills) (Fabric skills bundle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_source["Source repository"]
  node_readme["README<br/>repo overview<br/>[README.md]"]
  node_repo_policy["Repo policy<br/>governance<br/>[CHANGELOG.md]"]
  node_package_meta["Package meta<br/>repo metadata<br/>[package.json]"]
end

subgraph group_shared["Shared instruction layer"]
  node_shared_common["Common<br/>shared guidance"]
  node_shared_notebook["Notebook guide<br/>reusable notebook patterns"]
  node_agents["Agents<br/>persona entry points"]
end

subgraph group_bundles["Installable bundles"]
  node_bundle_full["Fabric skills bundle<br/>installable bundle"]
  node_bundle_authoring["Fabric authoring bundle<br/>installable bundle"]
  node_bundle_consumption["Fabric consumption bundle<br/>installable bundle"]
  node_bundle_operations["Fabric operations bundle<br/>installable bundle"]
  node_bundle_powerbi["Power BI bundle<br/>installable bundle"]
end

subgraph group_integration["Tool integration"]
  node_plugin_manifests["Plugin manifests<br/>distribution manifest<br/>[plugin.json]"]
  node_mcp_setup["MCP setup<br/>optional runtime bridge"]
  node_mcp_guide["MCP guide<br/>integration docs"]
  node_examples["Prompt examples<br/>validation examples"]
end

subgraph group_content["Skill domains"]
  node_skill_library["Skills<br/>workflow library"]
  node_skill_authoring["Authoring skills<br/>creation workflows"]
  node_skill_consumption["Consumption skills<br/>read-only workflows"]
  node_skill_operations["Operations skills<br/>diagnostics workflows"]
  node_skill_migration["Migration skills<br/>migration workflows"]
  node_skill_powerbi["Power BI skills<br/>reporting workflows"]
end

node_readme -->|"describes"| node_skill_library
node_readme -->|"publishes"| node_bundle_full
node_repo_policy -.->|"supports"| node_readme
node_package_meta -.->|"packages"| node_plugin_manifests
node_shared_common -->|"contains"| node_shared_notebook
node_skill_library -->|"includes"| node_skill_authoring
node_skill_library -->|"includes"| node_skill_consumption
node_skill_library -->|"includes"| node_skill_operations
node_skill_library -->|"includes"| node_skill_migration
node_skill_library -->|"includes"| node_skill_powerbi
node_agents -->|"layers on"| node_shared_common
node_agents -->|"guides"| node_skill_library
node_bundle_full -->|"exposes"| node_plugin_manifests
node_bundle_authoring -->|"exposes"| node_plugin_manifests
node_bundle_consumption -->|"exposes"| node_plugin_manifests
node_bundle_operations -->|"exposes"| node_plugin_manifests
node_bundle_powerbi -->|"exposes"| node_plugin_manifests
node_mcp_setup -->|"documents"| node_mcp_guide
node_mcp_setup -->|"enables"| node_plugin_manifests
node_examples -.->|"targets"| node_skill_library
node_shared_common -->|"feeds"| node_skill_authoring
node_shared_common -->|"feeds"| node_skill_consumption
node_shared_common -->|"feeds"| node_skill_operations
node_bundle_full -->|"contains"| node_shared_common
node_bundle_full -->|"contains"| node_skill_library
node_bundle_authoring -->|"contains"| node_skill_authoring
node_bundle_consumption -->|"contains"| node_skill_consumption
node_bundle_operations -->|"contains"| node_skill_operations
node_bundle_powerbi -->|"contains"| node_skill_powerbi
node_mcp_guide -.->|"relates to"| node_mcp_setup

click node_readme "https://github.com/microsoft/skills-for-fabric/blob/main/README.md"
click node_repo_policy "https://github.com/microsoft/skills-for-fabric/blob/main/CHANGELOG.md"
click node_package_meta "https://github.com/microsoft/skills-for-fabric/blob/main/package.json"
click node_shared_common "https://github.com/microsoft/skills-for-fabric/tree/main/common"
click node_shared_notebook "https://github.com/microsoft/skills-for-fabric/tree/main/common/notebook-authoring"
click node_skill_library "https://github.com/microsoft/skills-for-fabric/tree/main/skills"
click node_skill_authoring "https://github.com/microsoft/skills-for-fabric/tree/main/skills/spark-authoring-cli"
click node_skill_consumption "https://github.com/microsoft/skills-for-fabric/tree/main/skills/semantic-model-consumption"
click node_skill_operations "https://github.com/microsoft/skills-for-fabric/tree/main/skills/spark-operations-cli"
click node_skill_migration "https://github.com/microsoft/skills-for-fabric/tree/main/skills/synapse-migration"
click node_skill_powerbi "https://github.com/microsoft/skills-for-fabric/tree/main/skills/powerbi-report-authoring"
click node_agents "https://github.com/microsoft/skills-for-fabric/tree/main/agents"
click node_bundle_full "https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-skills"
click node_bundle_authoring "https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-authoring"
click node_bundle_consumption "https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-consumption"
click node_bundle_operations "https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-operations"
click node_bundle_powerbi "https://github.com/microsoft/skills-for-fabric/tree/main/plugins/powerbi-authoring"
click node_plugin_manifests "https://github.com/microsoft/skills-for-fabric/blob/main/plugins/fabric-skills/.github/plugin/plugin.json"
click node_mcp_setup "https://github.com/microsoft/skills-for-fabric/tree/main/mcp-setup"
click node_mcp_guide "https://github.com/microsoft/skills-for-fabric/blob/main/docs/mcp-servers-guide.md"
click node_examples "https://github.com/microsoft/skills-for-fabric/tree/main/prompt_examples"

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_readme,node_repo_policy,node_package_meta toneBlue
class node_shared_common,node_shared_notebook,node_agents toneAmber
class node_bundle_full,node_bundle_authoring,node_bundle_consumption,node_bundle_operations,node_bundle_powerbi toneMint
class node_plugin_manifests,node_mcp_setup,node_mcp_guide,node_examples toneRose
class node_skill_library,node_skill_authoring,node_skill_consumption,node_skill_operations,node_skill_migration,node_skill_powerbi toneIndigo
```

## Components

### Source repository

Top-level content and governance for the library

- [README](https://github.com/microsoft/skills-for-fabric/blob/main/README.md): repo overview · Public packaging and usage model · `README.md`
- [Repo policy](https://github.com/microsoft/skills-for-fabric/blob/main/CHANGELOG.md): governance · Changelog, license, security, and conduct boundaries · `CHANGELOG.md`
- [Package meta](https://github.com/microsoft/skills-for-fabric/blob/main/package.json): repo metadata · Repository package and automation metadata · `package.json`

### Shared instruction layer

Reusable guidance used across bundles

- [Common](https://github.com/microsoft/skills-for-fabric/tree/main/common): shared guidance · Workload-neutral Fabric fundamentals and shared patterns · `common`
- [Notebook guide](https://github.com/microsoft/skills-for-fabric/tree/main/common/notebook-authoring): reusable notebook patterns · Cross-skill notebook authoring guidance · `common/notebook-authoring`
- [Agents](https://github.com/microsoft/skills-for-fabric/tree/main/agents): persona entry points · Role-specific instruction wrappers layered on shared skills · `agents`

### Installable bundles

Packaged distributions surfaced to tools

- [Fabric skills bundle](https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-skills): installable bundle · Full packaged skill library for broad Fabric coverage · `plugins/fabric-skills`
- [Fabric authoring bundle](https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-authoring): installable bundle · Focused bundle for creation and automation workflows · `plugins/fabric-authoring`
- [Fabric consumption bundle](https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-consumption): installable bundle · Focused bundle for discovery and querying workflows · `plugins/fabric-consumption`
- [Fabric operations bundle](https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-operations): installable bundle · Focused bundle for diagnostics and performance workflows · `plugins/fabric-operations`
- [Power BI bundle](https://github.com/microsoft/skills-for-fabric/tree/main/plugins/powerbi-authoring): installable bundle · Focused bundle for report and semantic model authoring · `plugins/powerbi-authoring`

### Tool integration

Plugin and MCP surfaces that expose the content

- [Plugin manifests](https://github.com/microsoft/skills-for-fabric/blob/main/plugins/fabric-skills/.github/plugin/plugin.json): distribution manifest · Bundle-level plugin.json and MCP manifests · `plugins/fabric-skills/.github/plugin/plugin.json`
- [MCP setup](https://github.com/microsoft/skills-for-fabric/tree/main/mcp-setup): optional runtime bridge · Scripts and templates for connecting tools to live Fabric APIs · `mcp-setup`
- [MCP guide](https://github.com/microsoft/skills-for-fabric/blob/main/docs/mcp-servers-guide.md): integration docs · Explains how skills connect to live MCP servers · `docs/mcp-servers-guide.md`
- [Prompt examples](https://github.com/microsoft/skills-for-fabric/tree/main/prompt_examples): validation examples · Representative user prompts and expected skill coverage · `prompt_examples`

### Skill domains

Representative workload and workflow areas

- [Skills](https://github.com/microsoft/skills-for-fabric/tree/main/skills): workflow library · Primary task-oriented instruction set for Fabric use cases · `skills`
- [Authoring skills](https://github.com/microsoft/skills-for-fabric/tree/main/skills/spark-authoring-cli): creation workflows · Build and automate Fabric assets across workloads · `skills/spark-authoring-cli`
- [Consumption skills](https://github.com/microsoft/skills-for-fabric/tree/main/skills/semantic-model-consumption): read-only workflows · Discover and query Fabric assets without authoring · `skills/semantic-model-consumption`
- [Operations skills](https://github.com/microsoft/skills-for-fabric/tree/main/skills/spark-operations-cli): diagnostics workflows · Monitor, diagnose, and tune Fabric workloads · `skills/spark-operations-cli`
- [Migration skills](https://github.com/microsoft/skills-for-fabric/tree/main/skills/synapse-migration): migration workflows · Move workloads from Databricks, HDInsight, and Synapse · `skills/synapse-migration`
- [Power BI skills](https://github.com/microsoft/skills-for-fabric/tree/main/skills/powerbi-report-authoring): reporting workflows · Report planning, design, authoring, and management · `skills/powerbi-report-authoring`

## Connections

- README → Skills: describes · Explains the library and distribution model
- README → Fabric skills bundle: publishes · Documents the full bundle as the main package
- Repo policy → README: supports · Legal, security, and release boundaries frame the repo
- Package meta → Plugin manifests: packages · Repo metadata supports bundling and distribution
- Common → Notebook guide: contains · Notebook authoring patterns extend shared guidance
- Skills → Authoring skills: includes · Authoring is one of the major workflow families
- Skills → Consumption skills: includes · Consumption is one of the major workflow families
- Skills → Operations skills: includes · Operations is one of the major workflow families
- Skills → Migration skills: includes · Migration is one of the major workflow families
- Skills → Power BI skills: includes · Reporting and semantic model work is a major family
- Agents → Common: layers on · Persona instructions build on shared fundamentals
- Agents → Skills: guides · Agents select relevant skills for each role
- Fabric skills bundle → Plugin manifests: exposes · Full bundle is surfaced through manifests
- Fabric authoring bundle → Plugin manifests: exposes · Authoring bundle is surfaced through manifests
- Fabric consumption bundle → Plugin manifests: exposes · Consumption bundle is surfaced through manifests
- Fabric operations bundle → Plugin manifests: exposes · Operations bundle is surfaced through manifests
- Power BI bundle → Plugin manifests: exposes · Power BI bundle is surfaced through manifests
- MCP setup → MCP guide: documents · Setup scripts are paired with integration guidance
- MCP setup → Plugin manifests: enables · MCP configuration bridges bundles to live tools
- Prompt examples → Skills: targets · Examples mirror the requests the skills answer
- Common → Authoring skills: feeds · Shared fundamentals support authoring workflows
- Common → Consumption skills: feeds · Shared fundamentals support consumption workflows
- Common → Operations skills: feeds · Shared fundamentals support operational workflows
- Fabric skills bundle → Common: contains · Full bundle packages the shared layer
- Fabric skills bundle → Skills: contains · Full bundle packages the main skills library
- Fabric authoring bundle → Authoring skills: contains · Authoring bundle narrows to creation workflows
- Fabric consumption bundle → Consumption skills: contains · Consumption bundle narrows to read-only workflows
- Fabric operations bundle → Operations skills: contains · Operations bundle narrows to diagnostics workflows
- Power BI bundle → Power BI skills: contains · Power BI bundle narrows to reporting workflows
- MCP guide → MCP setup: relates to · Guide explains how setup activates live connectivity