# Microsoft Skill Creator

Create agent skills for Microsoft technologies using official documentation.

- Repository: https://github.com/MicrosoftDocs/mcp (1964 stars)
- Category: AI and agents
- License: CC-BY-4.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add MicrosoftDocs/mcp --skill microsoft-skill-creator -g -a claude-code -y`
Codex: `npx skills add MicrosoftDocs/mcp --skill microsoft-skill-creator -g -a codex -y`
Cursor: `npx skills add MicrosoftDocs/mcp --skill microsoft-skill-creator -g -a cursor -y`
Gemini CLI: `npx skills add MicrosoftDocs/mcp --skill microsoft-skill-creator -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add MicrosoftDocs/mcp`

## Description

Create agent skills for Microsoft technologies using official documentation. Use whenever the user wants to build, generate, or scaffold a skill for any Microsoft technology (Azure, .NET, M365, VS Code, Bicep, etc.), even phrased casually like "make a skill for Cosmos DB." Investigates the topic via official docs, then generates a hybrid skill with essential knowledge stored locally and dynamic lookups for depth.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Microsoft Skill Creator

Create hybrid skills for Microsoft technologies that store essential knowledge locally while enabling dynamic Learn MCP lookups for deeper details.

## About Skills

Skills are modular packages that extend agent capabilities with specialized knowledge and workflows. A skill transforms a general-purpose agent into a specialized one for a specific domain.

### Skill Structure

```
skill-name/
├── SKILL.md (required)     # Frontmatter (name, description) + instructions
├── references/             # Documentation loaded into context as needed
├── sample_codes/           # Working code examples
└── assets/                 # Files used in output (templates, etc.)
```

### Key Principles

- **Frontmatter is critical**: `name` and `description` determine when the skill triggers, be clear and comprehensive
- **Concise is key**: Only include what agents don't already know; context window is shared
- **No duplication**: Information lives in SKILL.md OR reference files, not both

## Learn MCP Tools

| Tool | Purpose | When to Use |
|------|---------|-------------|
| `microsoft_docs_search` | Search official docs | First pass discovery, finding topics |
| `microsoft_docs_fetch` | Get full page content | Deep dive into important pages |
| `microsoft_code_sample_search` | Find code examples | Get implementation patterns |

### CLI Alternative

If the Learn MCP server is not available, use the `mslearn` CLI from the command line instead:

```sh
# Run directly (no install needed)
npx @microsoft/learn-cli search "semantic kernel overview"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "semantic kernel overview"
```

| MCP Tool | CLI Command |
|----------|-------------|
| `microsoft_docs_search(query: "...")` | `mslearn search "..."` |
| `microsoft_code_sample_search(query: "...", language: "...")` | `mslearn code-search "..." --language ...` |
| `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` |

The rest: https://github.com/MicrosoftDocs/mcp/blob/HEAD/skills/microsoft-skill-creator/SKILL.md