Add Azure Local skills by tfrankland2 · Pull Request #2163 · microsoft/GitHub-Copilot-for-Azure

Tim Frankland (tfrankland2) · 2026-05-05T13:03:28Z

Summary

add a dedicated Azure Local skill with workflows and references for deployment, operations, workloads, networking/security, updates, and troubleshooting
register the new skill in skill test coverage
update README coverage for Azure Local scenarios

Validation

npm install
npm run build
npm run tokens check (existing repo baseline still reports 90 over-limit files; new azure-local/SKILL.md is under the limit)
npm run build && scripts reference validation
tests unit suite
git diff --check

Tim Frankland (tfrankland2) · 2026-05-05T13:11:17Z

Tim Frankland (@tfrankland2) please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.
@microsoft-github-policy-service agree [company="{your company}"]
Options:

(default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.
@microsoft-github-policy-service agree
(when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.
@microsoft-github-policy-service agree company="Microsoft"
Contributor License Agreement

@microsoft-github-policy-service agree company="Microsoft"

Copilot

Pull request overview

Adds a new azure-local skill to the Azure skills plugin, providing Azure Local (Azure Stack HCI) deployment/operations/workload/security/update/troubleshooting guidance, and wires it into the scheduled integration test skill list.

Changes:

Added a new plugin/skills/azure-local/ skill with core routing plus workflow and reference markdown.
Registered azure-local in tests/skills.json and included it in the integration schedule.
Updated plugin/README.md to mention Azure Local under Compute & Containers.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/skills.json	Adds `azure-local` to the skill registry and scheduled integration run list.
plugin/skills/azure-local/SKILL.md	Introduces the Azure Local skill frontmatter + top-level routing/rules/refs.
plugin/skills/azure-local/version.json	Adds per-skill NBGV version configuration.
plugin/skills/azure-local/workflows/plan-and-deploy/plan-and-deploy.md	Deployment planning/intake and guarded deployment sequencing.
plugin/skills/azure-local/workflows/operate-and-update/operate-and-update.md	Ops + lifecycle update flow, including update safety guidance and inventory patterns.
plugin/skills/azure-local/workflows/workload-management/workload-management.md	VM/AKS hybrid/workload management routing and safety checks.
plugin/skills/azure-local/workflows/networking-and-security/networking-and-security.md	Networking + security flows, SDN routing, and guardrails.
plugin/skills/azure-local/workflows/troubleshooting/troubleshooting.md	Triage flow, scenario routing, evidence checklist, and safety rules for remediation.
plugin/skills/azure-local/references/docs-map.md	Curated Microsoft Learn URL map for version-aware Azure Local documentation.
plugin/skills/azure-local/references/mcp-and-cli-tools.md	Guidance on MCP/ARG-first discovery plus safe CLI/PowerShell usage boundaries.
plugin/skills/azure-local/references/resource-types.md	Azure Resource Graph resource type patterns and baseline KQL inventory queries.
plugin/skills/azure-local/references/safety-rules.md	Centralized “ask before doing” and high-risk component handling rules.
plugin/README.md	Mentions Azure Local in the “Available Tools” coverage list.

Jon Gallant (jongio)

Clean new skill addition for Azure Local with good workflow separation and safety guardrails. A few suggestions to bring the SKILL.md into full compliance with the repo's skill-files.instructions.md.

Jon Gallant (jongio)

Addresses my previous feedback. The SKILL.md sections now follow the repo's table format conventions and docs-map.md uses latest-version URLs by default. Christian Esqueda (@cesquedamsft) ready for your final approval.

Christian Esqueda (cesquedamsft) · 2026-05-06T15:10:07Z

Looks good to me. Approved.

Jon Gallant (jongio) · 2026-05-13T14:13:03Z

Tim Frankland (@tfrankland2) this has merge conflicts now - can you rebase on main? All my prior feedback is addressed and CI is green, so just the conflict left to sort out.

Add a dedicated Azure Local skill with workflows and references for deployment, operations, workloads, networking, security, updates, and troubleshooting. Update adjacent Azure skills to route Azure Local, Arc VM, AKS hybrid, and lifecycle scenarios to the new skill. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add azure-local to the skill test schedule, update affected trigger snapshots, and remove cross-skill relative markdown links that escaped skill directories. Shorten the azure-upgrade description so its metadata unit test remains within the existing word limit. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Remove extra plugin manifest keywords and avoid treating custom locations as an Azure Local-owned routing signal in adjacent skills. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Remove the azure-upgrade routing change and clarify that Azure MCP support for Azure Local is partial through generic Azure surfaces rather than a dedicated Azure Local tool namespace. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Keep the Azure Local PR focused on adding the new skill and required registration, without modifying existing skill routing. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Align Azure Local Resource Graph examples with existing resource lookup guidance, which describes ARG as a KQL subset. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Address PR review feedback by adding Azure Local unit, trigger, and integration tests, standardizing the top-level skill sections, and keeping the skill entrypoint under the token limit. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Use an inline quoted description so the skill passes the frontmatter validator used by CI. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Tim Frankland (tfrankland2) · 2026-05-13T14:56:51Z

Oops sorry if you got tagged for review. Forced pushed some changes by accident while rebasing.

Should be fixed now Jon Gallant (@jongio) JasonYeMSFT (@JasonYeMSFT)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Jon Gallant (jongio)

All prior feedback addressed - tables for Quick Reference/MCP Tools/Error Handling, version pinning removed from docs-map, README wording reverted. Skill structure looks solid with good progressive disclosure across references and workflows. Safety rules are thorough.

Only remaining blocker is the merge conflict from the rebase - once that's resolved this is good to go.

Tim Frankland (tfrankland2) changed the title ~~Add Azure Local skill~~ Add Azure Local skills May 5, 2026

Tim Frankland (tfrankland2) mentioned this pull request May 5, 2026

Add Azure Local skill coverage #2164

Open

Tim Frankland (tfrankland2) marked this pull request as ready for review May 5, 2026 15:36

Copilot AI review requested due to automatic review settings May 5, 2026 15:36

Copilot started reviewing on behalf of Tim Frankland (tfrankland2) May 5, 2026 15:40 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

Comment thread tests/skills.json

Comment thread plugin/skills/azure-local/SKILL.md Outdated

Christian Esqueda (cesquedamsft) reviewed May 5, 2026

View reviewed changes

Comment thread plugin/skills/azure-local/references/docs-map.md Outdated

Jon Gallant (jongio) reviewed May 6, 2026

View reviewed changes

Comment thread plugin/skills/azure-local/SKILL.md

Comment thread plugin/skills/azure-local/SKILL.md Outdated

Comment thread plugin/skills/azure-local/SKILL.md

Comment thread plugin/skills/azure-local/references/docs-map.md Outdated

Jon Gallant (jongio) reviewed May 6, 2026

View reviewed changes

Jon Gallant (jongio) reviewed May 7, 2026

View reviewed changes

Comment thread plugin/README.md Outdated

github-actions Bot mentioned this pull request May 8, 2026

[repo-status] Weekly Repo Status — May 2–8, 2026 #2201

Closed

Tim Frankland (tfrankland2) and others added 11 commits May 13, 2026 15:39

Refine Azure Local routing metadata

6cbf4c5

Remove extra plugin manifest keywords and avoid treating custom locations as an Azure Local-owned routing signal in adjacent skills. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Remove adjacent Azure Local routing changes

e6314e3

Keep the Azure Local PR focused on adding the new skill and required registration, without modifying existing skill routing. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Use KQL fences for Azure Local ARG examples

bb2a84f

Align Azure Local Resource Graph examples with existing resource lookup guidance, which describes ARG as a KQL subset. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add Azure Local skill tests

3b0e146

Address PR review feedback by adding Azure Local unit, trigger, and integration tests, standardizing the top-level skill sections, and keeping the skill entrypoint under the token limit. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix Azure Local skill frontmatter

1306b83

Use an inline quoted description so the skill passes the frontmatter validator used by CI. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fix: address azure local skill review feedback

64b8757

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fix: clarify azure local mcp tool scope

5af86ad

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fix: revert README wording change

5392a0f

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Tim Frankland (tfrankland2) force-pushed the feature/azure-local-skill branch from 67be1c4 to 8bbac0d Compare May 13, 2026 14:48

Tim Frankland (tfrankland2) requested review from Madhura Bharadwaj (MadhuraBharadwaj-MSFT), Alex Thompson (alex-thompson), rakal-dyh and Sai Koumudi Kaluvakolanu (saikoumudi) as code owners May 13, 2026 14:48

Tim Frankland (tfrankland2) requested a review from joybb as a code owner May 13, 2026 14:48

fix: keep azure local rebase scope

d922943

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Tim Frankland (tfrankland2) force-pushed the feature/azure-local-skill branch from 8bbac0d to d922943 Compare May 13, 2026 14:53

Tim Frankland (tfrankland2) and others added 2 commits May 13, 2026 16:03

fix: reduce azure local skill tokens

c0feb54

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fix: fit azure local skill budget

587c327

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Jon Gallant (jongio) approved these changes May 13, 2026

View reviewed changes

github-actions Bot mentioned this pull request May 14, 2026

[repo-status] Weekly Repo Status — May 8–14, 2026 #2269

Closed

Navigation Menu

Uh oh!

Add Azure Local skills - #2163

Add Azure Local skills#2163
Tim Frankland (tfrankland2) wants to merge 14 commits into
microsoft:mainfrom
tfrankland2:feature/azure-local-skill

Tim Frankland (tfrankland2) commented May 5, 2026 •

edited

Loading

Uh oh!

Tim Frankland (tfrankland2) commented May 5, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Jon Gallant (jongio) left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Jon Gallant (jongio) left a comment

Uh oh!

Christian Esqueda (cesquedamsft) commented May 6, 2026

Uh oh!

Uh oh!

Jon Gallant (jongio) commented May 13, 2026

Uh oh!

Tim Frankland (tfrankland2) commented May 13, 2026

Uh oh!

Jon Gallant (jongio) left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

Tim Frankland (tfrankland2) commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Validation

Uh oh!

Tim Frankland (tfrankland2) commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Jon Gallant (jongio) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Jon Gallant (jongio) left a comment

Choose a reason for hiding this comment

Uh oh!

Christian Esqueda (cesquedamsft) commented May 6, 2026

Uh oh!

Uh oh!

Jon Gallant (jongio) commented May 13, 2026

Uh oh!

Tim Frankland (tfrankland2) commented May 13, 2026

Uh oh!

Jon Gallant (jongio) left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Tim Frankland (tfrankland2) commented May 5, 2026 •

edited

Loading

Tim Frankland (tfrankland2) commented May 5, 2026 •

edited

Loading