[Paymaun (digimaun)]

Summary

• Adds a GitHub Copilot plugin, siteops, published through a scale-kit marketplace in this repository. Install it in Copilot CLI with copilot plugin marketplace add Azure/digital-ops-scale-kit and copilot plugin install siteops@scale-kit, or from VS Code and the Copilot app.
• Its skills let you ask Copilot in plain language to install Site Ops from a verified release, deploy AIO to one cluster or a fleet with optional Secret Sync, upgrade AIO, explore what a release can deploy and diagnose Site Ops errors.
• Each skill uses Site Ops for every change and asks before it installs, enrolls a source or creates a file. Copilot shows the plan and stops. After you reply yes, it runs the same command with deploy and --yes. Before installing AIO, it checks the cluster's own subscription and resource group for an existing instance.
• The plugin uses the Agent Plugins 1.0 format. The README, documentation index and repository guide link to the plugin guide, and CI runs when plugins or documentation change.

Validation

• Tests check each skill against the Agent Skills format, resolve every link and heading, parse every siteops command with the current CLI, and require a plan and a confirmation question before every deploy. They also check that resource group queries name their subscription, that install commands use options the bootstrap scripts accept, and that the stated defaults and AIO versions match the workspace. Each check fails when its rule is broken.
• Copilot CLI sessions with the plugin loaded from this branch, using stand-in commands, confirmed that plain-language requests select the right skill, stop after the plan, refuse a cluster that already runs AIO, and deploy only after the reply yes.
• Unit tests with the CI invocation pass on Windows.

Replaces #80 and includes fixes for its review comments.

[Copilot]

🔵 Needs a closer look

Target-selection defects need correction, and infrastructure-changing agent workflows require human validation of confirmation and recovery behavior.

2 open issues

• Preserve explicitly requested subscription without a cluster name · New
• Validate instance cluster association before selecting it · New

What changed in this PR

Adds a Site Ops plugin for GitHub Copilot, exposing installation and AIO operations through guided skills.

Changes:

• Publishes the plugin through a repository marketplace.
• Adds five skills with planning and confirmation safeguards.
• Adds validation tests, documentation links and CI triggers.

File	Description
tests/​test_copilot_plugin.py	Validates manifests, links, commands and safeguards.
README.md	Introduces the plugin installation route.
plugins/​siteops/​skills/​upgrade-aio/​SKILL.md	Guides AIO upgrades.
plugins/​siteops/​skills/​troubleshoot-siteops/​SKILL.md	Guides diagnosis and recovery.
plugins/​siteops/​skills/​troubleshoot-siteops/​references/​errors.md	Maps errors to remedies.
plugins/​siteops/​skills/​install-siteops/​SKILL.md	Guides verified Site Ops installation.
plugins/​siteops/​skills/​explore-content/​SKILL.md	Supports read-only content exploration.
plugins/​siteops/​skills/​deploy-aio/​SKILL.md	Guides AIO and Secret Sync deployment.
plugins/​siteops/​skills/​deploy-aio/​references/​fleet.md	Adds multi-cluster deployment guidance.
plugins/​siteops/​README.md	Documents installation, requirements and safeguards.
plugins/​siteops/​plugin.json	Defines plugin metadata.
docs/​repository-guide.md	Describes the plugin directory.
docs/​README.md	Links the plugin guide.
.github/​workflows/​ci.yaml	Triggers CI for plugin and documentation changes.
.github/​plugin/​marketplace.json	Registers the Site Ops plugin.

_{Review effort: Balanced}