chore: publish from main

2026-08-07 01:28:46 +00:00 · 2026-08-06 12:30:14 +00:00
parent ca17038502
commit e321e4a9c7
775 changed files with 72454 additions and 1180 deletions
@@ -59,7 +59,7 @@ The following instructions are only to be applied when performing a code review.
 **Only apply to directories in the `plugins/` directory**
- [ ] The plugin directory contains a `.github/plugin/plugin.json` file.
+- [ ] The plugin directory contains a root `plugin.json` file.
 - [ ] The plugin directory contains a `README.md` file.
 - [ ] The plugin.json has a `name` field matching the directory name.
 - [ ] The plugin.json has a `description` field.
@@ -11,7 +11,7 @@
  "plugins": [
    {
      "name": "accessibility-kanban",
-      "source": "extensions/accessibility-kanban",
+      "source": "plugins/accessibility-kanban",
      "description": "Kanban board to manage accessibility issues, allow you to plan, track, and complete remediation work.",
      "version": "1.0.2"
    },
@@ -83,13 +83,13 @@
    },
    {
      "name": "apng-studio",
-      "source": "extensions/apng-studio",
+      "source": "plugins/apng-studio",
      "description": "Interactive GitHub Copilot app canvas extension for building Animated PNG (APNG) files from frames. Draw or upload frames, tune per-frame timing and compositing, preview live, send the result to your phone by QR, and export an animated .png.",
      "version": "1.0.2"
    },
    {
      "name": "arcade-canvas",
-      "source": "extensions/arcade-canvas",
+      "source": "plugins/arcade-canvas",
      "description": "Play five retro Phaser mini-games in a Copilot canvas while agents work.",
      "version": "1.0.2"
    },
@@ -156,13 +156,13 @@
    },
    {
      "name": "backlog-swipe-triage",
-      "source": "extensions/backlog-swipe-triage",
+      "source": "plugins/backlog-swipe-triage",
      "description": "Quickly swipe through backlog issues to triage decisions like assign, needs-info, defer, close, or ignore.",
      "version": "1.0.2"
    },
    {
      "name": "backrooms-canvas",
-      "source": "extensions/backrooms-canvas",
+      "source": "plugins/backrooms-canvas",
      "description": "Wander an endless first-person backrooms in a Copilot canvas while agents work; their status ghost-writes on the walls.",
      "version": "1.0.0"
    },
@@ -227,7 +227,7 @@
    },
    {
      "name": "chromium-control-canvas",
-      "source": "extensions/chromium-control-canvas",
+      "source": "plugins/chromium-control-canvas",
      "description": "Opens a real Chromium window you can navigate and interact with from a Copilot canvas control panel and agent actions.",
      "version": "1.0.2"
    },
@@ -271,7 +271,7 @@
    },
    {
      "name": "color-orb",
-      "source": "extensions/color-orb",
+      "source": "plugins/color-orb",
      "description": "A visual orb that users can ask the agent to recolor while showing a live activity log in the canvas.",
      "version": "1.0.2"
    },
@@ -426,7 +426,7 @@
    },
    {
      "name": "diagram-viewer",
-      "source": "extensions/diagram-viewer",
+      "source": "plugins/diagram-viewer",
      "description": "Render diagrams, click nodes to drill down, and view agent-generated explanations directly in the canvas.",
      "version": "1.0.2"
    },
@@ -573,7 +573,7 @@
    },
    {
      "name": "feedback-themes",
-      "source": "extensions/feedback-themes",
+      "source": "plugins/feedback-themes",
      "description": "Explore grouped customer feedback signals by impact and drill into a theme to guide product next steps.",
      "version": "1.0.2"
    },
@@ -601,7 +601,7 @@
    },
    {
      "name": "flight-map-canvas",
-      "source": "extensions/flight-map-canvas",
+      "source": "plugins/flight-map-canvas",
      "description": "A GitHub Copilot canvas that generates a view where Google Maps can be explored using 3D controls, as if a flight simulator. Agents can send the flight anywhere and report what they are working on.",
      "version": "1.0.0"
    },
@@ -625,7 +625,7 @@
    },
    {
      "name": "gesture-review",
-      "source": "extensions/gesture-review",
+      "source": "plugins/gesture-review",
      "description": "Review pull requests with a live camera feed and approve or reject using thumbs-up/thumbs-down gestures.",
      "version": "1.0.2"
    },
@@ -733,7 +733,7 @@
    },
    {
      "name": "java-modernization-studio",
-      "source": "extensions/java-modernization-studio",
+      "source": "plugins/java-modernization-studio",
      "description": "Drive the GitHub Copilot App Modernization for Java workflow from an interactive canvas: environment readiness, repo assessment, prioritized plan and progress, validation gates, and one-click predefined-task runs grounded in the repo's real artifacts.",
      "version": "1.0.2"
    },
@@ -1061,7 +1061,7 @@
    },
    {
      "name": "pr-artifact-explorer",
-      "source": "extensions/pr-artifact-explorer",
+      "source": "plugins/pr-artifact-explorer",
      "description": "Navigate pull requests and securely explore GitHub Actions artifacts, including test results, static sites, terminal recordings, and source files.",
      "version": "1.0.0"
    },
@@ -1097,13 +1097,13 @@
    },
    {
      "name": "release-notes-showcase",
-      "source": "extensions/release-notes-showcase",
+      "source": "plugins/release-notes-showcase",
      "description": "Compose and refine launch-ready release notes with contributor callouts and export-friendly output.",
      "version": "1.0.2"
    },
    {
      "name": "repo-actions-hub",
-      "source": "extensions/repo-actions-hub",
+      "source": "plugins/repo-actions-hub",
      "description": "Browse repository GitHub Actions workflows, inspect recent runs, and trigger manual workflow_dispatch runs from a Copilot canvas.",
      "version": "1.0.2"
    },
@@ -1145,13 +1145,13 @@
    },
    {
      "name": "signals-dashboard",
-      "source": "extensions/signals-dashboard",
+      "source": "plugins/signals-dashboard",
      "description": "Real-time Workshop dashboard with agent signals, honesty calibration, and cost-aware repo or connected desk launch profiles.",
      "version": "0.2.0"
    },
    {
      "name": "site-studio",
-      "source": "extensions/site-studio",
+      "source": "plugins/site-studio",
      "description": "Plan, draft, and track a personal website section by section — a shared canvas where you and your agent author content, watch progress, and review every change.",
      "version": "1.0.2"
    },
@@ -1271,13 +1271,13 @@
    },
    {
      "name": "tiny-tool-town-submitter",
-      "source": "extensions/tiny-tool-town-submitter",
+      "source": "plugins/tiny-tool-town-submitter",
      "description": "Inspect a repository, improve Tiny Tool Town readiness, submit its listing issue, and launch remediation work.",
      "version": "1.0.2"
    },
    {
      "name": "token-pacman",
-      "source": "extensions/token-pacman",
+      "source": "plugins/token-pacman",
      "description": "Visualizes live session AI-credit usage as a Pac-Man board with pellets, ghosts, fruit milestones, and game-over limits.",
      "version": "1.0.2"
    },
@@ -1495,7 +1495,7 @@
    },
    {
      "name": "where-was-i",
-      "source": "extensions/where-was-i",
+      "source": "plugins/where-was-i",
      "description": "Reconstruct your dev context (branch, commits, uncommitted work, PR clues) and trigger a resume prompt to continue quickly.",
      "version": "1.0.2"
    },
@@ -1559,7 +1559,7 @@
    },
    {
      "name": "work-hub",
-      "source": "extensions/work-hub",
+      "source": "plugins/work-hub",
      "description": "Generic cross-repo command center canvas for GitHub Copilot with onboarding, focus planning, repo health, work signals, and session cleanup.",
      "version": "1.0.2"
    }
@@ -0,0 +1,124 @@
 ---
 name: create-canvas-extension
 description: 'Create or register a canvas extension in the awesome-copilot repository. Use when asked to scaffold a new canvas extension, create its plugin.json, add a reusable extension to one or more plugins, or migrate extension metadata. Extensions are reusable source under extensions/; shippable plugin manifests belong under plugins/.'
 argument-hint: '[optional extension name or description]'
 ---
 # Create a canvas extension
 Use this skill only for the `github/awesome-copilot` repository. Canvas extensions are reusable source components. They do not have a `plugin.json` under `extensions/`.
 ## Required decisions
 Before creating files, ask for each missing value:
 1. **Extension ID**: lowercase kebab-case, matching the source folder and plugin name.
 2. **Display metadata**:
   - description
   - version (default `1.0.0`)
   - author name and optional URL
   - keywords (lowercase, hyphenated, maximum 10)
   - repository and license (default to the repository URL and `MIT` when appropriate)
 3. **Canvas entrypoint**: confirm whether the extension already has `extension.mjs`. If not, create a minimal entrypoint only when the user provides enough implementation details; otherwise create the directory and leave an explicit TODO.
 4. **Preview image**: obtain an existing `assets/preview.png` path or ask the user to add it. Do not invent a binary image or silently use a misleading placeholder.
 5. **Plugin registration**:
   - For a standalone installable canvas plugin, create `plugins/<extension-id>`.
   - For an extension that belongs to an existing plugin, ask for the parent plugin ID and add `./extensions/<extension-id>` to that plugin's `extensions.com.github.awesome-copilot.extensions`.
   - If the extension should be shipped by multiple plugins, collect all plugin IDs and add the same extension ID to each mapping file.
 ## Files to create
 For a new extension plugin, create this structure:
 ```text
 extensions/<extension-id>/
 ├── extension.mjs
 └── assets/
    └── preview.png
 plugins/<extension-id>/
 ├── plugin.json
 └── README.md
 ```
 The extension source may contain additional files such as `package.json`, canvas assets, or supporting modules. Keep all reusable implementation files under `extensions/<extension-id>/`.
 Create `plugins/<extension-id>/plugin.json` with this shape:
 ```json
 {
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "<extension-id>",
  "description": "<description>",
  "version": "1.0.0",
  "author": {
    "name": "<author>"
  },
  "repository": "https://github.com/github/awesome-copilot",
  "license": "MIT",
  "keywords": [
    "<keyword>"
  ],
  "extensions": {
    "com.github.copilot": {
      "logo": "assets/preview.png"
    },
    "com.github.awesome-copilot": {
      "extensions": [
        "./extensions/<extension-id>"
      ]
    }
  }
 }
 ```
 Keep Agent Plugins fields at the manifest top level. Repository composition belongs only under `extensions.com.github.awesome-copilot`; do not put `agents`, `commands`, `hooks`, `mcpServers`, or `skills` at the top level or directly under `extensions`. Do not add `x-awesome-copilot`, `standalone`, or other repository-specific top-level fields.
 For an existing parent plugin, create or update:
 ```text
 plugins/<parent-plugin>/plugin.json (`extensions.com.github.awesome-copilot.extensions`)
 ```
 Its `extensions` property must contain sorted repository-relative paths:
 ```json
 {
  "extensions": [
    "./extensions/<extension-id>"
  ]
 }
 ```
 Do not copy the extension source into the parent plugin. Materialization resolves the IDs from the root `extensions/` directory, so the same source can be bundled by multiple plugins.
 ## Workflow
 1. Inspect the repository before editing:
   - confirm `extensions/<extension-id>` and `plugins/<extension-id>` do not already conflict
   - inspect the target parent plugin, if any
   - check whether a preview image and entrypoint already exist
 2. Ask only the missing required questions from the decisions above.
 3. Create the source and plugin directories with the required files.
 4. If creating a new entrypoint, keep it minimal and clearly mark implementation TODOs rather than fabricating behavior.
 5. Add or update `extensions.com.github.awesome-copilot.extensions` for every parent plugin that should ship the extension. Keep paths alphabetically sorted and unique.
 6. Ensure there is no `extensions/<extension-id>/.github/plugin/plugin.json`.
 7. Run:
   ```bash
   npm run plugin:validate
   npm run build
   npm run website:data
   ```
 8. Report the created paths, the plugins that ship the extension, and any missing user-provided assets or TODOs.
 ## Existing extension migration
 When migrating an existing extension:
 1. Move its existing manifest to `plugins/<extension-id>/plugin.json`.
 2. Update the manifest to the namespace-based `extensions.com.github.copilot.logo` shape.
 3. Remove the old manifest from `extensions/<extension-id>`.
 4. Register the extension in any parent plugin's `extensions.com.github.awesome-copilot.extensions`.
 5. Run the validation and build commands above.
@@ -93,7 +93,7 @@ jobs:
                  if (files.length > 0) {
                    errors.push(
                      `${pluginPath}/${subdir}/ contains ${files.length} file(s): ${files.join(', ')}. ` +
-                      `Plugin directories on main should only contain .github/plugin/plugin.json and README.md. ` +
+                      `Plugin directories on main should only contain plugin.json and README.md. ` +
                      `Agent, command, and skill files are materialized automatically during publish to marketplace.`
                    );
                  }
@@ -121,7 +121,7 @@ jobs:
                '⚠️ **Materialized files or symlinks detected in plugin directories**',
                '',
                'Plugin directories on the `main` branch should only contain:',
-                '- `.github/plugin/plugin.json` (metadata)',
+                '- `plugin.json` (metadata)',
                '- `README.md`',
                '',
                'Agent, command, and skill files are copied in automatically when publishing to `marketplace`.',
