From 9d1f3bdf956effd54be73b02e4ec60726f78bddb Mon Sep 17 00:00:00 2001 From: Tianqi Zhang Date: Fri, 20 Mar 2026 08:33:44 +0800 Subject: [PATCH 1/2] Improve skill descriptions for better triggering and clarity Rewrite description and compatibility frontmatter across all three skills to reduce undertriggering, sharpen the boundary between docs (conceptual) and code-reference (producing/fixing code), and clarify that the mslearn CLI is a first-class alternative to the MCP server. Co-Authored-By: Claude Opus 4.6 --- skills/microsoft-code-reference/SKILL.md | 4 ++-- skills/microsoft-docs/SKILL.md | 4 ++-- skills/microsoft-skill-creator/SKILL.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/skills/microsoft-code-reference/SKILL.md b/skills/microsoft-code-reference/SKILL.md index 61bc2fe7..6998ae21 100644 --- a/skills/microsoft-code-reference/SKILL.md +++ b/skills/microsoft-code-reference/SKILL.md @@ -1,8 +1,8 @@ --- name: microsoft-code-reference -description: Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs. +description: Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs. Use whenever the user is writing, debugging, or reviewing code that touches any Microsoft SDK, .NET library, Azure client library, or Microsoft API—even if they don't ask for a "reference." Catches hallucinated methods, wrong signatures, and deprecated patterns. If the task involves producing or fixing Microsoft-related code, this is the right skill. context: fork -compatibility: Works best with Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp). Can also use the mslearn CLI as a fallback. +compatibility: Uses Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp) or the mslearn CLI (`npx @microsoft/learn-cli`). Either works equally well. --- # Microsoft Code Reference diff --git a/skills/microsoft-docs/SKILL.md b/skills/microsoft-docs/SKILL.md index aaeedef0..ec7c2b3e 100644 --- a/skills/microsoft-docs/SKILL.md +++ b/skills/microsoft-docs/SKILL.md @@ -1,8 +1,8 @@ --- name: microsoft-docs -description: Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices. +description: Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill. context: fork -compatibility: Works best with Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp). Can also use the mslearn CLI as a fallback. +compatibility: Uses Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp) or the mslearn CLI (`npx @microsoft/learn-cli`). Either works equally well. --- # Microsoft Docs diff --git a/skills/microsoft-skill-creator/SKILL.md b/skills/microsoft-skill-creator/SKILL.md index 6193f087..7a1d934c 100644 --- a/skills/microsoft-skill-creator/SKILL.md +++ b/skills/microsoft-skill-creator/SKILL.md @@ -1,8 +1,8 @@ --- name: microsoft-skill-creator -description: Create agent skills for Microsoft technologies using Learn MCP tools. Use when users want to create a skill that teaches agents about any Microsoft technology, library, framework, or service (Azure, .NET, M365, VS Code, Bicep, etc.). Investigates topics deeply, then generates a hybrid skill storing essential knowledge locally while enabling dynamic deeper investigation. +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. context: fork -compatibility: Works best with Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp). Can also use the mslearn CLI as a fallback. +compatibility: Uses Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp) or the mslearn CLI (`npx @microsoft/learn-cli`). Either works equally well. --- # Microsoft Skill Creator From 434e5d0efc4ab7d3aad1549f32f881090e1e889e Mon Sep 17 00:00:00 2001 From: Tianqi Zhang Date: Fri, 20 Mar 2026 08:42:41 +0800 Subject: [PATCH 2/2] Align compatibility wording: MCP primary, CLI as fallback Matches the "CLI Alternative" body sections which already frame the CLI as a fallback when the MCP server is unavailable. Co-Authored-By: Claude Opus 4.6 --- skills/microsoft-code-reference/SKILL.md | 2 +- skills/microsoft-docs/SKILL.md | 2 +- skills/microsoft-skill-creator/SKILL.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/skills/microsoft-code-reference/SKILL.md b/skills/microsoft-code-reference/SKILL.md index 6998ae21..f681515d 100644 --- a/skills/microsoft-code-reference/SKILL.md +++ b/skills/microsoft-code-reference/SKILL.md @@ -2,7 +2,7 @@ name: microsoft-code-reference description: Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs. Use whenever the user is writing, debugging, or reviewing code that touches any Microsoft SDK, .NET library, Azure client library, or Microsoft API—even if they don't ask for a "reference." Catches hallucinated methods, wrong signatures, and deprecated patterns. If the task involves producing or fixing Microsoft-related code, this is the right skill. context: fork -compatibility: Uses Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp) or the mslearn CLI (`npx @microsoft/learn-cli`). Either works equally well. +compatibility: Primarily uses the Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp); if that is unavailable, fall back to the mslearn CLI (`npx @microsoft/learn-cli`). --- # Microsoft Code Reference diff --git a/skills/microsoft-docs/SKILL.md b/skills/microsoft-docs/SKILL.md index ec7c2b3e..a5129731 100644 --- a/skills/microsoft-docs/SKILL.md +++ b/skills/microsoft-docs/SKILL.md @@ -2,7 +2,7 @@ name: microsoft-docs description: Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill. context: fork -compatibility: Uses Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp) or the mslearn CLI (`npx @microsoft/learn-cli`). Either works equally well. +compatibility: Primarily uses the Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp); if that is unavailable, fall back to the mslearn CLI (`npx @microsoft/learn-cli`). --- # Microsoft Docs diff --git a/skills/microsoft-skill-creator/SKILL.md b/skills/microsoft-skill-creator/SKILL.md index 7a1d934c..ff332877 100644 --- a/skills/microsoft-skill-creator/SKILL.md +++ b/skills/microsoft-skill-creator/SKILL.md @@ -2,7 +2,7 @@ name: microsoft-skill-creator 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. context: fork -compatibility: Uses Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp) or the mslearn CLI (`npx @microsoft/learn-cli`). Either works equally well. +compatibility: Primarily uses the Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp); if that is unavailable, fall back to the mslearn CLI (`npx @microsoft/learn-cli`). --- # Microsoft Skill Creator