[digitarald]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• I have read and followed the Guidance for submissions involving paid services.
• My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.
• I am targeting the main branch for this pull request.

---

Description

Add visible Install in VS Code buttons to Plugins and canvas Extensions, on both catalog cards and detail pages. Preserve the existing Copilot app, CLI, and source actions.

Links use the awesome-copilot marketplace repository and the canonical plugin name:

vscode://chat-plugin/install?source=github%2Fawesome-copilot&plugin=ai-ready

Canvas links install the owning pluginName, which can differ from the canvas ID. Curated third-party entries also resolve through github/awesome-copilot, preserving the marketplace's upstream locator. External canvases without a marketplace plugin remain source-only.

Existing Copilot app eligibility, CLI identifiers, and the compact detail header's primary app action are unchanged. Keep one VS Code action in the canvas hero rather than repeating it in the article.

The shared URI builder targets only this marketplace. Focused URI tests run in preview CI; the browser smoke test checks representative catalog and detail links without scanning every generated page or duplicating existing layout/header regressions.

---

Type of Contribution

• New instruction file.
• New prompt file.
• New agent file.
• New plugin.
• New skill file.
• New agentic workflow.
• New canvas extension.
• Update to existing instruction, prompt, agent, plugin, skill, workflow, or canvas extension.
• Other (please specify): Website install actions, focused tests, and contributor documentation.

---

Additional Notes

Validation on Node v24.17.0:

• node --test website/scripts/plugin-install.test.mjs: passed, 3 focused tests for the awesome-copilot URI, query encoding, and invalid plugin names. Also wired into the website preview workflow.
• npm start: passed. Root README and marketplace generation left no generated-file changes.
• npm run website:build: blocked. Root build and website data generation passed, including 190 plugin records and 56 canvas extension records, but Astro was unavailable.
• npm ci --prefix website: failed, the configured npm feed returned HTTP 404 for locked dependency vite@8.3.5; the public registry was also unreachable. Dependency manifests and lockfiles are unchanged.
• node website/scripts/plugin-install-regression.mjs: blocked before execution because Playwright is unavailable. The narrowed smoke test checks catalog links, local/external plugin details, canvas owner mapping, external canvas eligibility, and source-only canvas details without launching VS Code.
• node --check website/scripts/plugin-install-regression.mjs and node --check website/src/lib/plugin-install.ts: passed.
• Preview workflow YAML parsing and the focused test-step wiring: passed.
• Generated catalog identity check: passed, all plugin names and non-empty canvas pluginName values match marketplace entries.
• git diff --check: passed.
• UI design detector over the two components changed in the simplification: passed, no findings.
• bash eng/fix-line-endings.sh: attempted, but its GNU-style sed -i invocation is incompatible with macOS. Normalized the changed Markdown with perl -pi -e 's/\r$//' website/README.md and verified LF endings.

The preview build and deployment passed for the initial implementation (5112058d); the simplification needs a fresh CI run. Local production and browser checks remain blocked by missing website dependencies. Rendered accessibility checks and application handoff have not been verified. The VS Code link requires a build that supports the chat-plugin handler, enabled plugins, and Copilot on the Agent Host. Installation remains subject to VS Code's confirmation flow.

The unchecked resource-submission and Copilot-content testing checklist items do not apply to this website-only change.

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

🤖 Posted by GitHub Copilot on Harald's behalf.

[github-actions]

🚦 Submission status: ⏳ Awaiting automation

Risk tier: merge-risk:high — Privileged execution, automation, or review-policy change
Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access, including a maintainer with admin or maintain permission.

Why this tier

• .github/workflows/deploy-website-preview.yml is a high-risk path (automation, scripts, MCP config, hooks, or review policy)

Automated checks

Check	Status	Details
Line endings	🔧 Infrastructure failure	Waiting for a maintainer to approve workflow runs for this PR · logs
Spelling	🔧 Infrastructure failure	Waiting for a maintainer to approve workflow runs for this PR · logs
Submission gate tests	🔧 Infrastructure failure	Waiting for a maintainer to approve workflow runs for this PR · logs
Contributor reputation	🔧 Infrastructure failure	Waiting for a maintainer to approve workflow runs for this PR · logs
Duplicate resource scan	⚠️ Failed (advisory, non-blocking)	Waiting for a maintainer to approve workflow runs for this PR · logs
PR quality signal	⚠️ Failed (advisory, non-blocking)	Waiting for a maintainer to approve workflow runs for this PR · logs

Action needed

• 🔧 Line endings, Spelling, Submission gate tests, Contributor reputation hit an automation problem that is not caused by your contribution. Comment /rerun-checks to retry; maintainers are notified if it keeps failing.
• ⚠️ Advisory checks did not complete (Duplicate resource scan, PR quality signal). This does not block the PR.

Review

• Approvals: 0/1
• Assigned reviewer: aaronpowell
• Review target date: not set
• Still needed: 1 more approval(s); an approval from a maintainer with admin or maintain permission
• The core-maintainers pool is not staffed yet; an approver with admin or maintain permission is required instead.

Commands

Command	Who	What it does
/rerun-checks	PR author, maintainers	Re-runs failed or incomplete checks and re-evaluates this gate
/request-review	PR author, maintainers	Asks the review rotation to assign a reviewer (adds needs-reviewer)

_{Updated for fb6a4e7 · gate run · This comment is maintained automatically — see submission gate docs.}

[Copilot]

🔵 Needs a closer look

Accessibility corrections and successful production-build, browser, and VS Code handoff validation are still needed.

1 open issue

• Fix VS Code install button accessible name · New

What changed in this PR

Adds VS Code installation actions to the website’s plugin and canvas catalogs and detail pages while preserving existing installation and source actions.

Changes:

• Generate marketplace-qualified links using canonical plugin names and canvas ownership.
• Add VS Code buttons and align external canvas app-link eligibility.
• Add focused URL tests, browser regression checks, and contributor documentation.

File	Description
website/​src/​pages/​plugin/​[id].astro	Builds install links using canonical plugin names.
website/​src/​pages/​extension/​[id].astro	Builds VS Code links for marketplace-backed canvases.
website/​src/​lib/​plugin-install.ts	Centralizes install URL validation and encoding.
website/​src/​components/​brand/​PluginsCatalog.tsx	Adds VS Code actions to plugin cards.
website/​src/​components/​brand/​PluginDetail.tsx	Adds a VS Code detail-page button.
website/​src/​components/​brand/​ExtensionsCatalog.tsx	Adds canvas install actions and aligns app-link eligibility.
website/​src/​components/​brand/​ExtensionDetail.tsx	Adds VS Code actions for eligible canvases.
website/​scripts/​plugin-install.test.mjs	Tests URL encoding, validation, and marketplace identities.
website/​scripts/​plugin-install-regression.mjs	Checks rendered links, keyboard activation, and layouts.
website/​README.md	Documents install behavior and validation commands.

_{Review effort: Max}

[Copilot]

🔵 Needs a closer look

The current revision still needs rendered-browser and VS Code handoff validation before maintainer approval.

2 open issues

• Put visible install label first in extension link name · New
• Fix VS Code install button accessible name

_{Review effort: Max}

[Copilot]

🟡 Changes recommended

The install links must target the published marketplace branch to include built-in plugin content.

2 open issues

• Use the marketplace branch for built-in plugin sources · New
• Cover a built-in plugin in the detail page fixtures · New

2 resolved since last review

• Put visible install label first in extension link name
• Fix VS Code install button accessible name

_{Review effort: Max}