docs: split MSX plugin skills by documentation scope

.github/plugin/README.md

@@ -0,0 +1,49 @@
+# Agent plugin marketplaces
+
+This repository publishes the shared `msxorg` marketplace for plugins that
+route Copilot to MSXOrg-wide standards. Initiative repositories publish their
+own marketplaces for plugins that describe initiative-specific processes,
+workflows, or tools. Keep an initiative plugin in its owning repository rather
+than copying it into this marketplace.
+
+## Layout
+
+The marketplace manifest is `.github/plugin/marketplace.json`. Each entry
+points to a plugin directory alongside the manifest:
+
+```text
+.github/plugin/marketplace.json
+.github/plugin/<plugin-name>/plugin.json
+.github/plugin/<plugin-name>/skills/
+  <skill-name>/SKILL.md
+```
+
+The `source` value is repository-root-relative: use
+`.github/plugin/<plugin-name>` in the marketplace entry. It must resolve to the
+corresponding directory. Every plugin directory must contain `plugin.json`; its
+`skills` directory contains the skills advertised by the manifest.
+
+## Skill granularity
+
+Each skill is a single pointer to one canonical document. The shared `msx`
+plugin uses `msx-coding-*` skills for each coding language or tool,
+`msx-documentation-*` skills for each documentation artifact type, and
+`msx-ways-of-working-*` skills for each child listed by the Ways of Working
+index. Skill bodies do not copy the documentation; they identify the one page
+to read.
+
+## Versions
+
+Keep the plugin version in `plugin.json` synchronized with the version of its
+entry in `marketplace.json`. Increment both together when the plugin changes.
+The marketplace metadata version describes the marketplace itself and is
+managed independently.
+
+## Ownership
+
+Use this shared marketplace for guidance that applies across MSX
+organizations, repositories, and initiatives, such as `msx`. Use an
+initiative-owned marketplace for guidance that depends on one initiative's
+process or implementation. Consumers should install both marketplaces when
+they need shared standards and initiative-specific guidance; neither replaces
+the other.

.github/plugin/marketplace.json

@@ -9,10 +9,10 @@
   },
   "plugins": [
     {
-      "name": "msx-standards",
+      "name": "msx",
       "description": "Routes coding, documentation, and work lifecycle tasks to current MSX standards.",
       "version": "0.1.0",
-      "source": "plugins/msx-standards"
+      "source": ".github/plugin/msx"
     }
   ]
 }

