From be14acfff7cc748943b7bfa9573928f0337c8d95 Mon Sep 17 00:00:00 2001 From: "Mike Kinsman (He/Him)" <32281167+mikekinsman@users.noreply.github.com> Date: Wed, 20 May 2026 09:52:10 -0700 Subject: [PATCH 1/3] Use aka.ms short links for all Book of News references Replace direct news.microsoft.com URLs with aka.ms redirects so we can update targets without changing the skill. Add Build 2025 Book of News link that was previously missing. - aka.ms/build2026-news - aka.ms/build2025-news - aka.ms/ignite2025-news Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- skills/microsoft-build/SKILL.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/skills/microsoft-build/SKILL.md b/skills/microsoft-build/SKILL.md index 63ae69f..270a9c1 100644 --- a/skills/microsoft-build/SKILL.md +++ b/skills/microsoft-build/SKILL.md @@ -433,7 +433,7 @@ Use MCP tools (or the mslearn CLI fallback) deliberately, not speculatively: 3. Fetch full pages for high-value results. A search result snippet may lack the migration steps or version details the developer needs. Use microsoft_docs_fetch on the most relevant URLs. 4. Scope searches to the inventory. Do not search for technologies the developer does not use. 5. Try multiple query formulations when initial results are weak. If "what's new Azure Cosmos DB" returns generic content, try "Azure Cosmos DB changelog 2026" or "Azure Cosmos DB preview features." -6. For broad questions ("what's new for my project", "what changed at Build"), always fetch the Book of News (`news.microsoft.com/{event}-{year}-book-of-news/`). The Book of News groups announcements by theme, names related sessions, and links to blog posts and docs. It surfaces announcements that do not appear in session titles or Learn what's-new pages — in testing, it found 6 major announcements and 8 additional sessions that catalog keyword search alone missed. Fetch it early as a discovery step, then follow through to Learn docs for technical detail. For narrow questions ("tell me about session BRK155"), the Book of News is optional. +6. For broad questions ("what's new for my project", "what changed at Build"), always fetch the Book of News (see URLs in the reference table below). The Book of News groups announcements by theme, names related sessions, and links to blog posts and docs. It surfaces announcements that do not appear in session titles or Learn what's-new pages — in testing, it found 6 major announcements and 8 additional sessions that catalog keyword search alone missed. Fetch it early as a discovery step, then follow through to Learn docs for technical detail. For narrow questions ("tell me about session BRK155"), the Book of News is optional. 7. Use what's-new pages on Learn when they exist. Many services have dedicated pages following patterns like `/azure/{service}/whats-new` or `/dotnet/core/whats-new/`. Try fetching these directly with microsoft_docs_fetch for a comprehensive changelog. ## Session catalog cross-reference @@ -508,9 +508,9 @@ A good response from this skill: | Build 2026 session catalog | `https://aka.ms/build2026-session-info` | | Build 2025 session catalog | `https://aka.ms/build2025-session-info` | | Ignite 2025 session catalog | `https://aka.ms/ignite2025-session-info` | -| Build 2026 Book of News | `https://news.microsoft.com/build-2026-book-of-news/` | -| Ignite 2025 Book of News | `https://news.microsoft.com/ignite-2025-book-of-news/` | -| Book of News pattern | `https://news.microsoft.com/{event}-{year}-book-of-news/` | +| Build 2026 Book of News | `https://aka.ms/build2026-news` | +| Build 2025 Book of News | `https://aka.ms/build2025-news` | +| Ignite 2025 Book of News | `https://aka.ms/ignite2025-news` | | Learn MCP Server | `https://learn.microsoft.com/api/mcp` | | Learn MCP Server docs | `https://learn.microsoft.com/en-us/training/support/mcp` | | Azure Agent Skills (product names) | `https://github.com/MicrosoftDocs/Agent-Skills` | From fd6a396ac2e0fad0e904087d6d8d90706aeb5a0a Mon Sep 17 00:00:00 2001 From: Mike Kinsman <32281167+mikekinsman@users.noreply.github.com> Date: Wed, 20 May 2026 10:48:05 -0700 Subject: [PATCH 2/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- skills/microsoft-build/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/microsoft-build/SKILL.md b/skills/microsoft-build/SKILL.md index 270a9c1..c5826ee 100644 --- a/skills/microsoft-build/SKILL.md +++ b/skills/microsoft-build/SKILL.md @@ -433,7 +433,7 @@ Use MCP tools (or the mslearn CLI fallback) deliberately, not speculatively: 3. Fetch full pages for high-value results. A search result snippet may lack the migration steps or version details the developer needs. Use microsoft_docs_fetch on the most relevant URLs. 4. Scope searches to the inventory. Do not search for technologies the developer does not use. 5. Try multiple query formulations when initial results are weak. If "what's new Azure Cosmos DB" returns generic content, try "Azure Cosmos DB changelog 2026" or "Azure Cosmos DB preview features." -6. For broad questions ("what's new for my project", "what changed at Build"), always fetch the Book of News (see URLs in the reference table below). The Book of News groups announcements by theme, names related sessions, and links to blog posts and docs. It surfaces announcements that do not appear in session titles or Learn what's-new pages — in testing, it found 6 major announcements and 8 additional sessions that catalog keyword search alone missed. Fetch it early as a discovery step, then follow through to Learn docs for technical detail. For narrow questions ("tell me about session BRK155"), the Book of News is optional. +6. For broad questions ("what's new for my project", "what changed at Build"), always fetch the Book of News. First, use the Book of News links in the **Key resources** section below. If the relevant event or year is not listed there, discover it with targeted searches such as `Microsoft Build {year} Book of News`, `Microsoft Ignite {year} Book of News`, or `{event} {year} Book of News site:news.microsoft.com`. The Book of News groups announcements by theme, names related sessions, and links to blog posts and docs. It surfaces announcements that do not appear in session titles or Learn what's-new pages — in testing, it found 6 major announcements and 8 additional sessions that catalog keyword search alone missed. Fetch it early as a discovery step, then follow through to Learn docs for technical detail. For narrow questions ("tell me about session BRK155"), the Book of News is optional. 7. Use what's-new pages on Learn when they exist. Many services have dedicated pages following patterns like `/azure/{service}/whats-new` or `/dotnet/core/whats-new/`. Try fetching these directly with microsoft_docs_fetch for a comprehensive changelog. ## Session catalog cross-reference From b88646367a1e467820e5af1b2eaebb583cc8903f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 20 May 2026 17:51:57 +0000 Subject: [PATCH 3/3] chore: bump plugin manifest versions to 1.0.2 Agent-Logs-Url: https://github.com/microsoft/Build-CLI/sessions/ac0d0496-c964-47b0-a76e-071164b1d6e7 Co-authored-by: mikekinsman <32281167+mikekinsman@users.noreply.github.com> --- .claude-plugin/plugin.json | 2 +- .github/plugin/plugin.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index d8c3d38..ee3cd92 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "microsoft-events", "description": "Connect your project to Microsoft Build and Ignite sessions — discover relevant talks, explore what's new for your stack, and plan next steps from your development environment.", - "version": "1.0.1", + "version": "1.0.2", "author": { "name": "Microsoft" }, diff --git a/.github/plugin/plugin.json b/.github/plugin/plugin.json index 77ea67e..7922611 100644 --- a/.github/plugin/plugin.json +++ b/.github/plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "microsoft-events", "description": "Connect your project to Microsoft Build and Ignite sessions — discover relevant talks, explore what's new for your stack, and plan next steps from your development environment.", - "version": "1.0.1", + "version": "1.0.2", "author": { "name": "Microsoft", "url": "https://www.microsoft.com"