feat: Expand microsoft-docs skill to cover the full Microsoft documentation ecosystem#673
Open
ChrisMcKee1 wants to merge 7 commits intogithub:mainfrom
Open
feat: Expand microsoft-docs skill to cover the full Microsoft documentation ecosystem#673ChrisMcKee1 wants to merge 7 commits intogithub:mainfrom
ChrisMcKee1 wants to merge 7 commits intogithub:mainfrom
Conversation
…mantic Kernel coverage Major improvements to the microsoft-docs skill: - Add Microsoft Agent Framework section with two Context7 sources: /websites/learn_microsoft_en-us_agent-framework (tutorials, 2282 snippets) /microsoft/agent-framework (GitHub repo API detail, 1177 snippets) - Add comprehensive DevUI workflow reference covering installation, programmatic launch, directory discovery, tracing, OpenAI-compatible API, OpenAI proxy, authentication, UI modes, .NET integration, and external observability export - Add Semantic Kernel section with three quality-ranked sources covering Learn docs, agent framework subset, and GitHub repo - Add guidance on when GitHub repo sources beat published docs (DevUI API reference, .NET integration, extension samples) - Expand decision table with agent framework scenarios - Add agent framework query examples for DevUI, SK, and workflows - Highlight microsoft_code_sample_search with language filter for working code snippets Tested all sources against identical queries to verify quality rankings.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR significantly expands the microsoft-docs skill to cover Microsoft Agent Framework, DevUI, and Semantic Kernel alongside existing Azure, .NET, VS Code, GitHub, and Aspire coverage. The skill now leverages both Microsoft Learn MCP Server and Context7 to provide comprehensive documentation access across official Microsoft websites and GitHub repositories.
Changes:
- Added comprehensive Microsoft Agent Framework and DevUI documentation coverage with quality-ranked Context7 sources
- Added Semantic Kernel documentation sources (Learn website, agent framework subset, GitHub repo)
- Expanded tool documentation to include Context7 alongside Microsoft Learn MCP Server
- Added detailed DevUI workflow reference with installation, tracing, API, and .NET integration guidance
- Updated README.skills.md description to reflect expanded coverage
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| skills/microsoft-docs/SKILL.md | Major expansion adding Agent Framework, DevUI, and Semantic Kernel coverage with Context7 integration, detailed workflow guides, and comprehensive query examples |
| docs/README.skills.md | Updated skill description to match the expanded SKILL.md description |
The skill is about how to research docs, not a DevUI tutorial. Replace the 10-step DevUI workflow checklist with a research strategy table showing which tool to use for each type of DevUI information.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
ChrisMcKee1
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does
The existing
microsoft-docsskill only coversmicrosoft_docs_searchandmicrosoft_docs_fetch— two tools that query learn.microsoft.com. That works for Azure, .NET, and M365, but a large portion of Microsoft's documentation lives elsewhere:The original skill had no way to discover or navigate these sources.
What changed
This update rewrites the skill to teach Copilot how to find the right documentation source for any Microsoft technology, using two complementary toolsets:
microsoft_docs_search,microsoft_code_sample_search,microsoft_docs_fetch) — for anything on learn.microsoft.comresolve-library-id,query-docs) — for documentation that lives outside Learn, including VS Code docs, GitHub docs, Aspire.dev, GitHub CLI, and GitHub repo README-level contentKey additions
What was removed
The original had only a basic tools table, a short "When to Use" list, and generic query tips. All of that content is preserved and expanded in the rewrite.
Why this matters
Without this skill update, an agent using the microsoft-docs skill would only search learn.microsoft.com and miss documentation for VS Code extensions, GitHub Actions, Aspire integrations, and Agent Framework API details — all of which are core Microsoft technologies with docs hosted outside Learn.