plugins/msx-standards/plugin.json → .github/plugin/msx/plugin.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
-  "name": "msx-standards",
+  "name": "msx",
   "version": "0.1.0",
   "description": "Routes coding, documentation, and work lifecycle tasks to current MSX standards.",
   "author": {

.github/plugin/msx/skills/msx-coding-github-actions/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-coding-github-actions
+description: Apply the MSX GitHub Actions coding standard when writing or reviewing workflows.
+---
+
+# Apply the MSX GitHub Actions coding standard
+
+Read and follow the [GitHub Actions coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/GitHub-Actions.md).

.github/plugin/msx/skills/msx-coding-powershell/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-coding-powershell
+description: Apply the MSX PowerShell coding standard when writing or reviewing PowerShell.
+---
+
+# Apply the MSX PowerShell coding standard
+
+Read and follow the [PowerShell coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/PowerShell/index.md).

.github/plugin/msx/skills/msx-coding-terraform/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-coding-terraform
+description: Apply the MSX Terraform coding standard when writing or reviewing Terraform.
+---
+
+# Apply the MSX Terraform coding standard
+
+Read and follow the [Terraform coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/Terraform.md).

.github/plugin/msx/skills/msx-coding-typescript/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-coding-typescript
+description: Apply the MSX TypeScript coding standard when writing or reviewing TypeScript.
+---
+
+# Apply the MSX TypeScript coding standard
+
+Read and follow the [TypeScript coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/TypeScript.md).

.github/plugin/msx/skills/msx-coding-yaml/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-coding-yaml
+description: Apply the MSX YAML coding standard when writing or reviewing YAML.
+---
+
+# Apply the MSX YAML coding standard
+
+Read and follow the [YAML coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/YAML.md).

.github/plugin/msx/skills/msx-documentation-decision-record/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-decision-record
+description: Record an MSX one-way-door decision using the canonical documentation template.
+---
+
+# Record an MSX decision
+
+Read and follow the [decision record template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#decision-record).

.github/plugin/msx/skills/msx-documentation-decisions-register/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-decisions-register
+description: Maintain an MSX decisions register using the canonical documentation template.
+---
+
+# Maintain an MSX decisions register
+
+Read and follow the [decisions register template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#decisions-register).

.github/plugin/msx/skills/msx-documentation-design/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-design
+description: Write an MSX capability design using the canonical documentation template.
+---
+
+# Write an MSX design
+
+Read and follow the [design template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#design).

.github/plugin/msx/skills/msx-documentation-feature-addendum/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-feature-addendum
+description: Write an MSX feature addendum using the canonical documentation template.
+---
+
+# Write an MSX feature addendum
+
+Read and follow the [feature addendum template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#feature-addendum).

.github/plugin/msx/skills/msx-documentation-guide/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-guide
+description: Write an MSX task guide using the canonical documentation template.
+---
+
+# Write an MSX guide
+
+Read and follow the [guide template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#guide).

.github/plugin/msx/skills/msx-documentation-implementation/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-implementation
+description: Write an MSX implementation document using the canonical documentation template.
+---
+
+# Write an MSX implementation document
+
+Read and follow the [implementation document template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#implementation-doc).

.github/plugin/msx/skills/msx-documentation-orchestration-playbook/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-orchestration-playbook
+description: Write an MSX orchestration playbook using the canonical documentation template.
+---
+
+# Write an MSX orchestration playbook
+
+Read and follow the [orchestration playbook template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#orchestration-playbook).

.github/plugin/msx/skills/msx-documentation-reference/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-reference
+description: Write an MSX reference document using the canonical documentation template.
+---
+
+# Write an MSX reference
+
+Read and follow the [reference template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#reference).

.github/plugin/msx/skills/msx-documentation-research/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-research
+description: Write MSX research findings using the canonical documentation template.
+---
+
+# Write MSX research
+
+Read and follow the [research template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#research).

.github/plugin/msx/skills/msx-documentation-specification/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-specification
+description: Write an MSX capability specification using the canonical documentation template.
+---
+
+# Write an MSX specification
+
+Read and follow the [specification template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#specification).

.github/plugin/msx/skills/msx-documentation-standard/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-documentation-standard
+description: Write an MSX standard using the canonical documentation template.
+---
+
+# Write an MSX standard
+
+Read and follow the [standard template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#standard).

.github/plugin/msx/skills/msx-ways-of-working-agentic-development/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-agentic-development
+description: Apply the MSX agentic development way of working.
+---
+
+# Follow MSX agentic development
+
+Read and follow [MSX Agentic Development](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Agentic-Development.md).

.github/plugin/msx/skills/msx-ways-of-working-automation-labels/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-automation-labels
+description: Apply MSX ownership and namespacing rules for automation labels.
+---
+
+# Follow MSX automation label rules
+
+Read and follow [MSX Automation Labels](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Automation-Labels.md).

.github/plugin/msx/skills/msx-ways-of-working-branching-and-merging/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-branching-and-merging
+description: Create branches and integrate MSX changes through pull requests.
+---
+
+# Follow MSX branching and merging
+
+Read and follow [MSX Branching and Merging](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Branching-and-Merging.md).

.github/plugin/msx/skills/msx-ways-of-working-code-ownership/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-code-ownership
+description: Apply the MSX permission, ownership, and enforcement model.
+---
+
+# Follow MSX code ownership
+
+Read and follow [MSX Code Ownership](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Code-Ownership.md).

.github/plugin/msx/skills/msx-ways-of-working-commit-conventions/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-commit-conventions
+description: Write MSX commit messages using the canonical conventions.
+---
+
+# Follow MSX commit conventions
+
+Read and follow [MSX Commit Conventions](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Commit-Conventions.md).

.github/plugin/msx/skills/msx-ways-of-working-comparative-review-orchestration/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-comparative-review-orchestration
+description: Review an MSX target against reference sources using the comparative review playbook.
+---
+
+# Follow MSX comparative review orchestration
+
+Read and follow [MSX Comparative Review Orchestration](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Comparative-Review-Orchestration.md).

.github/plugin/msx/skills/msx-ways-of-working-continuous-delivery-and-release/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-continuous-delivery-and-release
+description: Distinguish MSX integration, delivery, deployment, and release practices.
+---
+
+# Follow MSX continuous delivery and release
+
+Read and follow [MSX Continuous Delivery and Release](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Continuous-Delivery-And-Release.md).

.github/plugin/msx/skills/msx-ways-of-working-continuous-practices/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-continuous-practices
+description: Apply the MSX Continuous X, Continuous AI, and DevOps Dojo practices.
+---
+
+# Follow MSX continuous practices
+
+Read and follow [MSX Continuous Practices](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Continuous-Practices.md).

.github/plugin/msx/skills/msx-ways-of-working-contribution-workflow/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-contribution-workflow
+description: Move an MSX change from branch to review-ready pull request.
+---
+
+# Follow the MSX contribution workflow
+
+Read and follow the [MSX Contribution Workflow](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Contribution-Workflow.md).

.github/plugin/msx/skills/msx-ways-of-working-definition-of-ready-and-done/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-definition-of-ready-and-done
+description: Apply the MSX readiness and completion gates.
+---
+
+# Follow the MSX Definition of Ready and Done
+
+Read and follow [MSX Definition of Ready and Done](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Definition-of-Ready-and-Done.md).

.github/plugin/msx/skills/msx-ways-of-working-devops-reference/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-devops-reference
+description: Consult the MSX DevOps and SRE reference for ways of working.
+---
+
+# Consult the MSX DevOps reference
+
+Read and follow [MSX DevOps Reference](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/DevOps-Reference.md).

.github/plugin/msx/skills/msx-ways-of-working-documentation-model/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-documentation-model
+description: Organize MSX documentation with the canonical documentation model.
+---
+
+# Follow the MSX documentation model
+
+Read and follow the [MSX Documentation Model](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Documentation-Model.md).

.github/plugin/msx/skills/msx-ways-of-working-engineering-taste/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-engineering-taste
+description: Apply MSX engineering judgment when standards do not settle a choice.
+---
+
+# Apply MSX engineering taste
+
+Read and follow [MSX Engineering Taste](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Engineering-Taste.md).

.github/plugin/msx/skills/msx-ways-of-working-evolutionary-development/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-evolutionary-development
+description: Grow MSX software through small bets, feedback, and selection.
+---
+
+# Follow MSX evolutionary development
+
+Read and follow [MSX Evolutionary Development](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Evolutionary-Development.md).

.github/plugin/msx/skills/msx-ways-of-working-fleet-orchestration/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-fleet-orchestration
+description: Roll one MSX change out across many repositories.
+---
+
+# Follow MSX fleet orchestration
+
+Read and follow [MSX Fleet Orchestration](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Fleet-Orchestration.md).

.github/plugin/msx/skills/msx-ways-of-working-git-worktrees/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-git-worktrees
+description: Create and use MSX Git worktrees for isolated changes.
+---
+
+# Follow MSX Git worktrees
+
+Read and follow [MSX Git Worktrees](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Git-Worktrees.md).

.github/plugin/msx/skills/msx-ways-of-working-goal-setting/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-goal-setting
+description: Set MSX missions, objectives, and initiatives above repository epics.
+---
+
+# Follow the MSX goal-setting framework
+
+Read and follow [MSX Goal-Setting Framework](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Goal-Setting.md).

.github/plugin/msx/skills/msx-ways-of-working-issues/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-issues
+description: Format and organize issues across the MSX ecosystem.
+---
+
+# Follow MSX issue practices
+
+Read and follow [MSX Issues](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Issues/index.md).

.github/plugin/msx/skills/msx-ways-of-working-observability/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-observability
+description: Apply MSX observability and failure registration practices.
+---
+
+# Follow MSX observability
+
+Read and follow [MSX Observability](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Observability.md).

.github/plugin/msx/skills/msx-ways-of-working-organization-standard/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: msx-ways-of-working-organization-standard
+description: Apply the MSX organization standard.
+---
+
+# Follow the MSX organization standard
+
+Read and follow [MSX Organization Standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Organization-Standard.md).