Agent Skills

[!WARNING] Work in Progress — This repository is actively being developed.

A collection of skills, prompts, agents, and MCP server configurations designed to supercharge your AI coding agents when working with Microsoft AI SDKs and Azure services.

📖 Read the full blog post: Context-Driven Development: Agent Skills for Microsoft Foundry and Azure

What's This About?

This repo embraces context-driven development — the practice of providing AI coding agents with precisely the right context at the right time. The quality of agent output is directly proportional to the quality and relevance of context it receives.

Modern coding agents (GitHub Copilot CLI, Claude Code, Codex, etc.) are powerful out of the box, but they lack domain-specific knowledge about your SDKs, patterns, and best practices. This repo provides the "onboarding guides" that turn general-purpose agents into specialized experts.

[!IMPORTANT] Don't Use All Skills at Once — Avoid Context Rot

Skills are designed to be used selectively. Context rot occurs when an agent's context window becomes cluttered with irrelevant or outdated information, degrading response quality and causing the agent to lose focus on what matters.

Loading all skills at once will:

• Dilute the agent's attention across unrelated domains
• Waste precious context window tokens
• Cause the agent to conflate patterns from different frameworks

Only copy the specific skills that are absolutely essential for your current project.

Repository Structure

.github/
├── skills/           # Modular knowledge packages for specific domains
├── prompts/          # Reusable prompt templates (.prompt.md)
├── agents/           # Agent persona definitions (.agent.md)
├── agents.md         # Project-wide agent instructions
├── copilot-instructions.md
└── workflows/        # Automated workflows (e.g., docs sync)

.vscode/
└── mcp.json          # MCP server configurations

Available Skills

Each skill is a self-contained knowledge package with a SKILL.md file. Copy only the skills you need to your project's .github/skills/ directory.

Using Skills with Multiple Agents

If you want to use skills across multiple projects or with different agents, you can create symlinks instead of copying files:

<detail

...