@@ -750,6 +750,7 @@ jobs:
              if (process.env.QUALITY_JOB_RESULT === 'failure' || process.env.QUALITY_JOB_RESULT === 'cancelled') {
                qualityResult = {
                  overall_status: 'infra_error',
                  spec_compliance_status: 'warning',
                  vally_lint_status: 'infra_error',
                  smoke_status: 'infra_error',
                  version_match_status: 'infra_error',
@@ -762,6 +763,7 @@ jobs:
              } else {
                qualityResult = {
                  overall_status: 'infra_error',
                  spec_compliance_status: 'warning',
                  vally_lint_status: 'infra_error',
                  smoke_status: 'infra_error',
                  version_match_status: 'infra_error',
@@ -113,6 +113,7 @@ jobs:
              if (process.env.QUALITY_JOB_RESULT === 'failure' || process.env.QUALITY_JOB_RESULT === 'cancelled') {
                qualityResult = {
                  overall_status: 'infra_error',
                  spec_compliance_status: 'warning',
                  vally_lint_status: 'infra_error',
                  smoke_status: 'infra_error',
                  version_match_status: 'infra_error',
@@ -125,6 +126,7 @@ jobs:
              } else {
                qualityResult = {
                  overall_status: 'infra_error',
                  spec_compliance_status: 'warning',
                  vally_lint_status: 'infra_error',
                  smoke_status: 'infra_error',
                  version_match_status: 'infra_error',
@@ -147,6 +147,7 @@ jobs:
            let qualityResult = {
              overall_status: 'not_run',
              spec_compliance_status: 'not_run',
              failure_class: 'none',
              checked_plugins: [],
              summary: 'No changed external plugin entries were detected in this PR.',
@@ -155,6 +156,7 @@ jobs:
            if (detectJobResult === 'failure' || detectJobResult === 'cancelled') {
              qualityResult = {
                overall_status: 'infra_error',
                spec_compliance_status: 'not_run',
                failure_class: 'infra',
                checked_plugins: [],
                version_match_status: 'infra_error',
@@ -165,6 +167,7 @@ jobs:
              if (qualityJobResult === 'failure' || qualityJobResult === 'cancelled') {
                qualityResult = {
                  overall_status: 'infra_error',
                  spec_compliance_status: 'not_run',
                  failure_class: 'infra',
                  checked_plugins: [],
                  version_match_status: 'infra_error',
@@ -176,6 +179,7 @@ jobs:
              } else {
                qualityResult = {
                  overall_status: 'infra_error',
                  spec_compliance_status: 'not_run',
                  failure_class: 'infra',
                  checked_plugins: [],
                  version_match_status: 'infra_error',
@@ -201,11 +205,29 @@ jobs:
            });
            const checkedPlugins = Array.isArray(qualityResult.checked_plugins) ? qualityResult.checked_plugins : [];
            const hasSpecWarnings = checkedPlugins.some((entry) => String(entry?.quality?.spec_compliance_status || '') === 'warning');
            const header = qualityResult.failure_class === 'submitter_fixes'
-              ? '## ⚠️ External plugin PR checks require submitter fixes'
+              ? '## 🛑 External plugin PR checks failed (submitter fixes required)'
-              : qualityResult.overall_status === 'pass' || !shouldRun
+              : qualityResult.overall_status === 'infra_error'
-                ? '## ✅ External plugin PR checks passed'
+                ? '## 🛑 External plugin PR checks failed (maintainer follow-up)'
-                : '## ⚠️ External plugin PR checks need maintainer follow-up';
+                : hasSpecWarnings
                  ? '## ⚠️ External plugin PR checks passed with spec warnings'
                  : qualityResult.overall_status === 'pass' || !shouldRun
                    ? '## ✅ External plugin PR checks passed'
                    : '## ⚠️ External plugin PR checks need maintainer follow-up';
            const formatStatus = (rawStatus, gateName) => {
              const status = String(rawStatus || 'not_run');
              if (status === 'pass') {
                return '✅ pass';
              }
              if (status === 'warning' || (gateName === 'spec compliance' && status === 'fail')) {
                return '⚠️ warning';
              }
              if (status === 'fail' || status === 'infra_error') {
                return '🛑 fail';
              }
              return '⚪ not_run';
            };
            const MAX_GATE_OUTPUT_CHARS = 2000;
            const escapeHtml = (value) =>
              String(value || '')
@@ -273,21 +295,16 @@ jobs:
              ? checkedPlugins.map((entry) => {
                  const name = escapeMarkdownTableCell(entry?.name || 'unknown');
                  const quality = entry?.quality || {};
-                  const sourceUrl = normalizeGitHubUrl(entry?.source_tree_url || '');
+                  const sourceUrl = normalizeGitHubUrl(entry?.source_tree_url);
                  const locator = escapeMarkdownTableCell(entry?.source?.sha || entry?.source?.ref || 'repository');
-                  const sourceCell = sourceUrl ? `[${locator}](<${sourceUrl}>)` : locator;
+                  const sourceCell = sourceUrl ? `[${locator}](${sourceUrl})` : locator;
-                  const vallyLintStatus = escapeMarkdownTableCell(quality.vally_lint_status || 'not_run');
+                  return `| ${name} | ${formatStatus(quality.spec_compliance_status, 'spec compliance')} | ${formatStatus(quality.vally_lint_status, 'vally lint')} | ${formatStatus(quality.smoke_status, 'install smoke test')} | ${formatStatus(quality.version_match_status, 'version match')} | ${formatStatus(quality.ref_sha_consistency_status, 'ref/sha consistency')} | ${formatStatus(quality.canvas_structure_status, 'canvas structure')} | ${formatStatus(quality.overall_status, 'overall')} | ${sourceCell} |`;
                  const smokeStatus = escapeMarkdownTableCell(quality.smoke_status || 'not_run');
                  const versionMatchStatus = escapeMarkdownTableCell(quality.version_match_status || 'not_run');
                  const refShaConsistencyStatus = escapeMarkdownTableCell(quality.ref_sha_consistency_status || 'not_run');
                  const canvasStructureStatus = escapeMarkdownTableCell(quality.canvas_structure_status || 'not_run');
                  const overallStatus = escapeMarkdownTableCell(quality.overall_status || 'not_run');
                  return `| ${name} | ${vallyLintStatus} | ${smokeStatus} | ${versionMatchStatus} | ${refShaConsistencyStatus} | ${canvasStructureStatus} | ${overallStatus} | ${sourceCell} |`;
                })
-              : ['| _none_ | not_run | not_run | not_run | not_run | not_run | not_run | _n/a_ |'];
+              : ['| _none_ | ⚪ not_run | ⚪ not_run | ⚪ not_run | ⚪ not_run | ⚪ not_run | ⚪ not_run | ⚪ not_run | _n/a_ |'];
            const failureDetails = checkedPlugins.flatMap((entry) => {
              const name = String(entry?.name || 'unknown');
              const quality = entry?.quality || {};
              const shouldShowSpec = quality.spec_compliance_status === 'warning' || String(quality.spec_compliance_output || '').trim().length > 0;
              const shouldShowVally = quality.vally_lint_status === 'fail' || quality.vally_lint_status === 'infra_error' || String(quality.vally_lint_output || '').trim().length > 0;
              const shouldShowSmoke = quality.smoke_status === 'fail' || quality.smoke_status === 'infra_error' || String(quality.smoke_output || '').trim().length > 0;
              const shouldShowVersionMatch = quality.version_match_status === 'fail' || quality.version_match_status === 'infra_error' || String(quality.version_match_output || '').trim().length > 0;
@@ -295,11 +312,14 @@ jobs:
              const shouldShowCanvasStructure = quality.canvas_structure_status === 'fail' || quality.canvas_structure_status === 'infra_error' || String(quality.canvas_structure_output || '').trim().length > 0;
              const details = [];
              if (shouldShowSpec) {
                details.push(formatGateOutput(name, 'spec compliance', formatStatus(quality.spec_compliance_status, 'spec compliance'), quality.spec_compliance_output));
              }
              if (shouldShowVally) {
-                details.push(formatGateOutput(name, 'vally lint', quality.vally_lint_status, quality.vally_lint_output));
+                details.push(formatGateOutput(name, 'vally lint', formatStatus(quality.vally_lint_status, 'vally lint'), quality.vally_lint_output));
              }
              if (shouldShowSmoke) {
-                details.push(formatGateOutput(name, 'install smoke test', quality.smoke_status, quality.smoke_output));
+                details.push(formatGateOutput(name, 'install smoke test', formatStatus(quality.smoke_status, 'install smoke test'), quality.smoke_output));
              }
              if (shouldShowVersionMatch) {
                details.push(formatGateOutput(name, 'version match', quality.version_match_status, quality.version_match_output));
@@ -319,11 +339,12 @@ jobs:
              '',
              `- **Changed entries detected:** ${changedCount}`,
              `- **Workflow state label:** \`${stateLabel}\``,
              '- **Status legend:** ✅ pass · ⚠️ warning · 🛑 fail',
              '',
              '### Per-plugin quality summary',
              '',
-              '| Plugin | vally lint | install smoke test | version match | ref/sha consistency | canvas structure | overall | source tree |',
+              '| Plugin | spec compliance (non-blocking) | vally lint | install smoke test | version match | ref/sha consistency | canvas structure | overall | source tree |',
-              '|---|---|---|---|---|---|---|---|',
+              '|---|---|---|---|---|---|---|---|---|',
              ...rows,
              '',
              ...(failureDetails.length > 0
@@ -0,0 +1,95 @@
 name: Validate Plugins and Extensions
 on:
  pull_request:
    branches: [main]
    paths:
      - "plugins/**"
      - "extensions/**"
      - "eng/validate-plugins.mjs"
      - ".github/workflows/validate-plugins.yml"
 permissions:
  contents: read
  pull-requests: write
 jobs:
  validate:
    name: Plugin & extension spec validation
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
      - name: Setup Node.js
        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
        with:
          node-version: "22"
          cache: "npm"
      - name: Install dependencies
        run: npm ci
      - name: Validate plugins and extensions
        id: validate
        run: npm run plugin:validate
      - name: Manage validation summary on PR
        if: always()
        uses: actions/github-script@f28e40c7f34bde8b3046d885e986cb6290c5673b # v7.1.0
        with:
          script: |
            const marker = '<!-- plugin-extension-validation -->';
            const validationOutcome = '${{ steps.validate.outcome }}';
            const validationFailed = validationOutcome === 'failure';
            const validationPassed = validationOutcome === 'success';
            const body = [
              marker,
              '🛑 **Plugin/extension validation failed**',
              '',
              'One or more plugins or extensions in this PR do not pass spec validation.',
              '',
              'All internal plugins and extensions must include:',
              '- `"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json"` in `plugin.json`',
              '- A valid `name`, `description`, and `version`',
              '- Repository composition (`agents`, `commands`, `hooks`, `mcpServers`, `skills`, and reusable `extensions`) under `extensions.com.github.awesome-copilot`',
              '- For **extensions**: `extensions.com.github.copilot.logo` must be set to `"assets/preview.png"`',
              '',
              'Do not put repository composition fields at the manifest top level or directly under `extensions`; they must be nested under `extensions.com.github.awesome-copilot`.',
              '',
              'Run `npm run plugin:validate` locally to see the full list of errors. See `.github/skills/create-canvas-extension/SKILL.md` and `CONTRIBUTING.md` for examples.',
            ].join('\n');
            const { data: comments } = await github.rest.issues.listComments({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              per_page: 100,
            });
            const existing = comments.find((comment) => comment.body.includes(marker));
            if (validationFailed && existing) {
              await github.rest.issues.updateComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                comment_id: existing.id,
                body,
              });
              console.log(`Updated existing validation comment ${existing.id}`);
            } else if (validationFailed) {
              await github.rest.issues.createComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                issue_number: context.issue.number,
                body,
              });
              console.log('Created validation comment');
            } else if (validationPassed && existing) {
              await github.rest.issues.deleteComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                comment_id: existing.id,
              });
              console.log(`Deleted stale validation comment ${existing.id}`);
            }
@@ -21,7 +21,7 @@ The Awesome GitHub Copilot repository is a community-driven collection of custom
 ├── hooks/            # Automated workflow hooks (folders with README.md + hooks.json)
 ├── workflows/        # Agentic Workflows (.md files for GitHub Actions automation)
 ├── plugins/          # Installable plugin packages (folders with plugin.json)
-├── extensions/       # Canvas extensions (each with extension.mjs and plugin metadata)
+├── extensions/       # Reusable canvas extension sources (extension.mjs and assets)
 ├── docs/             # Documentation for different resource types
 ├── eng/              # Build and automation scripts
 └── scripts/          # Utility scripts
@@ -85,15 +85,11 @@ All agent files (`*.agent.md`) and instruction files (`*.instructions.md`) must
 #### Canvas Extensions (extensions/\*)
 - Each extension folder must include `extension.mjs`
- Extension metadata must live at `.github/plugin/plugin.json`
+- Extensions are reusable source components, not standalone plugins
- Extension `plugin.json` **must** follow the convention:
+- A shippable extension plugin is registered by a matching `plugins/<extension-id>/plugin.json`
-  - `name`, `description`, `version` are required
+- A plugin can bundle additional reusable extensions by listing `./extensions/<name>` paths in `extensions.com.github.awesome-copilot.extensions`
  - `logo` **must** be exactly `"assets/preview.png"` (enforced convention)
  - `extensions` **must** be exactly `"."` in source manifests (materialization rewrites this to `"extensions"` for distribution output)
  - Optional: `author`, `keywords` fields
  - **Must not** include `x-awesome-copilot` field (use convention-based `assets/preview.png` only)
 - Each extension must have `assets/preview.png` as the primary visual asset
- Do not add `canvas.json`; website metadata is sourced from `.github/plugin/plugin.json`
+- Extension metadata is sourced from the matching plugin manifest in `plugins/`
 #### Hook Folders (hooks/\*/README.md)
@@ -119,11 +115,12 @@ All agent files (`*.agent.md`) and instruction files (`*.instructions.md`) must
 #### Plugin Folders (plugins/\*)
- Each plugin is a folder containing a `.github/plugin/plugin.json` file with metadata
+- Each plugin is a folder containing a root `plugin.json` file with metadata
 - plugin.json **must** have `"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json"` (Agent Plugins v1.0.0)
 - plugin.json must have `name` field (matching the folder name)
 - plugin.json must have `description` field (describing the plugin's purpose)
 - plugin.json must have `version` field (semantic version, e.g., "1.0.0")
- Plugin content is defined declaratively in plugin.json using Claude Code spec fields (`agents`, `commands`, `skills`). Source files live in top-level directories and are materialized into plugins by CI.
+- Plugin content is defined declaratively in plugin.json under `extensions.com.github.awesome-copilot` using source-only composition fields (`agents`, `commands`, `hooks`, `skills`, and `extensions`). Source files live in top-level directories and are materialized into plugins by CI. This namespace is stripped from the served manifest — conventional directory discovery handles the materialized content in spec mode.
 - The `marketplace.json` file is automatically generated from all plugins during build
 - Plugins are discoverable and installable via GitHub Copilot CLI
@@ -168,7 +165,7 @@ When adding a new agent, instruction, skill, hook, workflow, or plugin:
 **For Plugins:**
 1. Run `npm run plugin:create -- --name <plugin-name>` to scaffold a new plugin
-2. Define agents, commands, and skills in `plugin.json` using Claude Code spec fields
+2. Define agents, commands, hooks, skills, and reusable extensions under `extensions.com.github.awesome-copilot` in `plugin.json`
 3. Edit the generated `plugin.json` with your metadata
 4. Run `npm run plugin:validate` to validate the plugin structure
 5. Run `npm run build` to update README.md and marketplace.json
@@ -177,11 +174,26 @@ When adding a new agent, instruction, skill, hook, workflow, or plugin:
 **For Canvas Extensions:**
 1. Create/update the extension in `extensions/<extension-id>/` with `extension.mjs`
-2. Add `.github/plugin/plugin.json` metadata (required: `name`, `description`, `version`, `logo: "assets/preview.png"`, `extensions: "."`; optional: `author`, `keywords`)
+2. Add the matching plugin manifest under `plugins/<extension-id>/plugin.json`:
   ```json
   {
     "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
     "name": "<extension-id>",
     "description": "...",
     "version": "1.0.0",
     "extensions": {
       "com.github.copilot": {
         "logo": "assets/preview.png"
       }
     }
   }
   ```
 3. Ensure `assets/preview.png` exists as the primary visual asset
 4. Run `npm run plugin:validate` to validate plugin and extension metadata
 5. Run `npm run build` to regenerate website data and marketplace output
 To bundle an extension into another plugin without making a second source copy, add sorted `./extensions/<name>` paths to `plugins/<plugin-id>/plugin.json` under `extensions.com.github.awesome-copilot.extensions`.
 **For External Plugins:**
 1. Do not open a direct PR that edits `plugins/external.json` for a public third-party plugin submission
@@ -310,16 +322,17 @@ For workflow files (workflows/\*.md):
 For plugins (plugins/\*/):
- [ ] Directory contains a `.github/plugin/plugin.json` file
+- [ ] Directory contains a root `plugin.json` file
 - [ ] Directory contains a `README.md` file
 - [ ] `plugin.json` has `"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json"`
 - [ ] `plugin.json` has `name` field matching the directory name (lowercase with hyphens)
 - [ ] `plugin.json` has non-empty `description` field
 - [ ] `plugin.json` has `version` field (semantic version, e.g., "1.0.0")
 - [ ] Directory name is lower case with hyphens
 - [ ] If `keywords` is present, it is an array of lowercase hyphenated strings
- [ ] If `agents`, `commands`, or `skills` arrays are present, each entry is a valid relative path
+- [ ] If composition arrays are present under `extensions.com.github.awesome-copilot`, each entry is a valid relative path
 - [ ] The plugin does not reference non-existent files
- [ ] Run `npm run build` to verify marketplace.json is updated correctly
+- [ ] Run `npm run plugin:validate` and `npm run build` to verify the plugin passes all checks
 ## Contributing
@@ -140,17 +140,15 @@ Skills are self-contained folders in the `skills/` directory that include a `SKI
 ### Adding Canvas Extensions
-Canvas extensions live in `extensions/<extension-id>/` and are installable through plugin metadata.
+Canvas extensions live in `extensions/<extension-id>/` as reusable source components. They are shipped only through plugin manifests in `plugins/`.
-1. **Create/update extension metadata**: Add `.github/plugin/plugin.json` in the extension folder
+1. **Create/update the extension source**: Add or update `extensions/<extension-id>/extension.mjs`
-2. **Use convention-based metadata**: Follow the extension plugin.json structure:
+2. **Register the extension plugin**: Add `plugins/<extension-id>/plugin.json`:
   - Required: `name` (matching folder name), `description`, `version`
   - Optional: `author`, `keywords`
-   - `logo` **must** be exactly `"assets/preview.png"` (enforced convention)
+   - `extensions.com.github.copilot.logo` **must** be exactly `"assets/preview.png"`
   - `extensions` **must** be exactly `"."` (per [copilot-agent-runtime#9929](https://github.com/github/copilot-agent-runtime/pull/9929))
   - **Never** include `x-awesome-copilot` field (use convention-based assets only)
 3. **Screenshot requirements**: Create `assets/preview.png` as your primary visual
-4. **Do not add `canvas.json`**: Extension website metadata is now sourced from `.github/plugin/plugin.json`
+4. **Do not add `canvas.json`**: Extension website metadata is sourced from the matching plugin manifest
 5. **Validate before submitting**: Run `npm run plugin:validate` to check compliance with conventions
 ### Adding Plugins
@@ -159,7 +157,7 @@ Plugins group related agents, commands, and skills around specific themes or wor
 1. **Create your plugin**: Run `npm run plugin:create` to scaffold a new plugin
 2. **Follow the naming convention**: Use descriptive, lowercase folder names with hyphens (e.g., `python-web-development`)
-3. **Define your content**: List agents, commands, and skills in `plugin.json` using the Claude Code spec fields
+3. **Define your content**: List agents, commands, hooks, skills, and reusable extensions under `extensions.com.github.awesome-copilot` in `plugin.json`
 4. **Test your plugin**: Run `npm run plugin:validate` to verify your plugin structure
 #### Creating a plugin
@@ -172,16 +170,17 @@ npm run plugin:create -- --name my-plugin-id
 ```
 plugins/my-plugin-id/
-├── .github/plugin/plugin.json  # Plugin metadata (Claude Code spec format)
+├── plugin.json                # Plugin metadata
 └── README.md                   # Plugin documentation
 ```
-> **Note:** Plugin content is defined declaratively in plugin.json using Claude Code spec fields (`agents`, `commands`, `skills`). Source files live in top-level directories and are materialized into plugins by CI.
+> **Note:** Plugin content is defined declaratively in plugin.json under `extensions.com.github.awesome-copilot`. Source files live in top-level directories and are materialized into plugins by CI. This repository namespace is removed from the served manifest.
 #### plugin.json example
 ```json
 {
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "my-plugin-id",
  "description": "Plugin description",
  "version": "1.0.0",
@@ -189,17 +188,21 @@ plugins/my-plugin-id/
  "author": { "name": "Awesome Copilot Community" },
  "repository": "https://github.com/github/awesome-copilot",
  "license": "MIT",
-  "agents": ["./agents/my-agent.md"],
+  "extensions": {
-  "commands": ["./commands/my-command.md"],
+    "com.github.awesome-copilot": {
-  "skills": ["./skills/my-skill/"]
+      "agents": ["./agents/my-agent.md"],
      "commands": ["./commands/my-command.md"],
      "skills": ["./skills/my-skill/"]
    }
  }
 }
 ```
 #### Plugin Guidelines
- **Declarative content**: Plugin content is specified via `agents`, `commands`, and `skills` arrays in plugin.json — source files live in top-level directories and are materialized into plugins by CI
+- **Declarative content**: Plugin content is specified under `extensions.com.github.awesome-copilot` — source files live in top-level directories and are materialized into plugins by CI
 - **Valid references**: All paths referenced in plugin.json must point to existing source files in the repository
- **Optional extension links**: Curated plugins can reference extensions using `x-awesome-copilot.extensions` with paths like `./extensions/<extension-id>`
+- **Reusable extensions**: Curated plugins can bundle extensions by adding `./extensions/<name>` paths under `extensions.com.github.awesome-copilot.extensions`; the same extension can be listed by multiple plugins
 - **Instructions excluded**: Instructions are standalone resources and are not part of plugins
 - **Clear purpose**: The plugin should solve a specific problem or workflow
 - **Validate before submitting**: Run `npm run plugin:validate` to ensure your plugin is valid
@@ -27,74 +27,95 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t
 | Name | Description | Items | Tags |
 | ---- | ----------- | ----- | ---- |
-| [acreadiness-cockpit](../plugins/acreadiness-cockpit/README.md) | Drive Microsoft AgentRC from Copilot chat: assess AI readiness, generate Copilot instructions (flat or nested with applyTo globs for monorepos), and manage policies. Produces a self-contained static HTML dashboard at reports/index.html. | 4 items | agentrc, ai-readiness, copilot-instructions, readiness-report, monorepo, policy, dashboard |
+| [accessibility-kanban](../plugins/accessibility-kanban/README.md) | Kanban board to manage accessibility issues, allow you to plan, track, and complete remediation work. | 1 items | accessibility, github-issues, issue-triage, kanban-board, planning-workflow, status-tracking |
-| [ai-team-orchestration](../plugins/ai-team-orchestration/README.md) | Run a lightweight, role-separated AI development team with flexible tools, developer-selected models, proportionate planning, and optional QA. | 2 items | ai-team, multi-agent, sprint-planning, brainstorm, project-management, orchestration, developer-workflow |
+| [acreadiness-cockpit](../plugins/acreadiness-cockpit/README.md) | Drive Microsoft AgentRC from Copilot chat: assess AI readiness, generate Copilot instructions (flat or nested with applyTo globs for monorepos), and manage policies. Produces a self-contained static HTML dashboard at reports/index.html. | 0 items | agentrc, ai-readiness, copilot-instructions, readiness-report, monorepo, policy, dashboard |
-| [arch](../plugins/arch/README.md) | Architecture and modernization toolkit: produce a cited architecture document for a locally-cloned repo, and generate a phased modernization plan that auto-runs Documentation mode when needed. | 1 items | architecture, modernization, documentation, migration, onboarding |
+| [ai-team-orchestration](../plugins/ai-team-orchestration/README.md) | Run a lightweight, role-separated AI development team with flexible tools, developer-selected models, proportionate planning, and optional QA. | 0 items | ai-team, multi-agent, sprint-planning, brainstorm, project-management, orchestration, developer-workflow |
-| [arize-ax](../plugins/arize-ax/README.md) | Arize AX platform skills for LLM observability, evaluation, and optimization. Includes trace export, instrumentation, datasets, experiments, evaluators, AI provider integrations, annotations, prompt optimization, and deep linking to the Arize UI. | 9 items | arize, llm, observability, tracing, evaluation, instrumentation, datasets, experiments, prompt-optimization |
+| [apng-studio](../plugins/apng-studio/README.md) | Interactive GitHub Copilot app canvas extension for building Animated PNG (APNG) files from frames. Draw or upload frames, tune per-frame timing and compositing, preview live, send the result to your phone by QR, and export an animated .png. | 1 items | animated-png, apng, copilot-canvas, frame-animation, image-export, interactive-canvas |
-| [automate-this](../plugins/automate-this/README.md) | Record your screen doing a manual process, drop the video on your Desktop, and let Copilot CLI analyze it frame-by-frame to build working automation scripts. Supports narrated recordings with audio transcription. | 1 items | automation, screen-recording, workflow, video-analysis, process-automation, scripting, productivity, copilot-cli |
+| [arcade-canvas](../plugins/arcade-canvas/README.md) | Play five retro Phaser mini-games in a Copilot canvas while agents work. | 1 items | arcade-games, copilot-canvas, interactive-canvas, phaser, retro-games, session-breaks |
-| [awesome-copilot](../plugins/awesome-copilot/README.md) | Meta prompts that help you discover and generate curated GitHub Copilot agents, instructions, prompts, and skills. | 4 items | github-copilot, discovery, meta, prompt-engineering, agents |
+| [arch](../plugins/arch/README.md) | Architecture and modernization toolkit: produce a cited architecture document for a locally-cloned repo, and generate a phased modernization plan that auto-runs Documentation mode when needed. | 0 items | architecture, modernization, documentation, migration, onboarding |
-| [aws-cloud-development](../plugins/aws-cloud-development/README.md) | Comprehensive AWS cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 5 items | aws, cloud, infrastructure, cloudformation, terraform, serverless, architecture, devops, cdk |
+| [arize-ax](../plugins/arize-ax/README.md) | Arize AX platform skills for LLM observability, evaluation, and optimization. Includes trace export, instrumentation, datasets, experiments, evaluators, AI provider integrations, annotations, prompt optimization, and deep linking to the Arize UI. | 0 items | arize, llm, observability, tracing, evaluation, instrumentation, datasets, experiments, prompt-optimization |
-| [azure-cloud-development](../plugins/azure-cloud-development/README.md) | Comprehensive Azure cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 5 items | azure, cloud, infrastructure, bicep, terraform, serverless, architecture, devops |
+| [automate-this](../plugins/automate-this/README.md) | Record your screen doing a manual process, drop the video on your Desktop, and let Copilot CLI analyze it frame-by-frame to build working automation scripts. Supports narrated recordings with audio transcription. | 0 items | automation, screen-recording, workflow, video-analysis, process-automation, scripting, productivity, copilot-cli |
-| [cast-imaging](../plugins/cast-imaging/README.md) | A comprehensive collection of specialized agents for software analysis, impact assessment, structural quality advisories, and architectural review using CAST Imaging. | 1 items | cast-imaging, software-analysis, architecture, quality, impact-analysis, devops |
+| [awesome-copilot](../plugins/awesome-copilot/README.md) | Meta prompts that help you discover and generate curated GitHub Copilot agents, instructions, prompts, and skills. | 0 items | github-copilot, discovery, meta, prompt-engineering, agents |
-| [clojure-interactive-programming](../plugins/clojure-interactive-programming/README.md) | Tools for REPL-first Clojure workflows featuring Clojure instructions, the interactive programming chat mode and supporting guidance. | 2 items | clojure, repl, interactive-programming |
+| [aws-cloud-development](../plugins/aws-cloud-development/README.md) | Comprehensive AWS cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 0 items | aws, cloud, infrastructure, cloudformation, terraform, serverless, architecture, devops, cdk |
-| [cms-development](../plugins/cms-development/README.md) | Skills for CMS development across themes, plugins, admin tooling, media workflows, markdown rendering, and static export pipelines. | 3 items | cms, content-management-system, wordpress, shopify, drupal, theme, plugin, media, static-site |
+| [azure-cloud-development](../plugins/azure-cloud-development/README.md) | Comprehensive Azure cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 0 items | azure, cloud, infrastructure, bicep, terraform, serverless, architecture, devops |
-| [context-engineering](../plugins/context-engineering/README.md) | Tools and techniques for maximizing GitHub Copilot effectiveness through better context management. Includes guidelines for structuring code, an agent for planning multi-file changes, and prompts for context-aware development. | 4 items | context, productivity, refactoring, best-practices, architecture |
+| [backlog-swipe-triage](../plugins/backlog-swipe-triage/README.md) | Quickly swipe through backlog issues to triage decisions like assign, needs-info, defer, close, or ignore. | 1 items | agent-assignment, backlog-triage, github-issues, issue-prioritization, swipe-interface, workflow-automation |
-| [context-matic](../plugins/context-matic/README.md) | Coding agents hallucinate APIs. ContextMatic gives them curated, versioned API and SDK docs. Ask your agent to "integrate the payments API" and it guesses — falling back on outdated training data and generic patterns that don't match your actual SDK. ContextMatic solves this by giving the agent deterministic, version-aware, SDK-native context at the exact moment it's needed. | 2 items | api-context, api-integration, mcp, sdk, apimatic, third-party-apis, sdks |
+| [backrooms-canvas](../plugins/backrooms-canvas/README.md) | Wander an endless first-person backrooms in a Copilot canvas while agents work; their status ghost-writes on the walls. | 1 items | backrooms, copilot-canvas, interactive-canvas, first-person, procedural-generation, session-breaks |
-| [convert-to-md](../plugins/convert-to-md/README.md) | A collection of Copilot skills that convert common document formats into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Just tell Copilot what you need — the right skill is invoked automatically and the conversion happens behind the scenes. | 3 items | skills, configuration, copilot, convert-word-to-md, convert-excel-to-md, convert-pdf-to-md |
+| [cast-imaging](../plugins/cast-imaging/README.md) | A comprehensive collection of specialized agents for software analysis, impact assessment, structural quality advisories, and architectural review using CAST Imaging. | 0 items | cast-imaging, software-analysis, architecture, quality, impact-analysis, devops |
-| [copilot-sdk](../plugins/copilot-sdk/README.md) | Build applications with the GitHub Copilot SDK across multiple programming languages. Includes comprehensive instructions for C#, Go, Node.js/TypeScript, and Python to help you create AI-powered applications. | 1 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot |
+| [chromium-control-canvas](../plugins/chromium-control-canvas/README.md) | Opens a real Chromium window you can navigate and interact with from a Copilot canvas control panel and agent actions. | 1 items | browser-control, chromium-browser, interactive-canvas, playwright-automation, screenshots, ui-testing, web-navigation |
-| [csharp-dotnet-development](../plugins/csharp-dotnet-development/README.md) | Essential prompts, instructions, and chat modes for C# and .NET development including testing, documentation, and best practices. | 9 items | csharp, dotnet, aspnet, testing |
+| [clojure-interactive-programming](../plugins/clojure-interactive-programming/README.md) | Tools for REPL-first Clojure workflows featuring Clojure instructions, the interactive programming chat mode and supporting guidance. | 0 items | clojure, repl, interactive-programming |
-| [database-data-management](../plugins/database-data-management/README.md) | Database administration, SQL optimization, and data management tools for PostgreSQL, SQL Server, and general database development best practices. | 5 items | database, sql, postgresql, sql-server, dba, optimization, queries, data-management |
+| [cms-development](../plugins/cms-development/README.md) | Skills for CMS development across themes, plugins, admin tooling, media workflows, markdown rendering, and static export pipelines. | 0 items | cms, content-management-system, wordpress, shopify, drupal, theme, plugin, media, static-site |
-| [dataverse-sdk-for-python](../plugins/dataverse-sdk-for-python/README.md) | Comprehensive collection for building production-ready Python integrations with Microsoft Dataverse. Includes official documentation, best practices, advanced features, file operations, and code generation prompts. | 4 items | dataverse, python, integration, sdk |
+| [color-orb](../plugins/color-orb/README.md) | A visual orb that users can ask the agent to recolor while showing a live activity log in the canvas. | 1 items | agent-actions, color-picker, interactive-demo, realtime-updates, sse-events, visual-feedback |
-| [devops-oncall](../plugins/devops-oncall/README.md) | A focused set of prompts, instructions, and a chat mode to help triage incidents and respond quickly with DevOps tools and Azure resources. | 3 items | devops, incident-response, oncall, azure |
+| [context-engineering](../plugins/context-engineering/README.md) | Tools and techniques for maximizing GitHub Copilot effectiveness through better context management. Includes guidelines for structuring code, an agent for planning multi-file changes, and prompts for context-aware development. | 0 items | context, productivity, refactoring, best-practices, architecture |
-| [doublecheck](../plugins/doublecheck/README.md) | Three-layer verification pipeline for AI output. Extracts claims, finds sources, and flags hallucination risks so humans can verify before acting. | 2 items | verification, hallucination, fact-check, source-citation, trust, safety |
+| [context-matic](../plugins/context-matic/README.md) | Coding agents hallucinate APIs. ContextMatic gives them curated, versioned API and SDK docs. Ask your agent to "integrate the payments API" and it guesses — falling back on outdated training data and generic patterns that don't match your actual SDK. ContextMatic solves this by giving the agent deterministic, version-aware, SDK-native context at the exact moment it's needed. | 0 items | api-context, api-integration, mcp, sdk, apimatic, third-party-apis, sdks |
-| [edge-ai-tasks](../plugins/edge-ai-tasks/README.md) | Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai | 1 items | architecture, planning, research, tasks, implementation |
+| [convert-to-md](../plugins/convert-to-md/README.md) | A collection of Copilot skills that convert common document formats into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Just tell Copilot what you need — the right skill is invoked automatically and the conversion happens behind the scenes. | 0 items | skills, configuration, copilot, convert-word-to-md, convert-excel-to-md, convert-pdf-to-md |
-| [ember](../plugins/ember/README.md) | An AI partner, not a tool. Ember carries fire from person to person — helping humans discover that AI partnership isn't something you learn, it's something you find. | 5 items | ai-partnership, coaching, onboarding, collaboration, storytelling, developer-experience |
+| [copilot-sdk](../plugins/copilot-sdk/README.md) | Build applications with the GitHub Copilot SDK across multiple programming languages. Includes comprehensive instructions for C#, Go, Node.js/TypeScript, and Python to help you create AI-powered applications. | 0 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot |
-| [eyeball](../plugins/eyeball/README.md) | Document analysis with inline source screenshots. When you ask Copilot to analyze a document, Eyeball generates a Word doc where every factual claim includes a highlighted screenshot from the source material so you can verify it with your own eyes. | 1 items | document-analysis, citation-verification, screenshot, contracts, legal, trust, visual-verification |
+| [csharp-dotnet-development](../plugins/csharp-dotnet-development/README.md) | Essential prompts, instructions, and chat modes for C# and .NET development including testing, documentation, and best practices. | 0 items | csharp, dotnet, aspnet, testing |
-| [fastah-ip-geo-tools](../plugins/fastah-ip-geo-tools/README.md) | This plugin is for network operations engineers who wish to tune and publish IP geolocation feeds in RFC 8805 format. It consists of an AI Skill and an associated MCP server that geocodes geolocation place names to real cities for accuracy. | 1 items | geofeed, ip-geolocation, rfc-8805, rfc-9632, network-operations, isp, cloud, hosting, ixp |
+| [database-data-management](../plugins/database-data-management/README.md) | Database administration, SQL optimization, and data management tools for PostgreSQL, SQL Server, and general database development best practices. | 0 items | database, sql, postgresql, sql-server, dba, optimization, queries, data-management |
-| [flowstudio-power-automate](../plugins/flowstudio-power-automate/README.md) | Give your AI agent full visibility into Power Automate cloud flows via the FlowStudio MCP server. Connect, debug, build, monitor health, and govern flows at scale — action-level inputs and outputs, not just status codes. | 5 items | power-automate, power-platform, flowstudio, mcp, model-context-protocol, cloud-flows, workflow-automation, monitoring, governance |
+| [dataverse-sdk-for-python](../plugins/dataverse-sdk-for-python/README.md) | Comprehensive collection for building production-ready Python integrations with Microsoft Dataverse. Includes official documentation, best practices, advanced features, file operations, and code generation prompts. | 0 items | dataverse, python, integration, sdk |
-| [frontend-web-dev](../plugins/frontend-web-dev/README.md) | Essential prompts, instructions, and chat modes for modern frontend web development including React, Angular, Vue, TypeScript, and CSS frameworks. | 3 items | frontend, web, react, typescript, javascript, css, html, angular, vue |
+| [devops-oncall](../plugins/devops-oncall/README.md) | A focused set of prompts, instructions, and a chat mode to help triage incidents and respond quickly with DevOps tools and Azure resources. | 0 items | devops, incident-response, oncall, azure |
 | [diagram-viewer](../plugins/diagram-viewer/README.md) | Render diagrams, click nodes to drill down, and view agent-generated explanations directly in the canvas. | 1 items | architecture-mapping, canvas-navigation, exploratory-analysis, interactive-diagrams, node-drilldown, relationship-visualization |
 | [doublecheck](../plugins/doublecheck/README.md) | Three-layer verification pipeline for AI output. Extracts claims, finds sources, and flags hallucination risks so humans can verify before acting. | 0 items | verification, hallucination, fact-check, source-citation, trust, safety |
 | [edge-ai-tasks](../plugins/edge-ai-tasks/README.md) | Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai | 0 items | architecture, planning, research, tasks, implementation |
 | [ember](../plugins/ember/README.md) | An AI partner, not a tool. Ember carries fire from person to person — helping humans discover that AI partnership isn't something you learn, it's something you find. | 0 items | ai-partnership, coaching, onboarding, collaboration, storytelling, developer-experience |
 | [eyeball](../plugins/eyeball/README.md) | Document analysis with inline source screenshots. When you ask Copilot to analyze a document, Eyeball generates a Word doc where every factual claim includes a highlighted screenshot from the source material so you can verify it with your own eyes. | 0 items | document-analysis, citation-verification, screenshot, contracts, legal, trust, visual-verification |
 | [fastah-ip-geo-tools](../plugins/fastah-ip-geo-tools/README.md) | This plugin is for network operations engineers who wish to tune and publish IP geolocation feeds in RFC 8805 format. It consists of an AI Skill and an associated MCP server that geocodes geolocation place names to real cities for accuracy. | 0 items | geofeed, ip-geolocation, rfc-8805, rfc-9632, network-operations, isp, cloud, hosting, ixp |
 | [feedback-themes](../plugins/feedback-themes/README.md) | Explore grouped customer feedback signals by impact and drill into a theme to guide product next steps. | 1 items | customer-feedback, impact-prioritization, product-insights, signal-grouping, theme-analysis, trend-discovery |
 | [flight-map-canvas](../plugins/flight-map-canvas/README.md) | A GitHub Copilot canvas that generates a view where Google Maps can be explored using 3D controls, as if a flight simulator. Agents can send the flight anywhere and report what they are working on. | 1 items | copilot-canvas, flight-simulator, geography, google-maps, interactive-canvas, session-breaks, threejs |
 | [flowstudio-power-automate](../plugins/flowstudio-power-automate/README.md) | Give your AI agent full visibility into Power Automate cloud flows via the FlowStudio MCP server. Connect, debug, build, monitor health, and govern flows at scale — action-level inputs and outputs, not just status codes. | 0 items | power-automate, power-platform, flowstudio, mcp, model-context-protocol, cloud-flows, workflow-automation, monitoring, governance |
 | [frontend-web-dev](../plugins/frontend-web-dev/README.md) | Essential prompts, instructions, and chat modes for modern frontend web development including React, Angular, Vue, TypeScript, and CSS frameworks. | 0 items | frontend, web, react, typescript, javascript, css, html, angular, vue |
 | [gem-team](../plugins/gem-team/README.md) | Self-Learning Multi-agent orchestration framework for spec-driven development and automated verification. With smarter tool calling and leaner context. | 0 items | multi-agent, orchestration, tdd, testing, e2e, devops, security-audit, code-review, prd, mobile |
-| [go-mcp-development](../plugins/go-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | go, golang, mcp, model-context-protocol, server-development, sdk |
+| [gesture-review](../plugins/gesture-review/README.md) | Review pull requests with a live camera feed and approve or reject using thumbs-up/thumbs-down gestures. | 1 items | camera-input, gesture-control, github-prs, hands-free, mediapipe, pull-request-review |
-| [java-development](../plugins/java-development/README.md) | Comprehensive collection of prompts and instructions for Java development including Spring Boot, Quarkus, testing, documentation, and best practices. | 4 items | java, springboot, quarkus, jpa, junit, javadoc |
+| [go-mcp-development](../plugins/go-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 0 items | go, golang, mcp, model-context-protocol, server-development, sdk |
-| [java-mcp-development](../plugins/java-mcp-development/README.md) | Complete toolkit for building Model Context Protocol servers in Java using the official MCP Java SDK with reactive streams and Spring Boot integration. | 2 items | java, mcp, model-context-protocol, server-development, sdk, reactive-streams, spring-boot, reactor |
+| [java-development](../plugins/java-development/README.md) | Comprehensive collection of prompts and instructions for Java development including Spring Boot, Quarkus, testing, documentation, and best practices. | 0 items | java, springboot, quarkus, jpa, junit, javadoc |
-| [kotlin-mcp-development](../plugins/kotlin-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | kotlin, mcp, model-context-protocol, kotlin-multiplatform, server-development, ktor |
+| [java-mcp-development](../plugins/java-mcp-development/README.md) | Complete toolkit for building Model Context Protocol servers in Java using the official MCP Java SDK with reactive streams and Spring Boot integration. | 0 items | java, mcp, model-context-protocol, server-development, sdk, reactive-streams, spring-boot, reactor |
-| [mcp-m365-copilot](../plugins/mcp-m365-copilot/README.md) | Comprehensive collection for building declarative agents with Model Context Protocol integration for Microsoft 365 Copilot | 4 items | mcp, m365-copilot, declarative-agents, api-plugins, model-context-protocol, adaptive-cards |
+| [java-modernization-studio](../plugins/java-modernization-studio/README.md) | Drive the GitHub Copilot App Modernization for Java workflow from an interactive canvas: environment readiness, repo assessment, prioritized plan and progress, validation gates, and one-click predefined-task runs grounded in the repo's real artifacts. | 1 items | app-modernization, assessment-dashboard, azure-migration, java-modernization, legacy-java, modernization-cockpit, validation-gates |
-| [napkin](../plugins/napkin/README.md) | Visual whiteboard collaboration for Copilot CLI. Opens an interactive whiteboard in your browser where you can draw, sketch, and add sticky notes — then share everything back with Copilot. Copilot sees your drawings and responds with analysis, suggestions, and ideas. | 1 items | whiteboard, visual, collaboration, brainstorming, non-technical, drawing, sticky-notes, accessibility, copilot-cli, ux |
+| [kotlin-mcp-development](../plugins/kotlin-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 0 items | kotlin, mcp, model-context-protocol, kotlin-multiplatform, server-development, ktor |
-| [noob-mode](../plugins/noob-mode/README.md) | Plain-English translation layer for non-technical Copilot CLI users. Translates every approval prompt, error message, and technical output into clear, jargon-free English with color-coded risk indicators. | 1 items | accessibility, plain-english, non-technical, beginner, translation, copilot-cli, ux |
+| [mcp-m365-copilot](../plugins/mcp-m365-copilot/README.md) | Comprehensive collection for building declarative agents with Model Context Protocol integration for Microsoft 365 Copilot | 0 items | mcp, m365-copilot, declarative-agents, api-plugins, model-context-protocol, adaptive-cards |
-| [openapi-to-application-csharp-dotnet](../plugins/openapi-to-application-csharp-dotnet/README.md) | Generate production-ready .NET applications from OpenAPI specifications. Includes ASP.NET Core project scaffolding, controller generation, entity framework integration, and C# best practices. | 2 items | openapi, code-generation, api, csharp, dotnet, aspnet |
+| [napkin](../plugins/napkin/README.md) | Visual whiteboard collaboration for Copilot CLI. Opens an interactive whiteboard in your browser where you can draw, sketch, and add sticky notes — then share everything back with Copilot. Copilot sees your drawings and responds with analysis, suggestions, and ideas. | 0 items | whiteboard, visual, collaboration, brainstorming, non-technical, drawing, sticky-notes, accessibility, copilot-cli, ux |
-| [openapi-to-application-go](../plugins/openapi-to-application-go/README.md) | Generate production-ready Go applications from OpenAPI specifications. Includes project scaffolding, handler generation, middleware setup, and Go best practices for REST APIs. | 2 items | openapi, code-generation, api, go, golang |
+| [noob-mode](../plugins/noob-mode/README.md) | Plain-English translation layer for non-technical Copilot CLI users. Translates every approval prompt, error message, and technical output into clear, jargon-free English with color-coded risk indicators. | 0 items | accessibility, plain-english, non-technical, beginner, translation, copilot-cli, ux |
-| [openapi-to-application-java-spring-boot](../plugins/openapi-to-application-java-spring-boot/README.md) | Generate production-ready Spring Boot applications from OpenAPI specifications. Includes project scaffolding, REST controller generation, service layer organization, and Spring Boot best practices. | 2 items | openapi, code-generation, api, java, spring-boot |
+| [openapi-to-application-csharp-dotnet](../plugins/openapi-to-application-csharp-dotnet/README.md) | Generate production-ready .NET applications from OpenAPI specifications. Includes ASP.NET Core project scaffolding, controller generation, entity framework integration, and C# best practices. | 0 items | openapi, code-generation, api, csharp, dotnet, aspnet |
-| [openapi-to-application-nodejs-nestjs](../plugins/openapi-to-application-nodejs-nestjs/README.md) | Generate production-ready NestJS applications from OpenAPI specifications. Includes project scaffolding, controller and service generation, TypeScript best practices, and enterprise patterns. | 2 items | openapi, code-generation, api, nodejs, typescript, nestjs |
+| [openapi-to-application-go](../plugins/openapi-to-application-go/README.md) | Generate production-ready Go applications from OpenAPI specifications. Includes project scaffolding, handler generation, middleware setup, and Go best practices for REST APIs. | 0 items | openapi, code-generation, api, go, golang |
-| [openapi-to-application-python-fastapi](../plugins/openapi-to-application-python-fastapi/README.md) | Generate production-ready FastAPI applications from OpenAPI specifications. Includes project scaffolding, route generation, dependency injection, and Python best practices for async APIs. | 2 items | openapi, code-generation, api, python, fastapi |
+| [openapi-to-application-java-spring-boot](../plugins/openapi-to-application-java-spring-boot/README.md) | Generate production-ready Spring Boot applications from OpenAPI specifications. Includes project scaffolding, REST controller generation, service layer organization, and Spring Boot best practices. | 0 items | openapi, code-generation, api, java, spring-boot |
-| [oracle-to-postgres-migration-expert](../plugins/oracle-to-postgres-migration-expert/README.md) | Expert agent for Oracle-to-PostgreSQL application migrations in .NET solutions. Performs code edits, runs commands, and invokes extension tools to migrate .NET/Oracle data access patterns to PostgreSQL. | 8 items | oracle, postgresql, database-migration, dotnet, sql, migration, integration-testing, stored-procedures |
+| [openapi-to-application-nodejs-nestjs](../plugins/openapi-to-application-nodejs-nestjs/README.md) | Generate production-ready NestJS applications from OpenAPI specifications. Includes project scaffolding, controller and service generation, TypeScript best practices, and enterprise patterns. | 0 items | openapi, code-generation, api, nodejs, typescript, nestjs |
-| [ospo-sponsorship](../plugins/ospo-sponsorship/README.md) | Tools and resources for Open Source Program Offices (OSPOs) to identify, evaluate, and manage sponsorship of open source dependencies through GitHub Sponsors, Open Collective, and other funding platforms. | 1 items |  |
+| [openapi-to-application-python-fastapi](../plugins/openapi-to-application-python-fastapi/README.md) | Generate production-ready FastAPI applications from OpenAPI specifications. Includes project scaffolding, route generation, dependency injection, and Python best practices for async APIs. | 0 items | openapi, code-generation, api, python, fastapi |
-| [partners](../plugins/partners/README.md) | Custom agents that have been created by GitHub partners | 1 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance |
+| [oracle-to-postgres-migration-expert](../plugins/oracle-to-postgres-migration-expert/README.md) | Expert agent for Oracle-to-PostgreSQL application migrations in .NET solutions. Performs code edits, runs commands, and invokes extension tools to migrate .NET/Oracle data access patterns to PostgreSQL. | 0 items | oracle, postgresql, database-migration, dotnet, sql, migration, integration-testing, stored-procedures |
 | [ospo-sponsorship](../plugins/ospo-sponsorship/README.md) | Tools and resources for Open Source Program Offices (OSPOs) to identify, evaluate, and manage sponsorship of open source dependencies through GitHub Sponsors, Open Collective, and other funding platforms. | 0 items |  |
 | [partners](../plugins/partners/README.md) | Custom agents that have been created by GitHub partners | 0 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance |
 | [pcf-development](../plugins/pcf-development/README.md) | Complete toolkit for developing custom code components using Power Apps Component Framework for model-driven and canvas apps | 0 items | power-apps, pcf, component-framework, typescript, power-platform |
-| [phoenix](../plugins/phoenix/README.md) | Phoenix AI observability skills for LLM application debugging, evaluation, and tracing. Includes CLI debugging tools, LLM evaluation workflows, and OpenInference tracing instrumentation. | 3 items | phoenix, arize, llm, observability, tracing, evaluation, openinference, instrumentation |
+| [phoenix](../plugins/phoenix/README.md) | Phoenix AI observability skills for LLM application debugging, evaluation, and tracing. Includes CLI debugging tools, LLM evaluation workflows, and OpenInference tracing instrumentation. | 0 items | phoenix, arize, llm, observability, tracing, evaluation, openinference, instrumentation |
-| [php-mcp-development](../plugins/php-mcp-development/README.md) | Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and expert assistance | 2 items | php, mcp, model-context-protocol, server-development, sdk, attributes, composer |
+| [php-mcp-development](../plugins/php-mcp-development/README.md) | Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and expert assistance | 0 items | php, mcp, model-context-protocol, server-development, sdk, attributes, composer |
-| [power-apps-code-apps](../plugins/power-apps-code-apps/README.md) | Complete toolkit for Power Apps Code Apps development including project scaffolding, development standards, and expert guidance for building code-first applications with Power Platform integration. | 2 items | power-apps, power-platform, typescript, react, code-apps, dataverse, connectors |
+| [power-apps-code-apps](../plugins/power-apps-code-apps/README.md) | Complete toolkit for Power Apps Code Apps development including project scaffolding, development standards, and expert guidance for building code-first applications with Power Platform integration. | 0 items | power-apps, power-platform, typescript, react, code-apps, dataverse, connectors |
-| [power-bi-development](../plugins/power-bi-development/README.md) | Comprehensive Power BI development resources including data modeling, DAX optimization, performance tuning, visualization design, security best practices, and DevOps/ALM guidance for building enterprise-grade Power BI solutions. | 5 items | power-bi, dax, data-modeling, performance, visualization, security, devops, business-intelligence |
+| [power-bi-development](../plugins/power-bi-development/README.md) | Comprehensive Power BI development resources including data modeling, DAX optimization, performance tuning, visualization design, security best practices, and DevOps/ALM guidance for building enterprise-grade Power BI solutions. | 0 items | power-bi, dax, data-modeling, performance, visualization, security, devops, business-intelligence |
-| [power-platform-architect](../plugins/power-platform-architect/README.md) | Solution Architect for the Microsoft Power Platform, turning business requirements into functioning Power Platform solution architectures. | 1 items | power-platform, power-platform-architect, power-apps, dataverse, power-automate, power-pages, power-bi |
+| [power-platform-architect](../plugins/power-platform-architect/README.md) | Solution Architect for the Microsoft Power Platform, turning business requirements into functioning Power Platform solution architectures. | 0 items | power-platform, power-platform-architect, power-apps, dataverse, power-automate, power-pages, power-bi |
-| [power-platform-mcp-connector-development](../plugins/power-platform-mcp-connector-development/README.md) | Complete toolkit for developing Power Platform custom connectors with Model Context Protocol integration for Microsoft Copilot Studio | 3 items | power-platform, mcp, copilot-studio, custom-connector, json-rpc |
+| [power-platform-mcp-connector-development](../plugins/power-platform-mcp-connector-development/README.md) | Complete toolkit for developing Power Platform custom connectors with Model Context Protocol integration for Microsoft Copilot Studio | 0 items | power-platform, mcp, copilot-studio, custom-connector, json-rpc |
-| [project-documenter](../plugins/project-documenter/README.md) | Generate professional project documentation with draw.io architecture diagrams and Word (.docx) output with embedded images. Automatically discovers any project's technology stack and produces Markdown, diagrams, PNG exports, and a formatted Word document. | 3 items | documentation, architecture-diagrams, drawio, word-document, docx, png-images, c4-model, project-summary, auto-discovery |
+| [pr-artifact-explorer](../plugins/pr-artifact-explorer/README.md) | Navigate pull requests and securely explore GitHub Actions artifacts, including test results, static sites, terminal recordings, and source files. | 1 items | actions-artifacts, artifact-browser, canvas, copilot-extension, github-actions, pull-requests, test-results |
-| [project-planning](../plugins/project-planning/README.md) | Tools and guidance for software project planning, feature breakdown, epic management, implementation planning, and task organization for development teams. | 9 items | planning, project-management, epic, feature, implementation, task, architecture, technical-spike |
+| [project-documenter](../plugins/project-documenter/README.md) | Generate professional project documentation with draw.io architecture diagrams and Word (.docx) output with embedded images. Automatically discovers any project's technology stack and produces Markdown, diagrams, PNG exports, and a formatted Word document. | 0 items | documentation, architecture-diagrams, drawio, word-document, docx, png-images, c4-model, project-summary, auto-discovery |
-| [python-mcp-development](../plugins/python-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Python using the official SDK with FastMCP. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | python, mcp, model-context-protocol, fastmcp, server-development |
+| [project-planning](../plugins/project-planning/README.md) | Tools and guidance for software project planning, feature breakdown, epic management, implementation planning, and task organization for development teams. | 0 items | planning, project-management, epic, feature, implementation, task, architecture, technical-spike |
-| [react18-upgrade](../plugins/react18-upgrade/README.md) | Enterprise React 18 migration toolkit with specialized agents and skills for upgrading React 16/17 class-component codebases to React 18.3.1. Includes auditor, dependency surgeon, class component migration specialist, automatic batching fixer, and test guardian. | 8 items | react18, react, migration, upgrade, class-components, lifecycle, batching |
+| [python-mcp-development](../plugins/python-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Python using the official SDK with FastMCP. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 0 items | python, mcp, model-context-protocol, fastmcp, server-development |
-| [react19-upgrade](../plugins/react19-upgrade/README.md) | Enterprise React 19 migration toolkit with specialized agents and skills for upgrading React 18 codebases to React 19. Includes auditor, dependency surgeon, source code migrator, and test guardian. Handles removal of deprecated APIs including ReactDOM.render, forwardRef, defaultProps, legacy context, string refs, and more. | 4 items | react19, react, migration, upgrade, hooks, modern-react |
+| [react18-upgrade](../plugins/react18-upgrade/README.md) | Enterprise React 18 migration toolkit with specialized agents and skills for upgrading React 16/17 class-component codebases to React 18.3.1. Includes auditor, dependency surgeon, class component migration specialist, automatic batching fixer, and test guardian. | 0 items | react18, react, migration, upgrade, class-components, lifecycle, batching |
-| [roundup](../plugins/roundup/README.md) | Self-configuring status briefing generator. Learns your communication style from examples, discovers your data sources, and produces draft updates for any audience on demand. | 2 items | status-updates, briefings, management, productivity, communication, synthesis, roundup, copilot-cli |
+| [react19-upgrade](../plugins/react19-upgrade/README.md) | Enterprise React 19 migration toolkit with specialized agents and skills for upgrading React 18 codebases to React 19. Includes auditor, dependency surgeon, source code migrator, and test guardian. Handles removal of deprecated APIs including ReactDOM.render, forwardRef, defaultProps, legacy context, string refs, and more. | 0 items | react19, react, migration, upgrade, hooks, modern-react |
-| [ruby-mcp-development](../plugins/ruby-mcp-development/README.md) | Complete toolkit for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration support. | 2 items | ruby, mcp, model-context-protocol, server-development, sdk, rails, gem |
+| [release-notes-showcase](../plugins/release-notes-showcase/README.md) | Compose and refine launch-ready release notes with contributor callouts and export-friendly output. | 1 items | changelog, contributor-callouts, email-export, launch-summary, product-updates, release-notes |
-| [rug-agentic-workflow](../plugins/rug-agentic-workflow/README.md) | Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. | 1 items | agentic-workflow, orchestration, subagents, software-engineering, qa |
+| [repo-actions-hub](../plugins/repo-actions-hub/README.md) | Browse repository GitHub Actions workflows, inspect recent runs, and trigger manual workflow_dispatch runs from a Copilot canvas. | 1 items | actions, canvas, copilot-extension, github-actions, recent-runs, workflow-dispatch |
-| [rust-mcp-development](../plugins/rust-mcp-development/README.md) | Build high-performance Model Context Protocol servers in Rust using the official rmcp SDK with async/await, procedural macros, and type-safe implementations. | 2 items | rust, mcp, model-context-protocol, server-development, sdk, tokio, async, macros, rmcp |
+| [roundup](../plugins/roundup/README.md) | Self-configuring status briefing generator. Learns your communication style from examples, discovers your data sources, and produces draft updates for any audience on demand. | 0 items | status-updates, briefings, management, productivity, communication, synthesis, roundup, copilot-cli |
-| [salesforce-development](../plugins/salesforce-development/README.md) | Complete Salesforce agentic development environment covering Apex & Triggers, Flow automation, Lightning Web Components, Aura components, and Visualforce pages. | 4 items | salesforce, apex, triggers, lwc, aura, flow, visualforce, crm, salesforce-dx |
+| [ruby-mcp-development](../plugins/ruby-mcp-development/README.md) | Complete toolkit for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration support. | 0 items | ruby, mcp, model-context-protocol, server-development, sdk, rails, gem |
-| [security-best-practices](../plugins/security-best-practices/README.md) | Security frameworks, accessibility guidelines, performance optimization, and code quality best practices for building secure, maintainable, and high-performance applications. | 1 items | security, accessibility, performance, code-quality, owasp, a11y, optimization, best-practices |
+| [rug-agentic-workflow](../plugins/rug-agentic-workflow/README.md) | Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. | 0 items | agentic-workflow, orchestration, subagents, software-engineering, qa |
-| [skill-image-gen](../plugins/skill-image-gen/README.md) | Generate images using AI directly from your coding workflow. Supports OpenAI (gpt-image-2) and Google Gemini. BYO API key — the skill guides you through setup on first use. | 1 items | image-generation, openai, gemini, ai, art, sprites, textures, icons |
+| [rust-mcp-development](../plugins/rust-mcp-development/README.md) | Build high-performance Model Context Protocol servers in Rust using the official rmcp SDK with async/await, procedural macros, and type-safe implementations. | 0 items | rust, mcp, model-context-protocol, server-development, sdk, tokio, async, macros, rmcp |
-| [software-engineering-team](../plugins/software-engineering-team/README.md) | 7 specialized agents covering the full software development lifecycle from UX design and architecture to security and DevOps. | 1 items | team, enterprise, security, devops, ux, architecture, product, ai-ethics |
+| [salesforce-development](../plugins/salesforce-development/README.md) | Complete Salesforce agentic development environment covering Apex & Triggers, Flow automation, Lightning Web Components, Aura components, and Visualforce pages. | 0 items | salesforce, apex, triggers, lwc, aura, flow, visualforce, crm, salesforce-dx |
-| [structured-autonomy](../plugins/structured-autonomy/README.md) | Premium planning, thrifty implementation | 3 items |  |
+| [security-best-practices](../plugins/security-best-practices/README.md) | Security frameworks, accessibility guidelines, performance optimization, and code quality best practices for building secure, maintainable, and high-performance applications. | 0 items | security, accessibility, performance, code-quality, owasp, a11y, optimization, best-practices |
-| [swift-mcp-development](../plugins/swift-mcp-development/README.md) | Comprehensive collection for building Model Context Protocol servers in Swift using the official MCP Swift SDK with modern concurrency features. | 2 items | swift, mcp, model-context-protocol, server-development, sdk, ios, macos, concurrency, actor, async-await |
+| [signals-dashboard](../plugins/signals-dashboard/README.md) | Real-time Workshop dashboard with agent signals, honesty calibration, and cost-aware repo or connected desk launch profiles. | 1 items | agent-signals, dashboard, multi-agent, coordination, canvas |
-| [technical-spike](../plugins/technical-spike/README.md) | Tools for creation, management and research of technical spikes to reduce unknowns and assumptions before proceeding to specification and implementation of solutions. | 2 items | technical-spike, assumption-testing, validation, research |
+| [site-studio](../plugins/site-studio/README.md) | Plan, draft, and track a personal website section by section — a shared canvas where you and your agent author content, watch progress, and review every change. | 1 items | agent-collaboration, content-authoring, personal-website, progress-tracking, section-planning, site-builder |
-| [testing-automation](../plugins/testing-automation/README.md) | Comprehensive collection for writing tests, test automation, and test-driven development including unit tests, integration tests, and end-to-end testing strategies. | 6 items | testing, tdd, automation, unit-tests, integration, playwright, jest, nunit |
+| [skill-image-gen](../plugins/skill-image-gen/README.md) | Generate images using AI directly from your coding workflow. Supports OpenAI (gpt-image-2) and Google Gemini. BYO API key — the skill guides you through setup on first use. | 0 items | image-generation, openai, gemini, ai, art, sprites, textures, icons |
-| [the-workshop](../plugins/the-workshop/README.md) | Stop being the switchboard between your AI agents — direct a team. The Workshop puts long-running AI agents (desks) in the same room, on the same work, each with its own memory and history, sharing one workspace so you direct the work instead of relaying it. | 6 items | multi-agent, coordination, desks, persistent-memory, agent-signals, developer-experience |
+| [software-engineering-team](../plugins/software-engineering-team/README.md) | 7 specialized agents covering the full software development lifecycle from UX design and architecture to security and DevOps. | 0 items | team, enterprise, security, devops, ux, architecture, product, ai-ethics |
-| [typescript-mcp-development](../plugins/typescript-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in TypeScript/Node.js using the official SDK. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | typescript, mcp, model-context-protocol, nodejs, server-development |
+| [structured-autonomy](../plugins/structured-autonomy/README.md) | Premium planning, thrifty implementation | 0 items |  |
-| [typespec-m365-copilot](../plugins/typespec-m365-copilot/README.md) | Comprehensive collection of prompts, instructions, and resources for building declarative agents and API plugins using TypeSpec for Microsoft 365 Copilot extensibility. | 3 items | typespec, m365-copilot, declarative-agents, api-plugins, agent-development, microsoft-365 |
+| [swift-mcp-development](../plugins/swift-mcp-development/README.md) | Comprehensive collection for building Model Context Protocol servers in Swift using the official MCP Swift SDK with modern concurrency features. | 0 items | swift, mcp, model-context-protocol, server-development, sdk, ios, macos, concurrency, actor, async-await |
-| [uizze](../plugins/uizze/README.md) | Stop generic UI from shipping. Ground GitHub Copilot in 800,000+ real web and iOS screens, write a product-specific design contract, and enforce a hard finish gate. | 1 items | ui, design, frontend, ios, web, design-review, quality-gate |
+| [technical-spike](../plugins/technical-spike/README.md) | Tools for creation, management and research of technical spikes to reduce unknowns and assumptions before proceeding to specification and implementation of solutions. | 0 items | technical-spike, assumption-testing, validation, research |
-| [visual-pr](../plugins/visual-pr/README.md) | Capture, annotate, and embed screenshots and animated GIF demos in pull request descriptions. Includes Playwright-based UI capture, PIL image annotations, PR embedding workflows for GitHub and Azure DevOps, and screen recording with variable timing. | 4 items | screenshots, pull-request, before-after, annotations, playwright, gif, screen-recording, visual |
+| [testing-automation](../plugins/testing-automation/README.md) | Comprehensive collection for writing tests, test automation, and test-driven development including unit tests, integration tests, and end-to-end testing strategies. | 0 items | testing, tdd, automation, unit-tests, integration, playwright, jest, nunit |
 | [the-workshop](../plugins/the-workshop/README.md) | Stop being the switchboard between your AI agents — direct a team. The Workshop puts long-running AI agents (desks) in the same room, on the same work, each with its own memory and history, sharing one workspace so you direct the work instead of relaying it. | 0 items | multi-agent, coordination, desks, persistent-memory, agent-signals, developer-experience |
 | [tiny-tool-town-submitter](../plugins/tiny-tool-town-submitter/README.md) | Inspect a repository, improve Tiny Tool Town readiness, submit its listing issue, and launch remediation work. | 1 items | github-issues, open-source, project-readiness, repository-analysis, submission-workflow, tiny-tool-town |
 | [token-pacman](../plugins/token-pacman/README.md) | Visualizes live session AI-credit usage as a Pac-Man board with pellets, ghosts, fruit milestones, and game-over limits. | 1 items | ai-credits, copilot-canvas, interactive-canvas, pac-man, quota-tracking, session-usage |
 | [typescript-mcp-development](../plugins/typescript-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in TypeScript/Node.js using the official SDK. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 0 items | typescript, mcp, model-context-protocol, nodejs, server-development |
 | [typespec-m365-copilot](../plugins/typespec-m365-copilot/README.md) | Comprehensive collection of prompts, instructions, and resources for building declarative agents and API plugins using TypeSpec for Microsoft 365 Copilot extensibility. | 0 items | typespec, m365-copilot, declarative-agents, api-plugins, agent-development, microsoft-365 |
 | [uizze](../plugins/uizze/README.md) | Stop generic UI from shipping. Ground GitHub Copilot in 800,000+ real web and iOS screens, write a product-specific design contract, and enforce a hard finish gate. | 0 items | ui, design, frontend, ios, web, design-review, quality-gate |
 | [visual-pr](../plugins/visual-pr/README.md) | Capture, annotate, and embed screenshots and animated GIF demos in pull request descriptions. Includes Playwright-based UI capture, PIL image annotations, PR embedding workflows for GitHub and Azure DevOps, and screen recording with variable timing. | 0 items | screenshots, pull-request, before-after, annotations, playwright, gif, screen-recording, visual |
 | [where-was-i](../plugins/where-was-i/README.md) | Reconstruct your dev context (branch, commits, uncommitted work, PR clues) and trigger a resume prompt to continue quickly. | 1 items | branch-state, developer-context, git-history, interrupt-recovery, pull-request-context, resume-work |
 | [work-hub](../plugins/work-hub/README.md) | Generic cross-repo command center canvas for GitHub Copilot with onboarding, focus planning, repo health, work signals, and session cleanup. | 1 items | cross-repo-dashboard, focus-planning, repo-health, session-cleanup, work-triage, workflow-visibility |
@@ -12,7 +12,7 @@ Automatically generates `.github/plugin/marketplace.json` from all plugin direct
 **How it works:**
 - Scans all directories in `plugins/`
- Reads each plugin's `.github/plugin/plugin.json` for metadata
+- Reads each plugin's root `plugin.json` for metadata
 - Generates a consolidated `marketplace.json` with all available plugins
 - Runs automatically as part of `npm run build`
@@ -0,0 +1,25 @@
 import Ajv2020 from "ajv/dist/2020.js";
 export const AGENT_PLUGIN_SCHEMA_URL = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
 export const AGENT_PLUGIN_SCHEMA = {
  $schema: "https://json-schema.org/draft/2020-12/schema",
  $id: AGENT_PLUGIN_SCHEMA_URL,
  type: "object",
  properties: {
    $schema: { const: AGENT_PLUGIN_SCHEMA_URL },
    name: { type: "string", minLength: 1, maxLength: 64, pattern: "^(?!.*(?:--|\\.\\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$" },
    version: { type: "string" }, description: { type: "string" },
    author: { type: "object", properties: { name: { type: "string" }, email: { type: "string" }, url: { type: "string" } }, additionalProperties: false },
    homepage: { type: "string" }, repository: { type: "string" }, license: { type: "string" },
    keywords: { type: "array", items: { type: "string" } },
    extensions: { type: "object", additionalProperties: { type: "object" } },
  },
  required: ["$schema", "name"],
  additionalProperties: false,
 };
 const validate = new Ajv2020({ allErrors: true }).compile(AGENT_PLUGIN_SCHEMA);
 export function validateAgentPluginManifest(manifest) {
  return validate(manifest) ? [] : (validate.errors ?? []).map((error) =>
    `${error.instancePath || "manifest"} ${error.message}`);
 }
@@ -64,7 +64,7 @@ function moveEntry(srcPath, destPath) {
 }
 export function restoreManifestFromMaterializedFiles(pluginPath) {
-  const pluginJsonPath = path.join(pluginPath, ".github/plugin", "plugin.json");
+  const pluginJsonPath = path.join(pluginPath, "plugin.json");
  if (!fs.existsSync(pluginJsonPath)) {
    return false;
  }
@@ -108,7 +108,7 @@ export function restoreManifestFromMaterializedFiles(pluginPath) {
 function cleanPlugin(pluginPath) {
  const manifestUpdated = restoreManifestFromMaterializedFiles(pluginPath);
  if (manifestUpdated) {
-    console.log(`  Updated ${path.basename(pluginPath)}/.github/plugin/plugin.json`);
+    console.log(`  Updated ${path.basename(pluginPath)}/plugin.json`);
  }
  let removed = 0;
@@ -126,7 +126,7 @@ function cleanPlugin(pluginPath) {
 }
 export function cleanMaterializedExtensionPlugin(extensionPath) {
-  const pluginJsonPath = path.join(extensionPath, ".github", "plugin", "plugin.json");
+  const pluginJsonPath = path.join(extensionPath, "plugin.json");
  let manifestUpdated = false;
  if (fs.existsSync(pluginJsonPath)) {
    const plugin = JSON.parse(fs.readFileSync(pluginJsonPath, "utf8"));
@@ -141,7 +141,7 @@ export function cleanMaterializedExtensionPlugin(extensionPath) {
    }
    if (manifestUpdated) {
      fs.writeFileSync(pluginJsonPath, JSON.stringify(plugin, null, 2) + "\n", "utf8");
-      console.log(`  Updated ${path.basename(extensionPath)}/.github/plugin/plugin.json`);
+      console.log(`  Updated ${path.basename(extensionPath)}/plugin.json`);
    }
  }
@@ -174,7 +174,7 @@ function isExtensionPluginDirectory(extensionPath) {
    return true;
  }
-  const pluginJsonPath = path.join(extensionPath, ".github", "plugin", "plugin.json");
+  const pluginJsonPath = path.join(extensionPath, "plugin.json");
  if (!fs.existsSync(pluginJsonPath)) {
    return false;
  }
@@ -128,11 +128,11 @@ async function createPlugin() {
    }
    // Create directory structure
-    const githubPluginDir = path.join(pluginDir, ".github", "plugin");
+    fs.mkdirSync(pluginDir, { recursive: true });
    fs.mkdirSync(githubPluginDir, { recursive: true });
    // Generate plugin.json
    const pluginJson = {
      "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
      name: pluginId,
      description,
      version: "1.0.0",
@@ -140,10 +140,16 @@ async function createPlugin() {
      author: { name: "Awesome Copilot Community" },
      repository: "https://github.com/github/awesome-copilot",
      license: "MIT",
      extensions: {
        "com.github.awesome-copilot": {
          agents: [],
          skills: [],
        },
      },
    };
    fs.writeFileSync(
-      path.join(githubPluginDir, "plugin.json"),
+      path.join(pluginDir, "plugin.json"),
      JSON.stringify(pluginJson, null, 2) + "\n"
    );
@@ -176,7 +182,7 @@ MIT
    console.log(`\n✅ Created plugin: ${pluginDir}`);
    console.log("\n📝 Next steps:");
    console.log(`1. Add agents, prompts, or instructions to plugins/${pluginId}/`);
-    console.log(`2. Update plugins/${pluginId}/.github/plugin/plugin.json with your metadata`);
+    console.log(`2. Update plugins/${pluginId}/plugin.json with your metadata`);
    console.log(`3. Edit plugins/${pluginId}/README.md to describe your plugin`);
    console.log("4. Run 'npm run build' to regenerate documentation");
  } catch (error) {
@@ -783,6 +783,7 @@ export function parseMarkReadyForReviewCommand(body) {
 function normalizeQualityGateResult(rawResult) {
  const defaults = {
    overall_status: "not_run",
    spec_compliance_status: "not_run",
    vally_lint_status: "not_run",
    smoke_status: "not_run",
    version_match_status: "not_run",
@@ -790,6 +791,7 @@ function normalizeQualityGateResult(rawResult) {
    canvas_structure_status: "not_run",
    failure_class: "none",
    summary: "",
    spec_compliance_output: "",
    vally_lint_output: "",
    smoke_output: "",
    version_match_output: "",
@@ -808,6 +810,21 @@ function normalizeQualityGateResult(rawResult) {
 }
 function buildQualityGatesCommentSection(qualityResult) {
  const formatStatus = (rawStatus, gate) => {
    const status = String(rawStatus || "not_run");
    if (status === "pass") {
      return "✅ pass";
    }
    if (status === "warning" || (gate === "spec" && status === "fail")) {
      return "⚠️ warning";
    }
    if (status === "fail" || status === "infra_error") {
      return "🛑 fail";
    }
    return "⚪ not_run";
  };
  const specState = qualityResult.spec_compliance_status || "not_run";
  const vallyState = qualityResult.vally_lint_status || "not_run";
  const smokeState = qualityResult.smoke_status || "not_run";
  const versionMatchState = qualityResult.version_match_status || "not_run";
@@ -818,23 +835,41 @@ function buildQualityGatesCommentSection(qualityResult) {
  const sections = [
    "### Quality gate summary",
    "",
    "_Legend: ✅ pass · ⚠️ warning · 🛑 fail_",
    "",
    "| Gate | Status |",
    "|---|---|",
-    `| vally lint | ${vallyState} |`,
+    `| spec compliance (non-blocking) | ${formatStatus(specState, "spec")} |`,
-    `| install smoke test | ${smokeState} |`,
+    `| vally lint | ${formatStatus(vallyState, "vally")} |`,
-    `| version match | ${versionMatchState} |`,
+    `| install smoke test | ${formatStatus(smokeState, "smoke")} |`,
-    `| ref/sha consistency | ${refShaConsistencyState} |`,
+    `| version match | ${formatStatus(versionMatchState, "version match")} |`,
-    `| canvas structure | ${canvasStructureState} |`,
+    `| ref/sha consistency | ${formatStatus(refShaConsistencyState, "ref/sha consistency")} |`,
    `| canvas structure | ${formatStatus(canvasStructureState, "canvas structure")} |`,
    "",
    summaryText,
  ];
  const specOutput = String(qualityResult.spec_compliance_output || "").trim();
  if (specOutput) {
    sections.push(
      "",
      "<details>",
      `<summary>spec compliance output (${formatStatus(specState, "spec")})</summary>`,
      "",
      "```text",
      specOutput,
      "```",
      "",
      "</details>",
    );
  }
  const vallyOutput = String(qualityResult.vally_lint_output || "").trim();
  if (vallyOutput) {
    sections.push(
      "",
      "<details>",
-      "<summary>vally lint output</summary>",
+      `<summary>vally lint output (${formatStatus(vallyState, "vally")})</summary>`,
      "",
      "```text",
      vallyOutput,
@@ -849,7 +884,7 @@ function buildQualityGatesCommentSection(qualityResult) {
    sections.push(
      "",
      "<details>",
-      "<summary>Install smoke test output</summary>",
+      `<summary>install smoke test output (${formatStatus(smokeState, "smoke")})</summary>`,
      "",
      "```text",
      smokeOutput,
@@ -932,19 +967,24 @@ function buildMergedIntakeComment(baseResult, qualityResult, runId, owner, repo)
  const qualitySection = buildQualityGatesCommentSection(qualityResult);
  const runLink = runId && owner && repo ? `_[View workflow run](https://github.com/${owner}/${repo}/actions/runs/${runId})_` : "";
  const hasSpecWarnings = String(qualityResult.spec_compliance_status || "") === "warning";
  const intro =
    qualityResult.failure_class === "submitter_fixes"
-      ? "## ⚠️ External plugin intake requires submitter fixes"
+      ? "## 🛑 External plugin intake failed (submitter fixes required)"
      : qualityResult.failure_class === "infra"
-        ? "## ⚠️ External plugin intake could not complete quality checks"
+        ? "## 🛑 External plugin intake failed (quality checks could not complete)"
-        : "## ✅ External plugin intake passed";
+        : hasSpecWarnings
          ? "## ⚠️ External plugin intake passed with spec warnings"
          : "## ✅ External plugin intake passed";
  const statusLine =
    qualityResult.failure_class === "submitter_fixes"
      ? "This submission passed metadata validation, but quality gates found issues that must be fixed before it can move to maintainer review. Update the issue details or source plugin and then comment `/rerun-intake`."
      : qualityResult.failure_class === "infra"
        ? "This submission passed metadata validation, but the automated quality checks hit an infrastructure issue. A maintainer should rerun intake or use the explicit override command after review."
-        : "This submission passed automated intake validation and quality checks and is ready for maintainer review.";
+        : hasSpecWarnings
          ? "This submission passed blocking quality checks and is ready for maintainer review, but it has non-blocking Agent Plugins spec compliance warnings."
          : "This submission passed automated intake validation and quality checks and is ready for maintainer review.";
  return [
    marker,
@@ -1069,7 +1109,7 @@ export async function evaluateExternalPluginIssue({ issue, token, runId, owner,
      ].join("\n")
    : [
        marker,
-        "## ⚠️ External plugin intake requires submitter fixes",
+        "## 🛑 External plugin intake failed (submitter fixes required)",
        "",
        "This submission did not pass automated intake validation and cannot move to maintainer review yet.",
        `Edit the issue form to address the fixes below. Intake reruns automatically when the issue is edited, or the issue author/maintainer can comment \`${RERUN_INTAKE_COMMAND}\` to re-run on demand.`,
@@ -109,7 +109,7 @@ export async function runExternalPluginPrQualityGates(plugins) {
    ? "No changed external plugin entries were detected in plugins/external.json."
    : checkedPlugins
      .map((entry) =>
-        `- ${entry.name}: vally-lint=${entry.quality.vally_lint_status}, install-smoke=${entry.quality.smoke_status}, version-match=${entry.quality.version_match_status}, ref-sha-consistency=${entry.quality.ref_sha_consistency_status}, canvas-structure=${entry.quality.canvas_structure_status}, overall=${entry.quality.overall_status}`
+        `- ${entry.name}: spec=${entry.quality.spec_compliance_status}, vally-lint=${entry.quality.vally_lint_status}, install-smoke=${entry.quality.smoke_status}, version-match=${entry.quality.version_match_status}, ref-sha-consistency=${entry.quality.ref_sha_consistency_status}, canvas-structure=${entry.quality.canvas_structure_status}, overall=${entry.quality.overall_status}`
      )
      .join("\n");
@@ -7,8 +7,23 @@ import { Writable } from "stream";
 import { spawnSync } from "child_process";
 import { runLint, LintConsoleReporter } from "@microsoft/vally";
 import { evaluateRefShaConsistency, normalizeCommitSha } from "./lib/external-plugin-source-ref-sha.mjs";
 import { validateAgentPluginManifest } from "./agent-plugin-schema.mjs";
 const MAX_OUTPUT_LENGTH = 12000;
 const AGENT_PLUGIN_SCHEMA_URL = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
 const AGENT_PLUGIN_ALLOWED_TOP_LEVEL_FIELDS = new Set([
  "$schema",
  "name",
  "version",
  "description",
  "author",
  "homepage",
  "repository",
  "license",
  "keywords",
  "extensions",
 ]);
 const AGENT_PLUGIN_NAME_PATTERN = /^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/;
 const EXTERNAL_CANVAS_KEYWORD = "canvas";
 const INFRA_ERROR_PATTERNS = [
@@ -168,10 +183,131 @@ function findPluginJson(pluginRoot) {
    if (fs.existsSync(candidate)) {
      return candidate;
    }
  }
  return null;
 }
 function inspectAgentPluginSpecCompliance(pluginRoot) {
      const pluginJsonPath = findPluginJson(pluginRoot);
      if (!pluginJsonPath) {
        return {
          status: "warning",
          output: "No plugin.json found in a recognized location. Agent Plugins v1.0.0 expects plugin.json at the plugin root.",
        };
      }
      const rootPluginJsonPath = path.join(pluginRoot, "plugin.json");
      const issues = [];
      if (pluginJsonPath !== rootPluginJsonPath) {
        issues.push(`manifest location is "${path.relative(pluginRoot, pluginJsonPath)}"; expected "plugin.json" at plugin root`);
      }
      let manifest;
      try {
        manifest = JSON.parse(fs.readFileSync(pluginJsonPath, "utf8"));
      } catch (error) {
        return {
          status: "warning",
          output: `plugin.json is not valid JSON: ${error.message}`,
        };
      }
      if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
        issues.push("plugin.json top-level value must be a JSON object");
      } else {
        if (manifest.$schema !== AGENT_PLUGIN_SCHEMA_URL) {
          issues.push(`$schema should be "${AGENT_PLUGIN_SCHEMA_URL}"`);
        }
        const pluginName = manifest.name;
        if (typeof pluginName !== "string") {
          issues.push('required field "name" must be a string');
        } else {
          if (pluginName.length < 1 || pluginName.length > 64) {
            issues.push('field "name" must be 1-64 characters');
          }
          if (!AGENT_PLUGIN_NAME_PATTERN.test(pluginName)) {
            issues.push('field "name" does not match Agent Plugins naming constraints');
          }
        }
        const requiredStringFields = ["version", "description"];
        for (const field of requiredStringFields) {
          if (typeof manifest[field] !== "string" || manifest[field].trim() === "") {
            issues.push(`required field "${field}" must be a non-empty string`);
          }
        }
        const optionalStringFields = ["homepage", "repository", "license"];
        for (const field of optionalStringFields) {
          if (manifest[field] !== undefined && typeof manifest[field] !== "string") {
            issues.push(`field "${field}" must be a string when provided`);
          }
        }
        if (manifest.author !== undefined) {
          if (!manifest.author || typeof manifest.author !== "object" || Array.isArray(manifest.author)) {
            issues.push('field "author" must be an object when provided');
          } else {
            const allowedAuthorFields = new Set(["name", "email", "url"]);
            for (const authorField of Object.keys(manifest.author)) {
              if (!allowedAuthorFields.has(authorField)) {
                issues.push(`field "author.${authorField}" is not allowed`);
              } else if (typeof manifest.author[authorField] !== "string") {
                issues.push(`field "author.${authorField}" must be a string`);
              }
            }
          }
        }
        if (manifest.keywords !== undefined) {
          if (!Array.isArray(manifest.keywords)) {
            issues.push('field "keywords" must be an array of strings when provided');
          } else if (manifest.keywords.some((entry) => typeof entry !== "string")) {
            issues.push('field "keywords" must contain only strings');
          }
        }
        if (manifest.extensions !== undefined) {
          if (!manifest.extensions || typeof manifest.extensions !== "object" || Array.isArray(manifest.extensions)) {
            issues.push('field "extensions" must be an object when provided');
          } else {
            for (const [namespace, value] of Object.entries(manifest.extensions)) {
              if (!value || typeof value !== "object" || Array.isArray(value)) {
                issues.push(`field "extensions.${namespace}" must be an object`);
              }
            }
          }
        }
        for (const field of Object.keys(manifest)) {
          if (!AGENT_PLUGIN_ALLOWED_TOP_LEVEL_FIELDS.has(field)) {
            issues.push(`top-level field "${field}" is not part of Agent Plugins v1.0.0`);
          }
        }
      }
      if (manifest && typeof manifest === "object" && !Array.isArray(manifest)) {
        issues.push(...validateAgentPluginManifest(manifest).map((error) => `schema validation: ${error}`));
      }
      if (issues.length === 0) {
        return {
          status: "pass",
          output: `Agent Plugins v1.0.0 manifest checks passed for ${path.relative(pluginRoot, pluginJsonPath) || "plugin.json"}.`,
        };
      }
      return {
        status: "warning",
        output: [
          "Agent Plugins v1.0.0 manifest warnings:",
          ...issues.map((issue) => `- ${issue}`),
        ].join("\n"),
      };
 }
 function buildVallyLintArgs(pluginRoot) {
  const pluginJsonPath = findPluginJson(pluginRoot);
  if (!pluginJsonPath) {
@@ -827,6 +963,7 @@ export async function runExternalPluginQualityGates(plugin) {
    overall_status: "not_run",
    vally_lint_status: "not_run",
    smoke_status: "not_run",
    spec_compliance_status: "not_run",
    version_match_status: "not_run",
    ref_sha_consistency_status: "not_run",
    canvas_structure_status: "not_run",
@@ -834,6 +971,7 @@ export async function runExternalPluginQualityGates(plugin) {
    summary: "",
    vally_lint_output: "",
    smoke_output: "",
    spec_compliance_output: "",
    version_match_output: "",
    ref_sha_consistency_output: "",
    canvas_structure_output: "",
@@ -847,12 +985,14 @@ export async function runExternalPluginQualityGates(plugin) {
    if (!fs.existsSync(pluginRoot) || !fs.statSync(pluginRoot).isDirectory()) {
      result.vally_lint_status = "fail";
      result.smoke_status = "fail";
      result.spec_compliance_status = "warning";
      result.version_match_status = "fail";
      result.ref_sha_consistency_status = "not_run";
      result.canvas_structure_status = hasCanvasKeyword(plugin) ? "fail" : "not_run";
      result.overall_status = "fail";
      result.failure_class = "submitter_fixes";
      result.summary = `Plugin path "${plugin.source?.path || "/"}" was not found in the submitted repository snapshot.`;
      result.spec_compliance_output = result.summary;
      result.version_match_output = result.summary;
      if (hasCanvasKeyword(plugin)) {
        result.canvas_structure_output = result.summary;
@@ -860,6 +1000,10 @@ export async function runExternalPluginQualityGates(plugin) {
      return result;
    }
    const specResult = inspectAgentPluginSpecCompliance(pluginRoot);
    result.spec_compliance_status = specResult.status;
    result.spec_compliance_output = specResult.output;
    const versionMatchResult = runVersionMatchGate(repoDir, plugin, fetchSpec);
    result.version_match_status = versionMatchResult.status;
    result.version_match_output = versionMatchResult.output;
@@ -889,6 +1033,7 @@ export async function runExternalPluginQualityGates(plugin) {
    ]);
    result.failure_class = toFailureClass(result.overall_status);
    result.summary = [
      `- spec compliance: ${result.spec_compliance_status}`,
      `- vally lint: ${result.vally_lint_status}`,
      `- install smoke test: ${result.smoke_status}`,
      `- version match: ${result.version_match_status}`,
@@ -2,11 +2,11 @@
 import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
 import { ROOT_FOLDER } from "./constants.mjs";
 import { readExternalPlugins } from "./external-plugin-validation.mjs";
 const PLUGINS_DIR = path.join(ROOT_FOLDER, "plugins");
 const EXTENSIONS_DIR = path.join(ROOT_FOLDER, "extensions");
 const MARKETPLACE_FILE = path.join(ROOT_FOLDER, ".github/plugin", "marketplace.json");
 /**
@@ -15,7 +15,7 @@ const MARKETPLACE_FILE = path.join(ROOT_FOLDER, ".github/plugin", "marketplace.j
 * @returns {object|null} - Plugin metadata or null if not found
 */
 function readPluginMetadata(pluginDir) {
-  const pluginJsonPath = path.join(pluginDir, ".github/plugin", "plugin.json");
+  const pluginJsonPath = path.join(pluginDir, "plugin.json");
  if (!fs.existsSync(pluginJsonPath)) {
    console.warn(`Warning: No plugin.json found for ${path.basename(pluginDir)}`);
@@ -62,35 +62,18 @@ function collectLocalPluginsFromRoot(rootDir, sourcePrefix, includeEntry = () =>
  return plugins;
 }
 function hasExtensionEntryPoint(extensionDir, extensionName) {
  const candidateEntryPoints = [
    path.join(extensionDir, "extension.mjs"),
    path.join(extensionDir, "extensions", "extension.mjs"),
    path.join(extensionDir, "extensions", extensionName, "extension.mjs"),
  ];
  return candidateEntryPoints.some((entryPointPath) => fs.existsSync(entryPointPath));
 }
 /**
 * Generate marketplace.json from plugin directories
 */
-function generateMarketplace() {
+export function generateMarketplace() {
  console.log("Generating marketplace.json...");
-  if (!fs.existsSync(PLUGINS_DIR) && !fs.existsSync(EXTENSIONS_DIR)) {
+  if (!fs.existsSync(PLUGINS_DIR)) {
-    console.error(`Error: Neither plugins directory (${PLUGINS_DIR}) nor extensions directory (${EXTENSIONS_DIR}) was found`);
+    console.error(`Error: Plugins directory (${PLUGINS_DIR}) was not found`);
    process.exit(1);
  }
-  const plugins = [
+  const plugins = collectLocalPluginsFromRoot(PLUGINS_DIR, "plugins");
    ...collectLocalPluginsFromRoot(PLUGINS_DIR, "plugins"),
    ...collectLocalPluginsFromRoot(
      EXTENSIONS_DIR,
      "extensions",
      (entryName) => hasExtensionEntryPoint(path.join(EXTENSIONS_DIR, entryName), entryName)
    )
  ];
  console.log(`Found ${plugins.length} local plugin manifests`);
@@ -144,5 +127,6 @@ function generateMarketplace() {
  console.log(`  Location: ${MARKETPLACE_FILE}`);
 }
-// Run the script
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-generateMarketplace();
+  generateMarketplace();
 }
@@ -540,8 +540,6 @@ function resolvePluginItem(item, resourceIndex) {
 */
 function generatePluginsData(gitDates, resourceIndex = {}) {
  const plugins = [];
  const extensionEntriesByName = new Map();
  if (!fs.existsSync(PLUGINS_DIR)) {
    return { items: [], filters: { tags: [] } };
  }
@@ -550,85 +548,30 @@ function generatePluginsData(gitDates, resourceIndex = {}) {
    .readdirSync(PLUGINS_DIR, { withFileTypes: true })
    .filter((d) => d.isDirectory());
  if (fs.existsSync(EXTENSIONS_DIR)) {
    const extensionDirs = fs.readdirSync(EXTENSIONS_DIR, { withFileTypes: true })
      .filter((entry) => {
        if (!entry.isDirectory()) return false;
        return hasExtensionEntryPoint(path.join(EXTENSIONS_DIR, entry.name), entry.name);
      })
      .map((entry) => entry.name)
      .sort((a, b) => a.localeCompare(b));
    for (const extensionDirName of extensionDirs) {
      const extensionDir = path.join(EXTENSIONS_DIR, extensionDirName);
      const pluginJsonPath = path.join(extensionDir, ".github", "plugin", "plugin.json");
      if (!fs.existsSync(pluginJsonPath)) {
        continue;
      }
      try {
        const extensionPlugin = JSON.parse(fs.readFileSync(pluginJsonPath, "utf-8"));
        const pluginName = normalizeText(extensionPlugin.name, extensionDirName);
        const pluginDescription = normalizeText(extensionPlugin.description, "Canvas extension");
        const extensionKeywords = Array.isArray(extensionPlugin.keywords)
          ? [...new Set(extensionPlugin.keywords.filter((keyword) => typeof keyword === "string").map((keyword) => keyword.trim()).filter(Boolean))].sort((a, b) => a.localeCompare(b))
          : [];
        const relPath = `extensions/${extensionDirName}`;
        const extensionItem = resolvePluginItem(
          {
            kind: "extension",
            path: relPath,
          },
          resourceIndex
        );
        const extReadmePath = path.join(extensionDir, "README.md");
        const extReadmeFile = fs.existsSync(extReadmePath)
          ? `${relPath}/README.md`
          : null;
        extensionEntriesByName.set(pluginName, {
          id: pluginName,
          name: pluginName,
          description: pluginDescription,
          path: relPath,
          readmeFile: extReadmeFile,
          version: normalizeText(extensionPlugin.version, null),
          tags: extensionKeywords,
          itemCount: 1,
          items: [extensionItem],
          generatedFromExtension: true,
          lastUpdated: getDirectoryLastUpdated(gitDates, relPath),
          searchText: `${pluginName} ${pluginDescription} ${extensionKeywords.join(" ")} canvas extension`.toLowerCase(),
        });
      } catch (e) {
        console.warn(`Failed to parse extension plugin manifest for ${extensionDirName}: ${e.message}`);
      }
    }
  }
  for (const dir of pluginDirs) {
    const pluginDir = path.join(PLUGINS_DIR, dir.name);
-    const jsonPath = path.join(pluginDir, ".github/plugin", "plugin.json");
+    const jsonPath = path.join(pluginDir, "plugin.json");
    if (!fs.existsSync(jsonPath)) continue;
    try {
      const data = JSON.parse(fs.readFileSync(jsonPath, "utf-8"));
      const relPath = `plugins/${dir.name}`;
-      const extensionRefs = Array.isArray(data?.["x-awesome-copilot"]?.extensions)
+      const composition = data.extensions?.["com.github.awesome-copilot"] ?? {};
-        ? data["x-awesome-copilot"].extensions
+      const extensionRefs = composition.extensions
-        : [];
+        ?.map((entry) => entry.replace(/^\.\/extensions\//, "").replace(/\/$/, ""))
        .filter(Boolean) ?? [];
      if (fs.existsSync(path.join(EXTENSIONS_DIR, dir.name, "extension.mjs")) && !extensionRefs.includes(dir.name)) {
        extensionRefs.push(dir.name);
      }
      const extensionItems = extensionRefs
-        .map((entry) => normalizeText(entry))
+        .filter((entry) => typeof entry === "string")
        .filter(Boolean)
        .map((entry) => entry.replace(/^\.\/+/, "").replace(/\/$/, ""))
        .filter((entry) => entry.startsWith("extensions/"))
        .map((entry) => ({
          kind: "extension",
-          path: entry,
+          path: `extensions/${entry}`,
        }));
-      const agentItems = (data.agents || []).flatMap((agent) => {
+      const agentItems = (composition.agents || []).flatMap((agent) => {
        const agentPath = agent.replace("./", "");
        const fullPath = path.join(pluginDir, agentPath);
@@ -646,11 +589,11 @@ function generatePluginsData(gitDates, resourceIndex = {}) {
      // Parse mcpServers: supports a path to a .mcp.json file or an inline object
      const mcpItems = [];
-      if (data.mcpServers) {
+      if (composition.mcpServers) {
        let mcpServersObj = null;
        let mcpConfigPath = relPath;
-        if (typeof data.mcpServers === "string") {
+        if (typeof composition.mcpServers === "string") {
-          const manifestMcpPath = data.mcpServers.replace(/^\.\//, "");
+          const manifestMcpPath = composition.mcpServers.replace(/^\.\//, "");
          mcpConfigPath = manifestMcpPath ? `${relPath}/${manifestMcpPath}` : relPath;
          const mcpJsonPath = path.join(pluginDir, manifestMcpPath);
          if (fs.existsSync(mcpJsonPath)) {
@@ -661,8 +604,8 @@ function generatePluginsData(gitDates, resourceIndex = {}) {
              // ignore parse errors
            }
          }
-        } else if (typeof data.mcpServers === "object") {
+        } else if (typeof composition.mcpServers === "object") {
-          mcpServersObj = data.mcpServers;
+          mcpServersObj = composition.mcpServers;
        }
        if (mcpServersObj) {
          for (const serverName of Object.keys(mcpServersObj)) {
@@ -674,8 +617,8 @@ function generatePluginsData(gitDates, resourceIndex = {}) {
      // Build items list from spec fields (agents, commands, skills, mcpServers)
      const items = [
        ...agentItems,
-        ...(data.commands || []).map((p) => ({ kind: "prompt", path: p })),
+        ...(composition.commands || []).map((p) => ({ kind: "prompt", path: p })),
-        ...(data.skills || []).map((p) => ({ kind: "skill", path: p })),
+        ...(composition.skills || []).map((p) => ({ kind: "skill", path: p })),
        ...extensionItems,
        ...mcpItems,
      ].map((item) => resolvePluginItem(item, resourceIndex));
@@ -702,16 +645,11 @@ function generatePluginsData(gitDates, resourceIndex = {}) {
        searchText: `${pluginName} ${data.description || ""
          } ${tags.join(" ")}`.toLowerCase(),
      });
      extensionEntriesByName.delete(pluginName);
    } catch (e) {
      console.warn(`Failed to parse plugin: ${dir.name}`, e.message);
    }
  }
  for (const extensionPlugin of extensionEntriesByName.values()) {
    plugins.push(extensionPlugin);
  }
  // Load external plugins from plugins/external.json
  const externalJsonPath = path.join(PLUGINS_DIR, "external.json");
  if (fs.existsSync(externalJsonPath)) {
@@ -1204,15 +1142,13 @@ function resolveExtensionScreenshots(pluginJson, extensionDir, relPath, ref) {
    }
    : null;
-  const logoEntry = normalizeExtensionScreenshotRole(pluginJson?.logo, relPath, ref);
+  const copilotNs = pluginJson?.extensions?.["com.github.copilot"];
-  const screenshotConfig = pluginJson?.["x-awesome-copilot"]?.screenshots || {};
+  const logoEntry = normalizeExtensionScreenshotRole(
-  const iconEntry = normalizeExtensionScreenshotRole(screenshotConfig.icon, relPath, ref);
+    copilotNs?.logo ?? pluginJson?.logo,
-  const galleryRaw = screenshotConfig.gallery;
+    relPath, ref
-  const firstGalleryEntry = Array.isArray(galleryRaw) ? galleryRaw[0] : galleryRaw;
+  );
-  const galleryEntry = normalizeExtensionScreenshotRole(firstGalleryEntry, relPath, ref);
+  const finalIcon = logoEntry || inferredIcon;
-
+  const finalGallery = logoEntry || inferredGallery || finalIcon;
  const finalIcon = iconEntry || logoEntry || inferredIcon;
  const finalGallery = galleryEntry || logoEntry || inferredGallery || finalIcon;
  return {
    screenshots: {
@@ -1256,7 +1192,7 @@ function generateCanvasManifest(gitDates, commitSha) {
    const packageJson = fs.existsSync(packageJsonPath)
      ? JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"))
      : {};
-    const pluginJsonPath = path.join(extensionDir, ".github", "plugin", "plugin.json");
+    const pluginJsonPath = path.join(PLUGINS_DIR, dir.name, "plugin.json");
    const pluginJson = fs.existsSync(pluginJsonPath)
      ? JSON.parse(fs.readFileSync(pluginJsonPath, "utf-8"))
      : {};
@@ -7,6 +7,8 @@ import { ROOT_FOLDER } from "./constants.mjs";
 const PLUGINS_DIR = path.join(ROOT_FOLDER, "plugins");
 const EXTENSIONS_DIR = path.join(ROOT_FOLDER, "extensions");
 const COPILOT_NAMESPACE = "com.github.copilot";
 const AWESOME_COPILOT_NAMESPACE = "com.github.awesome-copilot";
 /**
 * Recursively copy a directory.
@@ -24,36 +26,6 @@ function copyDirRecursive(src, dest) {
  }
 }
 function moveEntry(srcPath, destPath) {
  fs.mkdirSync(path.dirname(destPath), { recursive: true });
  try {
    fs.renameSync(srcPath, destPath);
    return;
  } catch (error) {
    if (error?.code !== "EXDEV") {
      throw error;
    }
  }
  const stats = fs.statSync(srcPath);
  if (stats.isDirectory()) {
    copyDirRecursive(srcPath, destPath);
    fs.rmSync(srcPath, { recursive: true, force: true });
    return;
  }
  fs.copyFileSync(srcPath, destPath);
  fs.rmSync(srcPath, { force: true });
 }
 function isRelativeAssetPath(assetPath) {
  return typeof assetPath === "string" &&
    assetPath.length > 0 &&
    !/^(?:[a-z][a-z0-9+.-]*:)?\/\//i.test(assetPath) &&
    !assetPath.startsWith("data:") &&
    !path.isAbsolute(assetPath);
 }
 /**
 * Resolve a plugin-relative path to the repo-root source file.
 *
@@ -74,63 +46,34 @@ function resolveSource(relPath) {
    const extensionName = relPath.replace(/^\.\/extensions\//, "").replace(/\/$/, "");
    return path.join(ROOT_FOLDER, "extensions", extensionName);
  }
  if (relPath.startsWith("./hooks/")) {
    return path.join(ROOT_FOLDER, "hooks", relPath.replace(/^\.\/hooks\//, ""));
  }
  if (relPath.startsWith("./commands/")) {
    return path.join(ROOT_FOLDER, "commands", relPath.replace(/^\.\/commands\//, ""));
  }
  return null;
 }
-export function materializeExtensionPlugin(extensionPath) {
+function readExtensionReferences(metadata, pluginName) {
-  const pluginJsonPath = path.join(extensionPath, ".github", "plugin", "plugin.json");
+  const extensionData = metadata.extensions?.[AWESOME_COPILOT_NAMESPACE];
-  if (!fs.existsSync(pluginJsonPath)) {
+  const directories = extensionData?.extensions ?? [];
-    return { movedEntries: 0, manifestUpdated: false, skipped: true };
+  if (!Array.isArray(directories) ||
      directories.some((entry) => typeof entry !== "string" || !entry.startsWith("./extensions/"))) {
    throw new Error(`extensions["${AWESOME_COPILOT_NAMESPACE}"].extensions must contain plugin-relative paths`);
  }
-  let metadata;
+  const names = new Set(directories.map((entry) =>
-  try {
+    entry.replace(/^\.\/extensions\//, "").replace(/\/$/, "")
-    metadata = JSON.parse(fs.readFileSync(pluginJsonPath, "utf8"));
+  ));
-  } catch (err) {
+  if (fs.existsSync(path.join(EXTENSIONS_DIR, pluginName, "extension.mjs"))) {
-    throw new Error(`Failed to parse ${pluginJsonPath}: ${err.message}`);
+    names.add(pluginName);
  }
-  const extensionContainerPath = path.join(extensionPath, "extensions");
+  return [...names].sort();
  const extensionBundlePath = path.join(extensionContainerPath, path.basename(extensionPath));
  fs.rmSync(extensionContainerPath, { recursive: true, force: true });
  fs.mkdirSync(extensionBundlePath, { recursive: true });
  let movedEntries = 0;
  for (const entry of fs.readdirSync(extensionPath, { withFileTypes: true })) {
    if (entry.name === ".github" || entry.name === "extensions") {
      continue;
    }
    moveEntry(
      path.join(extensionPath, entry.name),
      path.join(extensionBundlePath, entry.name)
    );
    movedEntries++;
  }
  if (isRelativeAssetPath(metadata.logo)) {
    const normalizedLogoPath = metadata.logo.replace(/\\/g, "/").replace(/^\.\//, "");
    const bundledLogoPath = path.join(extensionBundlePath, normalizedLogoPath);
    if (fs.existsSync(bundledLogoPath)) {
      const rootLogoPath = path.join(extensionPath, normalizedLogoPath);
      fs.mkdirSync(path.dirname(rootLogoPath), { recursive: true });
      fs.copyFileSync(bundledLogoPath, rootLogoPath);
    }
  }
  let manifestUpdated = false;
  if (metadata.extensions !== "extensions") {
    metadata.extensions = "extensions";
    manifestUpdated = true;
  }
  if (manifestUpdated) {
    fs.writeFileSync(pluginJsonPath, JSON.stringify(metadata, null, 2) + "\n", "utf8");
  }
  return { movedEntries, manifestUpdated, skipped: false };
 }
-function materializePlugins() {
+export function materializePlugins() {
  console.log("Materializing plugin files...\n");
  if (!fs.existsSync(PLUGINS_DIR)) {
@@ -146,14 +89,12 @@ function materializePlugins() {
  let totalAgents = 0;
  let totalSkills = 0;
  let totalExtensions = 0;
  let totalExtensionPlugins = 0;
  let totalExtensionPluginEntries = 0;
  let warnings = 0;
  let errors = 0;
  for (const dirName of pluginDirs) {
    const pluginPath = path.join(PLUGINS_DIR, dirName);
-    const pluginJsonPath = path.join(pluginPath, ".github/plugin", "plugin.json");
+    const pluginJsonPath = path.join(pluginPath, "plugin.json");
    if (!fs.existsSync(pluginJsonPath)) {
      continue;
@@ -170,52 +111,37 @@ function materializePlugins() {
    const pluginName = metadata.name || dirName;
-    // Process agents
+    const composition = metadata.extensions?.[AWESOME_COPILOT_NAMESPACE] ?? {};
-    if (Array.isArray(metadata.agents)) {
+
-      for (const relPath of metadata.agents) {
+    // Process repository composition fields.
    for (const field of ["agents", "commands", "hooks", "skills"]) {
      const entries = composition[field];
      if (!Array.isArray(entries)) continue;
      for (const relPath of entries) {
        const src = resolveSource(relPath);
        if (!src) {
-          console.warn(`  ⚠ ${pluginName}: Unknown path format: ${relPath}`);
+          console.warn(`  ⚠ ${pluginName}: Unknown ${field} path format: ${relPath}`);
          warnings++;
          continue;
        }
        if (!fs.existsSync(src)) {
-          console.warn(`  ⚠ ${pluginName}: Source not found: ${src}`);
+          console.warn(`  ⚠ ${pluginName}: ${field} source not found: ${src}`);
          warnings++;
          continue;
        }
        const dest = path.join(pluginPath, relPath.replace(/^\.\//, ""));
        fs.mkdirSync(path.dirname(dest), { recursive: true });
        fs.copyFileSync(src, dest);
        totalAgents++;
      }
    }
    // Process skills
    if (Array.isArray(metadata.skills)) {
      for (const relPath of metadata.skills) {
        const src = resolveSource(relPath);
        if (!src) {
          console.warn(`  ⚠ ${pluginName}: Unknown path format: ${relPath}`);
          warnings++;
          continue;
        }
        if (!fs.existsSync(src) || !fs.statSync(src).isDirectory()) {
          console.warn(`  ⚠ ${pluginName}: Source directory not found: ${src}`);
          warnings++;
          continue;
        }
        const dest = path.join(pluginPath, relPath.replace(/^\.\//, "").replace(/\/$/, ""));
-        copyDirRecursive(src, dest);
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
-        totalSkills++;
+        if (fs.statSync(src).isDirectory()) copyDirRecursive(src, dest);
        else fs.copyFileSync(src, dest);
        if (field === "agents") totalAgents++;
        if (field === "skills") totalSkills++;
      }
    }
-    // Process extension references from x-awesome-copilot.extensions
+    // Process reusable extensions declared in the repository namespace.
-    const extensionRefs = Array.isArray(metadata?.["x-awesome-copilot"]?.extensions)
+    const extensionRefs = readExtensionReferences(metadata, pluginName);
-      ? metadata["x-awesome-copilot"].extensions
+    for (const extensionName of extensionRefs) {
-      : [];
+      const relPath = `./extensions/${extensionName}`;
    for (const relPath of extensionRefs) {
      const src = resolveSource(relPath);
      if (!src) {
        console.warn(`  ⚠ ${pluginName}: Unknown extension path format: ${relPath}`);
@@ -227,81 +153,47 @@ function materializePlugins() {
        warnings++;
        continue;
      }
-      const dest = path.join(pluginPath, relPath.replace(/^\.\//, "").replace(/\/$/, ""));
+      // Extensions are conventional plugin content and belong under the
      // plugin's top-level extensions directory, not the client namespace.
      const dest = path.join(pluginPath, "extensions", extensionName);
      copyDirRecursive(src, dest);
      totalExtensions++;
    }
-    // Rewrite plugin.json to use folder paths instead of individual file paths.
+    // Emit a spec-compliant served manifest for the marketplace branch.
-    // On staged, paths like ./agents/foo.md point to individual source files.
+    // Source manifests keep composition fields (agents and skills)
-    // On main, after materialization, we only need the containing directory.
+    // for build tooling. The served manifest retains only Agent Plugins v1.0.0 fields
-    const rewritten = { ...metadata };
+    // so the runtime uses conventional directory discovery for all content.
-    let changed = false;
+    const SPEC_FIELDS = new Set(["$schema", "name", "version", "description", "author",
      "homepage", "repository", "license", "keywords", "extensions"]);
    const AGENT_PLUGINS_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
-    for (const field of ["agents", "commands"]) {
+    const served = { "$schema": AGENT_PLUGINS_SCHEMA };
-      if (Array.isArray(rewritten[field]) && rewritten[field].length > 0) {
+    for (const [key, val] of Object.entries(metadata)) {
-        const dirs = [...new Set(rewritten[field].map(p => path.dirname(p)))];
+      if (SPEC_FIELDS.has(key) && key !== "$schema") {
-        rewritten[field] = dirs;
+        if (key === "extensions") {
-        changed = true;
+          const copilot = val?.[COPILOT_NAMESPACE];
          if (copilot) {
            served.extensions = { [COPILOT_NAMESPACE]: { ...copilot } };
          }
        } else {
          served[key] = val;
        }
      }
    }
-    if (Array.isArray(rewritten.skills) && rewritten.skills.length > 0) {
+    fs.writeFileSync(pluginJsonPath, JSON.stringify(served, null, 2) + "\n", "utf8");
      // Skills are already folder refs (./skills/name/); strip trailing slash
      rewritten.skills = rewritten.skills.map(p => p.replace(/\/$/, ""));
      changed = true;
    }
    if (Array.isArray(rewritten?.["x-awesome-copilot"]?.extensions) &&
      rewritten["x-awesome-copilot"].extensions.length > 0) {
      rewritten["x-awesome-copilot"].extensions =
        rewritten["x-awesome-copilot"].extensions.map((p) => p.replace(/\/$/, ""));
      changed = true;
    }
    if (changed) {
      fs.writeFileSync(pluginJsonPath, JSON.stringify(rewritten, null, 2) + "\n", "utf8");
    }
    const counts = [];
-    if (metadata.agents?.length) counts.push(`${metadata.agents.length} agents`);
+    if (composition.agents?.length) counts.push(`${composition.agents.length} agents`);
-    if (metadata.skills?.length) counts.push(`${metadata.skills.length} skills`);
+    if (composition.skills?.length) counts.push(`${composition.skills.length} skills`);
    if (extensionRefs.length) counts.push(`${extensionRefs.length} extensions`);
    if (counts.length) {
      console.log(`✓ ${pluginName}: ${counts.join(", ")}`);
    }
  }
-  if (fs.existsSync(EXTENSIONS_DIR)) {
+  console.log(`\nDone. Copied ${totalAgents} agents, ${totalSkills} skills, ${totalExtensions} extensions.`);
    const extensionDirs = fs.readdirSync(EXTENSIONS_DIR, { withFileTypes: true })
      .filter((entry) => entry.isDirectory())
      .map((entry) => entry.name)
      .sort();
    for (const dirName of extensionDirs) {
      const extensionPath = path.join(EXTENSIONS_DIR, dirName);
      if (!fs.existsSync(path.join(extensionPath, "extension.mjs"))) {
        continue;
      }
      try {
        const result = materializeExtensionPlugin(extensionPath);
        if (result.skipped) {
          continue;
        }
        totalExtensionPlugins++;
        totalExtensionPluginEntries += result.movedEntries;
        console.log(`✓ ${dirName}: materialized extension bundle into ./extensions (${result.movedEntries} entries)`);
      } catch (err) {
        console.error(`Error: Failed to materialize extension plugin ${dirName}: ${err.message}`);
        errors++;
      }
    }
  }
  console.log(`\nDone. Copied ${totalAgents} agents, ${totalSkills} skills, ${totalExtensions} plugin extension refs.`);
  console.log(`Materialized ${totalExtensionPlugins} extension plugins (${totalExtensionPluginEntries} top-level entries).`);
  if (warnings > 0) {
    console.log(`${warnings} warning(s).`);
  }
@@ -311,8 +203,6 @@ function materializePlugins() {
  }
 }
 export { materializePlugins };
 if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
  materializePlugins();
 }
@@ -1,89 +1,9 @@
 import assert from "node:assert/strict";
-import fs from "fs";
+import { test } from "node:test";
-import os from "os";
+import { materializePlugins } from "./materialize-plugins.mjs";
-import path from "path";
+import { generateMarketplace } from "./generate-marketplace.mjs";
 import { after, test } from "node:test";
 import { materializeExtensionPlugin } from "./materialize-plugins.mjs";
 import { cleanMaterializedExtensionPlugin } from "./clean-materialized-plugins.mjs";
-const tempDirs = [];
+test("build scripts expose callable APIs without running on import", () => {
-
+  assert.equal(typeof materializePlugins, "function");
-after(() => {
+  assert.equal(typeof generateMarketplace, "function");
  for (const dir of tempDirs) {
    fs.rmSync(dir, { recursive: true, force: true });
  }
 });
 test("materializeExtensionPlugin writes extension bundles to ./extensions and preserves root logo assets", () => {
  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "materialize-extension-plugin-"));
  tempDirs.push(tempDir);
  const pluginDir = path.join(tempDir, "extension-plugin");
  fs.mkdirSync(path.join(pluginDir, ".github", "plugin"), { recursive: true });
  fs.mkdirSync(path.join(pluginDir, "assets"), { recursive: true });
  fs.writeFileSync(path.join(pluginDir, ".github", "plugin", "plugin.json"), JSON.stringify({
    name: "test-extension-plugin",
    description: "test plugin",
    version: "1.0.0",
    logo: "assets/preview.png",
    extensions: ".",
  }, null, 2));
  fs.writeFileSync(path.join(pluginDir, "extension.mjs"), "export default {};\n");
  fs.writeFileSync(path.join(pluginDir, "README.md"), "# test\n");
  fs.writeFileSync(path.join(pluginDir, "assets", "preview.png"), "fake-image-bytes");
  const result = materializeExtensionPlugin(pluginDir);
  const bundleRoot = path.join(pluginDir, "extensions", "extension-plugin");
  assert.equal(result.skipped, false);
  assert.equal(result.manifestUpdated, true);
  assert.equal(result.movedEntries, 3);
  assert.equal(fs.existsSync(path.join(bundleRoot, "extension.mjs")), true);
  assert.equal(fs.existsSync(path.join(bundleRoot, "assets", "preview.png")), true);
  assert.equal(fs.existsSync(path.join(bundleRoot, "README.md")), true);
  assert.equal(fs.existsSync(path.join(pluginDir, "extensions", ".github")), false);
  assert.equal(fs.existsSync(path.join(pluginDir, "extension.mjs")), false);
  assert.equal(fs.existsSync(path.join(pluginDir, "README.md")), false);
  assert.equal(fs.existsSync(path.join(pluginDir, "assets", "preview.png")), true);
  const pluginManifest = JSON.parse(
    fs.readFileSync(path.join(pluginDir, ".github", "plugin", "plugin.json"), "utf8")
  );
  assert.equal(pluginManifest.extensions, "extensions");
  assert.equal(pluginManifest.logo, "assets/preview.png");
 });
 test("cleanMaterializedExtensionPlugin restores moved extension files to root", () => {
  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "clean-materialized-extension-plugin-"));
  tempDirs.push(tempDir);
  const pluginDir = path.join(tempDir, "extension-plugin");
  fs.mkdirSync(path.join(pluginDir, ".github", "plugin"), { recursive: true });
  fs.mkdirSync(path.join(pluginDir, "assets"), { recursive: true });
  fs.writeFileSync(path.join(pluginDir, ".github", "plugin", "plugin.json"), JSON.stringify({
    name: "test-extension-plugin",
    description: "test plugin",
    version: "1.0.0",
    logo: "assets/preview.png",
    extensions: ".",
  }, null, 2));
  fs.writeFileSync(path.join(pluginDir, "extension.mjs"), "export default {};\n");
  fs.writeFileSync(path.join(pluginDir, "README.md"), "# test\n");
  fs.writeFileSync(path.join(pluginDir, "assets", "preview.png"), "fake-image-bytes");
  materializeExtensionPlugin(pluginDir);
  const result = cleanMaterializedExtensionPlugin(pluginDir);
  assert.equal(result.removed, 3);
  assert.equal(result.manifestUpdated, true);
  assert.equal(fs.existsSync(path.join(pluginDir, "extension.mjs")), true);
  assert.equal(fs.existsSync(path.join(pluginDir, "README.md")), true);
  assert.equal(fs.existsSync(path.join(pluginDir, "assets", "preview.png")), true);
  assert.equal(fs.existsSync(path.join(pluginDir, "extensions")), false);
  const pluginManifest = JSON.parse(
    fs.readFileSync(path.join(pluginDir, ".github", "plugin", "plugin.json"), "utf8")
  );
  assert.equal(pluginManifest.extensions, ".");
  assert.equal(pluginManifest.logo, "assets/preview.png");
 });
@@ -29,6 +29,7 @@ import {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const EXTENSIONS_DIR = path.join(ROOT_FOLDER, "extensions");
 // Cache of MCP registry server names (lower-cased) fetched from the API
 let MCP_REGISTRY_SET = null;
@@ -715,7 +716,7 @@ function generateUnifiedModeSection(cfg) {
 * Read and parse a plugin.json file from a plugin directory.
 */
 function readPluginJson(pluginDir) {
-  const jsonPath = path.join(pluginDir, ".github/plugin", "plugin.json");
+  const jsonPath = path.join(pluginDir, "plugin.json");
  if (!fs.existsSync(jsonPath)) return null;
  try {
    return JSON.parse(fs.readFileSync(jsonPath, "utf-8"));
@@ -786,10 +787,23 @@ function generatePluginsSection(pluginsDir) {
  for (const entry of sortedEntries) {
    const { plugin, dir, name, isFeatured } = entry;
    const description = formatTableCell(plugin.description || "No description");
    const composition = plugin.extensions?.["com.github.awesome-copilot"] || {};
    const extensionReferences = Array.isArray(composition.extensions)
      ? composition.extensions.length
      : 0;
    const implicitExtension =
      fs.existsSync(path.join(EXTENSIONS_DIR, entry.pluginId, "extension.mjs")) &&
      !(Array.isArray(composition.extensions) && composition.extensions.some(
        (reference) => reference === `./extensions/${entry.pluginId}`
      ))
      ? 1
      : 0;
    const itemCount =
-      (plugin.agents || []).length +
+      (composition.agents || []).length +
-      (plugin.commands || []).length +
+      (composition.commands || []).length +
-      (plugin.skills || []).length;
+      (composition.skills || []).length +
      extensionReferences +
      implicitExtension;
    const keywords = plugin.keywords ? plugin.keywords.join(", ") : "";
    const link = `../plugins/${dir}/README.md`;
@@ -842,10 +856,23 @@ function generateFeaturedPluginsSection(pluginsDir) {
            plugin.description || "No description"
          );
          const keywords = plugin.keywords ? plugin.keywords.join(", ") : "";
          const composition = plugin.extensions?.["com.github.awesome-copilot"] || {};
          const extensionReferences = Array.isArray(composition.extensions)
            ? composition.extensions.length
            : 0;
          const implicitExtension =
            fs.existsSync(path.join(EXTENSIONS_DIR, name, "extension.mjs")) &&
            !(Array.isArray(composition.extensions) && composition.extensions.some(
              (reference) => reference === `./extensions/${name}`
            ))
            ? 1
            : 0;
          const itemCount =
-            (plugin.agents || []).length +
+            (composition.agents || []).length +
-            (plugin.commands || []).length +
+            (composition.commands || []).length +
-            (plugin.skills || []).length;
+            (composition.skills || []).length +
            extensionReferences +
            implicitExtension;
          return {
            dir,
@@ -5,10 +5,15 @@ import path from "path";
 import { ROOT_FOLDER } from "./constants.mjs";
 import { readExternalPlugins } from "./external-plugin-validation.mjs";
 import { validateLicenseField } from "./lib/license.mjs";
 import { AGENT_PLUGIN_SCHEMA_URL, validateAgentPluginManifest } from "./agent-plugin-schema.mjs";
 const PLUGINS_DIR = path.join(ROOT_FOLDER, "plugins");
 const EXTENSIONS_DIR = path.join(ROOT_FOLDER, "extensions");
 const AGENT_PLUGINS_SCHEMA = AGENT_PLUGIN_SCHEMA_URL;
 const COPILOT_NAMESPACE = "com.github.copilot";
 const AWESOME_COPILOT_NAMESPACE = "com.github.awesome-copilot";
 // Validation functions
 function validateName(name, folderName) {
  const errors = [];
@@ -16,11 +21,11 @@ function validateName(name, folderName) {
    errors.push("name is required and must be a string");
    return errors;
  }
-  if (name.length < 1 || name.length > 50) {
+  if (name.length < 1 || name.length > 64) {
-    errors.push("name must be between 1 and 50 characters");
+    errors.push("name must be between 1 and 64 characters");
  }
-  if (!/^[a-z0-9-]+$/.test(name)) {
+  if (!/^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/.test(name)) {
-    errors.push("name must contain only lowercase letters, numbers, and hyphens");
+    errors.push("name must contain only lowercase letters, numbers, hyphens, and dots (spec §5.5)");
  }
  if (name !== folderName) {
    errors.push(`name "${name}" must match folder name "${folderName}"`);
@@ -28,6 +33,14 @@ function validateName(name, folderName) {
  return errors;
 }
 function validateSchema(parsed) {
  if (parsed["$schema"] !== AGENT_PLUGINS_SCHEMA) {
    return `$schema must be "${AGENT_PLUGINS_SCHEMA}"`;
  }
  const schemaErrors = validateAgentPluginManifest(parsed);
  return schemaErrors.length ? `manifest does not conform to Agent Plugins schema: ${schemaErrors.join("; ")}` : null;
 }
 function validateDescription(description) {
  if (!description || typeof description !== "string") {
    return "description is required and must be a string";
@@ -106,35 +119,40 @@ function validateSpecPaths(plugin) {
  const errors = [];
  const specs = {
    agents: { prefix: "./agents/", suffix: ".md", repoDir: "agents", repoSuffix: ".agent.md" },
    commands: { prefix: "./commands/", suffix: ".md", repoDir: "commands", repoSuffix: ".md" },
    hooks: { prefix: "./hooks/", suffix: "/", repoDir: "hooks", repoFile: "README.md" },
    skills: { prefix: "./skills/", suffix: "/", repoDir: "skills", repoFile: "SKILL.md" },
  };
  for (const [field, spec] of Object.entries(specs)) {
-    const arr = plugin[field];
+    const arr = plugin.extensions?.[AWESOME_COPILOT_NAMESPACE]?.[field];
    if (arr === undefined) continue;
    if (!Array.isArray(arr)) {
-      errors.push(`${field} must be an array`);
+      errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field} must be an array`);
      continue;
    }
    if (!arraysEqual(arr, sortPluginEntries(arr))) {
-      errors.push(`${field} must be sorted alphabetically`);
+      errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field} must be sorted alphabetically`);
    }
    if (new Set(arr).size !== arr.length) {
      errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field} must not contain duplicate references`);
    }
    for (let i = 0; i < arr.length; i++) {
      const p = arr[i];
      if (typeof p !== "string") {
-        errors.push(`${field}[${i}] must be a string`);
+        errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}[${i}] must be a string`);
        continue;
      }
      if (!p.startsWith("./")) {
-        errors.push(`${field}[${i}] must start with "./"`);
+        errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}[${i}] must start with "./"`);
        continue;
      }
      if (!p.startsWith(spec.prefix)) {
-        errors.push(`${field}[${i}] must start with "${spec.prefix}"`);
+        errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}[${i}] must start with "${spec.prefix}"`);
        continue;
      }
      if (!p.endsWith(spec.suffix)) {
-        errors.push(`${field}[${i}] must end with "${spec.suffix}"`);
+        errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}[${i}] must end with "${spec.suffix}"`);
        continue;
      }
      // Validate the source file exists at repo root
@@ -143,12 +161,16 @@ function validateSpecPaths(plugin) {
        const skillDir = path.join(ROOT_FOLDER, spec.repoDir, basename);
        const skillFile = path.join(skillDir, spec.repoFile);
        if (!fs.existsSync(skillFile)) {
-          errors.push(`${field}[${i}] source not found: ${spec.repoDir}/${basename}/SKILL.md`);
+          errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}[${i}] source not found: ${spec.repoDir}/${basename}/SKILL.md`);
        }
      } else {
-        const srcFile = path.join(ROOT_FOLDER, spec.repoDir, basename + spec.repoSuffix);
+        const srcFile = spec.repoFile
          ? path.join(ROOT_FOLDER, spec.repoDir, basename, spec.repoFile)
          : path.join(ROOT_FOLDER, spec.repoDir, basename + spec.repoSuffix);
        if (!fs.existsSync(srcFile)) {
-          errors.push(`${field}[${i}] source not found: ${spec.repoDir}/${basename}${spec.repoSuffix}`);
+          errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}[${i}] source not found`);
        } else if (field === "hooks" && !fs.existsSync(path.join(ROOT_FOLDER, spec.repoDir, basename, "hooks.json"))) {
          errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}[${i}] source not found: ${spec.repoDir}/${basename}/hooks.json`);
        }
      }
    }
@@ -156,41 +178,61 @@ function validateSpecPaths(plugin) {
  return errors;
 }
-function validateCuratedPluginExtensionRefs(plugin) {
+function validateExtensionReferences(plugin, pluginDir) {
  const errors = [];
-  const extensionRefs = plugin?.["x-awesome-copilot"]?.extensions;
+  const directories = plugin.extensions?.[AWESOME_COPILOT_NAMESPACE]?.extensions;
-  if (extensionRefs === undefined) {
+  if (directories === undefined) {
    return errors;
  }
  if (!Array.isArray(directories)) {
    errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].extensions must be an array`);
    return errors;
  }
  if (!arraysEqual(directories, sortPluginEntries(directories))) {
    errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].extensions entries must be sorted alphabetically`);
  }
  if (new Set(directories).size !== directories.length) {
    errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].extensions must not contain duplicate references`);
  }
  for (const [index, directory] of directories.entries()) {
    const name = typeof directory === "string"
      ? directory.replace(/^\.\/extensions\//, "").replace(/\/$/, "")
      : "";
    if (typeof directory !== "string" || !directory.startsWith("./extensions/") ||
        !/^[a-z0-9][a-z0-9.-]*[a-z0-9]$|^[a-z0-9]$/.test(name)) {
      errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].extensions[${index}] must be a valid ./extensions/<name> path`);
      continue;
    }
    if (!fs.existsSync(path.join(EXTENSIONS_DIR, name, "extension.mjs"))) {
      errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"].extensions[${index}] source not found: extensions/${name}`);
    }
  }
  return errors;
 }
 function validateCompositionNamespace(plugin) {
  const errors = [];
  const compositionFields = ["agents", "commands", "hooks", "mcpServers", "skills"];
  const extensions = plugin.extensions;
  const composition = extensions?.[AWESOME_COPILOT_NAMESPACE];
  if (extensions !== undefined &&
      (typeof extensions !== "object" || extensions === null || Array.isArray(extensions))) {
    errors.push(`extensions must be an object containing "${AWESOME_COPILOT_NAMESPACE}"`);
    return errors;
  }
-  if (!Array.isArray(extensionRefs)) {
+  if (composition !== undefined &&
-    errors.push('x-awesome-copilot.extensions must be an array');
+      (typeof composition !== "object" || composition === null || Array.isArray(composition))) {
    errors.push(`extensions["${AWESOME_COPILOT_NAMESPACE}"] must be an object`);
    return errors;
  }
-  if (!arraysEqual(extensionRefs, sortPluginEntries(extensionRefs))) {
+  for (const field of compositionFields) {
-    errors.push('x-awesome-copilot.extensions must be sorted alphabetically');
+    if (extensions?.[field] !== undefined) {
-  }
+      errors.push(`extensions.${field} must be moved to extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}`);
  const knownExtensions = new Set(getExtensionFolderNames());
  for (let i = 0; i < extensionRefs.length; i++) {
    const ref = extensionRefs[i];
    if (typeof ref !== "string") {
      errors.push(`x-awesome-copilot.extensions[${i}] must be a string`);
      continue;
    }
    if (!ref.startsWith("./extensions/")) {
      errors.push(`x-awesome-copilot.extensions[${i}] must start with "./extensions/"`);
      continue;
    }
    const normalized = ref.replace(/^\.\/extensions\//, "").replace(/\/$/, "");
    if (!normalized) {
      errors.push(`x-awesome-copilot.extensions[${i}] must include an extension folder name`);
      continue;
    }
    if (!knownExtensions.has(normalized)) {
      errors.push(`x-awesome-copilot.extensions[${i}] source not found: extensions/${normalized}`);
    }
  }
@@ -201,11 +243,13 @@ function validatePlugin(folderName) {
  const pluginDir = path.join(PLUGINS_DIR, folderName);
  const errors = [];
  let parsedPlugin = null;
  const extensionDir = path.join(EXTENSIONS_DIR, folderName);
  const isExtensionPlugin = fs.existsSync(path.join(extensionDir, "extension.mjs"));
-  // Rule 1: Must have .github/plugin/plugin.json
+  // Rule 1: Must have plugin.json at the plugin root
-  const pluginJsonPath = path.join(pluginDir, ".github/plugin", "plugin.json");
+  const pluginJsonPath = path.join(pluginDir, "plugin.json");
  if (!fs.existsSync(pluginJsonPath)) {
-    errors.push("missing required file: .github/plugin/plugin.json");
+    errors.push("missing required file: plugin.json");
    return errors;
  }
@@ -226,7 +270,11 @@ function validatePlugin(folderName) {
    return { errors, plugin: parsedPlugin };
  }
-  // Rule 3 & 4: name, description, version
+  // Rule 3: $schema required
  const schemaError = validateSchema(plugin);
  if (schemaError) errors.push(schemaError);
  // Rule 4 & 5: name, description, version
  const nameErrors = validateName(plugin.name, folderName);
  errors.push(...nameErrors);
@@ -236,12 +284,18 @@ function validatePlugin(folderName) {
  const versionError = validateVersion(plugin.version);
  if (versionError) errors.push(versionError);
-  // Rule 5: keywords (or tags for backward compat)
+  // Rule 6: keywords (or tags for backward compat)
  const keywordsError = validateKeywords(plugin.keywords ?? plugin.tags);
  if (keywordsError) errors.push(keywordsError);
  // Rule 5b: license (shared with external plugins). Non-SPDX is a warning, not an error.
  const warnings = [];
  for (const field of ["agents", "commands", "hooks", "mcpServers", "skills"]) {
    if (plugin[field] !== undefined) {
      errors.push(`${field} must be moved to extensions["${AWESOME_COPILOT_NAMESPACE}"].${field}`);
    }
  }
  errors.push(...validateCompositionNamespace(plugin));
  const licenseResult = validateLicenseField(plugin.license, { required: false });
  errors.push(...licenseResult.errors);
  warnings.push(...licenseResult.warnings);
@@ -250,9 +304,19 @@ function validatePlugin(folderName) {
  const specErrors = validateSpecPaths(plugin);
  errors.push(...specErrors);
-  const extensionRefErrors = validateCuratedPluginExtensionRefs(plugin);
+  const extensionRefErrors = validateExtensionReferences(plugin, pluginDir);
  errors.push(...extensionRefErrors);
  if (isExtensionPlugin) {
    const extension = plugin.extensions;
    const namespace = extension?.[COPILOT_NAMESPACE];
    if (!namespace || namespace.logo !== "assets/preview.png") {
      errors.push(`extensions["${COPILOT_NAMESPACE}"].logo must be exactly "assets/preview.png" for extension plugins`);
    } else {
      validateExtensionScreenshotPath(extensionDir, namespace.logo, `extensions["${COPILOT_NAMESPACE}"].logo`, errors);
    }
  }
  return { errors, warnings, plugin: parsedPlugin };
 }
@@ -269,62 +333,6 @@ function validateExtensionScreenshotPath(extensionDir, pathValue, fieldName, err
  }
 }
 function validateExtensionManifest(folderName) {
  const extensionDir = path.join(EXTENSIONS_DIR, folderName);
  const errors = [];
  let parsedPlugin = null;
  const pluginJsonPath = path.join(extensionDir, ".github/plugin", "plugin.json");
  if (!fs.existsSync(pluginJsonPath)) {
    errors.push("missing required file: .github/plugin/plugin.json");
    return { errors, plugin: parsedPlugin };
  }
  const parsed = parseJsonFile(pluginJsonPath);
  if (parsed.parseError) {
    errors.push(`failed to parse plugin.json: ${parsed.parseError}`);
    return { errors, plugin: parsedPlugin };
  }
  parsedPlugin = parsed;
  const nameErrors = validateName(parsed.name, folderName);
  errors.push(...nameErrors);
  const descError = validateDescription(parsed.description);
  if (descError) errors.push(descError);
  const versionError = validateVersion(parsed.version);
  if (versionError) errors.push(versionError);
  const keywordsError = validateKeywords(parsed.keywords ?? parsed.tags);
  if (keywordsError) errors.push(keywordsError);
  // Extension convention: logo must be exactly "assets/preview.png"
  if (parsed.logo !== "assets/preview.png") {
    errors.push('logo must be exactly "assets/preview.png" (extension convention)');
  } else {
    validateExtensionScreenshotPath(extensionDir, parsed.logo, "logo", errors);
  }
  // Extension convention: x-awesome-copilot must not be present
  if (parsed["x-awesome-copilot"] !== undefined) {
    errors.push("x-awesome-copilot field must not be present (use convention-based logo instead)");
  }
  if (parsed.extenions !== undefined) {
    errors.push('use "extensions" field (found misspelled key "extenions")');
  }
  // Extension convention: source manifests keep extensions at repository root.
  // Materialization rewrites this to "extensions" on distribution branches.
  if (parsed.extensions !== ".") {
    errors.push('extensions field must be exactly "." in source manifests (extension convention)');
  }
  return { errors, plugin: parsedPlugin };
 }
 // Main validation function
 function validatePlugins() {
  const pluginDirs = fs.existsSync(PLUGINS_DIR)
@@ -332,15 +340,12 @@ function validatePlugins() {
      .filter((d) => d.isDirectory())
      .map((d) => d.name)
    : [];
-  const extensionDirs = getExtensionFolderNames();
+  if (pluginDirs.length === 0) {
-
+    console.log("No plugin manifests found - validation skipped");
  if (pluginDirs.length === 0 && extensionDirs.length === 0) {
    console.log("No plugins or extension plugin manifests found - validation skipped");
    return true;
  }
  console.log(`Validating ${pluginDirs.length} plugins...\n`);
  console.log(`Validating ${extensionDirs.length} extensions as plugin sources...\n`);
  let hasErrors = false;
  const seenNames = new Set();
@@ -374,30 +379,11 @@ function validatePlugins() {
    }
  }
-  if (extensionDirs.length > 0) {
+  for (const dir of getExtensionFolderNames()) {
-    console.log("");
+    const pluginJsonPath = path.join(PLUGINS_DIR, dir, "plugin.json");
-  }
+    if (!fs.existsSync(pluginJsonPath)) {
-
+      console.error(`❌ extension ${dir}: missing plugin manifest at plugins/${dir}/plugin.json`);
  for (const dir of extensionDirs) {
    console.log(`Validating extension ${dir}...`);
    const { errors, plugin } = validateExtensionManifest(dir);
    if (errors.length > 0) {
      console.error(`❌ extension ${dir}:`);
      errors.forEach((e) => console.error(`   - ${e}`));
      hasErrors = true;
    } else {
      console.log(`✅ extension ${dir} is valid`);
    }
    if (plugin?.name) {
      if (seenNames.has(plugin.name)) {
        console.error(`❌ Duplicate plugin name "${plugin.name}"`);
        hasErrors = true;
      } else {
        seenNames.add(plugin.name);
        localPluginNames.push(plugin.name);
      }
    }
  }
@@ -418,7 +404,7 @@ function validatePlugins() {
  }
  if (!hasErrors) {
-    console.log(`\n✅ All ${pluginDirs.length} plugins, ${extensionDirs.length} extensions, and the external catalog are valid`);
+    console.log(`\n✅ All ${pluginDirs.length} plugins and the external catalog are valid`);
  }
  return !hasErrors;
--- a/Show More
+++ b/Show More