[works but do not merge] Refactor plugin layout for cross-agent compatibility

[TianqiZhang]

Summary

This change restructures plugin packaging and metadata to keep compatibility coherent across all three target agent ecosystems:

• Claude Code
• GitHub Copilot CLI
• Codex

What changed

• Consolidated shared plugin assets under plugins/microsoft-docs/
• Kept root-level files as marketplace catalogs or compatibility shims only
• Aligned plugin identity metadata across ecosystem manifests
• Updated docs and validation wiring to reflect the new structure

Validation

• Repository structure and plugin wiring validated with the repo validator

[Copilot]

Pull request overview

Refactors the repository’s plugin packaging so Claude Code, GitHub Copilot CLI, and Codex can all consume a single shared plugin bundle under plugins/microsoft-docs/, with root-level files acting as marketplace catalogs or install shims.

Changes:

• Consolidates plugin runtime assets (skills + MCP configs + manifests) under plugins/microsoft-docs/.
• Updates marketplace catalogs/shims for Claude, Copilot, and Codex to point at the shared plugin subfolder.
• Updates validation script and docs to enforce/describe the new structure and metadata alignment.

Reviewed changes

Copilot reviewed 11 out of 16 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
scripts/validate-repo.ps1	Updates validator logic to enforce new plugin layout, manifest identity alignment, and marketplace wiring.
README.md	Updates skill links and quick-setup instructions for Copilot CLI, Claude Code, and Codex.
AGENTS.md	Documents the new shared plugin package layout and sync rules across ecosystems.
plugins/microsoft-docs/plugin.json	Bumps plugin version and adds skills/MCP wiring for the shared package manifest.
plugins/microsoft-docs/.mcp.json	Adds plugin-scoped MCP server config for Claude/Copilot shape.
plugins/microsoft-docs/.codex.mcp.json	Adds Codex-specific MCP config using Codex’s direct server map shape.
plugins/microsoft-docs/.codex-plugin/plugin.json	Updates Codex manifest version and points to .codex.mcp.json.
plugins/microsoft-docs/.claude-plugin/plugin.json	Adds Claude package manifest inside the shared plugin directory.
plugins/microsoft-docs/skills/microsoft-docs/SKILL.md	Adds/relocates the “microsoft-docs” skill into the shared plugin package.
plugins/microsoft-docs/skills/microsoft-code-reference/SKILL.md	Adds/relocates the code-reference skill into the shared plugin package.
plugins/microsoft-docs/skills/microsoft-skill-creator/SKILL.md	Adds the skill-creator skill into the shared plugin package.
plugins/microsoft-docs/skills/microsoft-skill-creator/references/skill-templates.md	Adds reusable templates referenced by the skill-creator skill.
.github/plugin/plugin.json	Updates Copilot direct-install shim to point at shared plugin assets + aligns identity fields.
.github/plugin/marketplace.json	Adds a Copilot marketplace catalog pointing to the shared plugin subfolder.
.claude-plugin/marketplace.json	Updates Claude marketplace entry to point to ./plugins/microsoft-docs and sets version.
.agents/plugins/marketplace.json	Updates Codex marketplace catalog name/displayName and points to ./plugins/microsoft-docs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.