---
title: "Microsoft Learn contribution guide: review, role & definition · Undominated.ai"
canonical: https://undominated.ai/agents/github-microsoft-learn-contributor/
description: "Guides a documentation contribution through article structure, Microsoft style, metadata and review feedback."
---

# Microsoft Learn contribution guide: review, role & definition · Undominated.ai

> Guides a documentation contribution through article structure, Microsoft style, metadata and review feedback.

[← Explore all agents](/agents/)

DOCUMENTATION CONTRIBUTION / GitHub community

# Microsoft Learn contribution guide

Guides a documentation contribution through article structure, Microsoft style, metadata and review feedback.

 [Use this definition ↓](#setup)[Original source ↗](https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/agents/microsoft_learn_contributor.agent.md)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 5 linked sources
 Publisher GitHub community
 Licence [MIT ↗](https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/LICENSE)
 Revision f25421d3f1b8
 [Read what was—and wasn’t—checked ↓](#review)

“Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices.”

 [GitHub community · upstream description ↗](https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/agents/microsoft_learn_contributor.agent.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It distinguishes conceptual articles, tutorials, quickstarts and reference material before reviewing structure.
- Its review combines terminology, YAML metadata, descriptive links and repository contribution conventions.
- The profile mentors a first-time Learn contributor and requires current Microsoft product names, including Entra ID rather than Azure AD.
- It tells the host to verify current docs through microsoft.docs.mcp before treating a style rule as settled.

### A good fit for

 - Provide an existing article/draft, its Learn repository and the requested contribution scope.
- Receive concrete before/after editorial changes, technical-verification gaps and a contribution checklist.
- Editing a Microsoft Learn article for style, naming, and accessibility before a human opens the pull request.
- Correcting product names such as Copilot, Entra ID, and Microsoft 365 in contributor prose.

### Weigh up before choosing

 - The legacy MCP/tool aliases need mapping to the installed client; the definition does not configure the Learn connection.
- Product naming examples and style rules can age. Verify the current article/repository guidance; no contribution was submitted or code example executed.
- Source-only listing: inspect the upstream context and referenced dependencies before adapting this definition.
- Tools include edit/editFiles, new, openSimpleBrowser, and microsoft.docs.mcp, so the file can edit the workspace and reach Microsoft documentation.
- The file does not publish a page. It guides a contributor and says to stay current because the guidelines change.
- It forbids the older names Azure AD and Microsoft Docs for the products it lists.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - agents/microsoft_learn_contributor.agent.md (complete definition)
- LICENSE (applicable redistribution terms)
- Host custom-agent documentation; repository installation guidance where applicable
- Official Learn contribution overview and MCP overview

### Our findings

 - The profile declares local edits plus a legacy microsoft.docs.mcp identifier for current documentation lookup.
- Current Microsoft documentation describes an unauthenticated Streamable HTTP Learn endpoint for search, article fetch and code-sample search.
- The persona assumes the contributor has never contributed to Microsoft Learn and walks through structure, style, technical accuracy, and accessibility.
- Product-name rules reject Azure AD, AAD, and Microsoft Docs in favour of Microsoft Entra ID and Microsoft Learn.
- Tool usage says to call microsoft.docs.mcp for current guidelines, to search the web for branding, and to use editFiles for formatting examples.
- The file does not merge or publish the article. Quality guidance prefers fewer contributions over many poor ones.

### Not established by this review

 - No agent was installed or invoked. Host/model compatibility, task accuracy and runtime behaviour were not tested.
- The resource was not executed and its tools were not called.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Use the role in your project.

[Upstream setup instructions ↗](https://docs.github.com/en/copilot/reference/custom-agents-configuration)
 - Read the pinned definition and MIT licence; review the host permissions before use.
- Place the profile in .github/agents/ after adapting tool identifiers; separately configure the official Learn MCP endpoint and review the target repository contribution rules.
- Provide an existing article/draft, its Learn repository and the requested contribution scope.

### Before you start

 - Copilot and a permitted documentation checkout
- A GitHub account for submitting documentation changes
- A separately configured Learn MCP client for live references

### Compatibility

GitHub Copilot

### Implementation

Markdown

### Host-mediated repository and tool access

 - Declared tools: changes, search/codebase, edit/editFiles, new, openSimpleBrowser, problems, search, search/searchResults, microsoft.docs.mcp. The host enforces tool access; shell execution can modify files or contact services.

### Cost model

The definition is reusable under its stated licence. Host/model usage, execution environments and connected services can incur separate charges.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Complete upstream definition at reviewed commit ↗](https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/agents/microsoft_learn_contributor.agent.md) Checked 2026-10-14 https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/agents/microsoft_learn_contributor.agent.md Supports: Workflow, inputs and outputs, Declared tools and constraints, Selection and limitations
- [Applicable upstream redistribution licence ↗](https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/LICENSE) Checked 2026-10-14 https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/LICENSE Supports: Licence and attribution requirements
- [Host custom-agent configuration ↗](https://docs.github.com/en/copilot/reference/custom-agents-configuration) Checked 2026-10-14 https://docs.github.com/en/copilot/reference/custom-agents-configuration Supports: Host setup and permission defaults
- [Microsoft Learn contribution requirements ↗](https://learn.microsoft.com/en-us/contribute/content/) Checked 2026-10-14 https://learn.microsoft.com/en-us/contribute/content/ Supports: Contribution paths and accounts
- [Microsoft Learn MCP overview ↗](https://learn.microsoft.com/en-us/training/support/mcp) Checked 2026-10-14 https://learn.microsoft.com/en-us/training/support/mcp Supports: Endpoint, capabilities and authentication

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### API Reference Builder ↗ Builds a versioned API or configuration reference from an inventory of the implementation’s public interfaces.](/agents/wshobson-reference-builder/)[### GitHub Docs builder writer ↗ Writes GitHub Docs for the Builder persona and keeps enterprise-admin material out of that article.](/agents/github-docs-builder-writer/)[### GitHub Docs content pipeline update ↗ Updates official reference articles from ephemeral source docs and refuses instructions in those docs that ask for secrets or unrelated actions.](/agents/github-docs-content-pipeline-update/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Find reusable instructions](/skills/)
- [Inspect connections](/mcp-servers/)
- [Build a toolkit](/tools/)
- [Choose the model](/compare/)
