ms-fabric-skills-dev-starter

# Microsoft Fabric Skills Starter for AI Coding Agents

Purpose-built Microsoft Fabric scaffolding for AI coding agents. This starter helps external developers and teams move faster with pre-configured Fabric skills, reusable prompts, and agent instructions for GitHub Copilot, Claude Code, Cursor, Windsurf, and Codex.

It is designed for practical Fabric work: Lakehouse engineering, Warehouse and SQL endpoint development, Eventhouse and KQL workflows, Power BI semantic model operations, REST API integration, and cross-workload orchestration.

## Why This Starter

- Fabric-first structure instead of a generic AI agent template
- High-value Fabric skills for Lakehouse, Warehouse, Eventhouse, Power BI, and REST APIs
- Shared instructions that keep multiple coding agents aligned on the same platform conventions
- Ready-to-use MCP setup assets for Fabric-focused agent workflows
- Built-in guidance for auth scopes, pagination, long-running operations, throttling, and OneLake patterns

## Quick Start

### Prerequisites

- Python 3.13+ (see `.python-version`)
- Azure CLI authenticated (`az login`)
- Microsoft Fabric capacity (F2+ or P1+)
- Node.js 18+ (optional, for Fabric MCP server)

### Authentication

```bash
az login
az account get-access-token --resource https://api.fabric.microsoft.com
```

### Use with Your Agent

| Agent | Entry Point |
|-------|-------------|
| GitHub Copilot | `.github/cursor-instructions.md` → auto-loaded |
| Claude Code | `CLAUDE.md` → auto-loaded |
| Cursor | `.cursorrules` → auto-loaded |
| Windsurf | `.windsurfrules` → auto-loaded |
| Codex / Jules | `AGENTS.md` → auto-loaded |
| All agents | `.agents/instructions.md` → full reference |

All entry points route to `.agents/instructions.md` for shared skills and Fabric patterns.

### MCP Setup

If you need to register a remote Fabric MCP server with GitHub Copilot CLI, Claude Desktop, or VS Code, use the tracked setup assets in `mcp-setup/`.

Examples:

```powershell
.\mcp-setup\register-fabr