Skip to content

Update docs to reflect awesome-copilot as default plugin marketplace in CLI and VS Code#901

Merged
aaronpowell merged 4 commits intostagedfrom
copilot/update-readme-plugins-info
Mar 6, 2026
Merged

Update docs to reflect awesome-copilot as default plugin marketplace in CLI and VS Code#901
aaronpowell merged 4 commits intostagedfrom
copilot/update-readme-plugins-info

Conversation

Copy link
Contributor

Copilot AI commented Mar 6, 2026

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • My contribution adds a new instruction, prompt, agent, skill, or workflow 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, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.

Description

Awesome Copilot is now a default plugin marketplace in both Copilot CLI and VS Code — no manual plugin marketplace add step required. This PR updates all relevant documentation to reflect that fact, and adds VS Code discovery paths that were previously absent.

  • eng/constants.mjs: Updated the pluginsSection and pluginsUsage template strings — the true source for docs/README.plugins.md — with a default marketplace callout, the /plugin marketplace browse awesome-copilot CLI slash command, and VS Code access methods (@agentPlugins in Extensions search and Chat: Plugins in Command Palette).
  • docs/README.plugins.md: Regenerated via npm run build from the updated templates in eng/constants.mjs.
  • website/src/pages/plugins.astro: Added a visible "how to access" info panel above the plugin list covering both CLI and VS Code.
  • website/src/content/learning-hub/installing-and-using-plugins.md (+ symlinked docs copy): Updated "Finding Plugins" to clarify no setup is needed; added "Browsing in VS Code" and separate "From Copilot CLI" / "From VS Code" install subsections.

Note: README.md changes were intentionally excluded from this PR as they are covered by #900.


Type of Contribution

  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.

Additional Notes

docs/README.plugins.md is generated by eng/update-readme.mjs using templates from eng/constants.mjs. The plugin section templates were updated at the source so the generated file stays correct on future builds.

The Learning Hub article at website/src/content/docs/learning-hub/installing-and-using-plugins.md is a symlink to the learning-hub/ copy and picks up all changes automatically.


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


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
@aaronpowell
Copy link
Contributor

@copilot due to #900 we probably don't want to update the main README, but what about README.plugins.md?

…ns.md

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 6, 2026

@copilot due to #900 we probably don't want to update the main README, but what about README.plugins.md?

Reverted the README.md changes in 2849d91 — those will be left to #900. The docs/README.plugins.md now has the default marketplace callout, CLI slash command, and VS Code access methods.

Copilot AI changed the title [WIP] Update README to reflect awesome copilot as default plugin marketplace Update docs to reflect awesome-copilot as default plugin marketplace in CLI and VS Code Mar 6, 2026
@aaronpowell
Copy link
Contributor

@copilot isn't the header of the README.plugins.md from a JS file? that'll need updating too

…vives rebuilds

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 6, 2026

@copilot isn't the header of the README.plugins.md from a JS file? that'll need updating too

Good catch — the header comes from eng/constants.mjs. Updated the pluginsSection and pluginsUsage templates there in 0e56450 and re-ran npm run build so docs/README.plugins.md is regenerated correctly and will stay correct on future builds.

@aaronpowell aaronpowell marked this pull request as ready for review March 6, 2026 05:25
@aaronpowell aaronpowell self-requested a review as a code owner March 6, 2026 05:25
Copilot AI review requested due to automatic review settings March 6, 2026 05:25
@aaronpowell aaronpowell merged commit 1b15663 into staged Mar 6, 2026
5 checks passed
@aaronpowell aaronpowell deleted the copilot/update-readme-plugins-info branch March 6, 2026 05:26
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates documentation and website UI to reflect that awesome-copilot is now a default plugin marketplace in both Copilot CLI and VS Code, and adds explicit VS Code discovery/install guidance.

Changes:

  • Add “default marketplace / no setup required” callouts plus CLI/VS Code discovery paths in generated plugin docs content.
  • Update Learning Hub “Installing and Using Plugins” article with separate CLI vs VS Code browsing/install sections.
  • Add a “how to access” info panel to the website Plugins directory page.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
website/src/pages/plugins.astro Adds a visible “how to access” panel (CLI + VS Code discovery/install pointers) above the plugin list.
website/src/content/learning-hub/installing-and-using-plugins.md Clarifies default marketplaces and adds VS Code browsing + install guidance alongside CLI instructions.
eng/constants.mjs Updates the source templates used to generate docs/README.plugins.md with new CLI/VS Code guidance.
docs/README.plugins.md Regenerated plugin README content reflecting the updated templates.

You can also share your feedback on Copilot code review. Take the survey.

Comment on lines +47 to +52
- Browse the marketplace from within an interactive Copilot session: \\\`/plugin marketplace browse awesome-copilot\\\`
- Install a plugin: \\\`copilot plugin install <plugin-name>@awesome-copilot\\\`

**Find & Install in VS Code:**
- Open the Extensions search view and type \\\`@agentPlugins\\\` to browse available plugins
- Or open the Command Palette and run \\\`Chat: Plugins\\\``,
Copy link

Copilot AI Mar 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pluginsUsage is escaping inline-code backticks with \\\`` which likely renders as literal backticks (not inline code) in the generated markdown. Use the same pattern as elsewhere in this file (`inside the template literal) so the output contains plain Markdown inline code (``...` ``) without leading backslashes, then regenerate the README output.

Suggested change
- Browse the marketplace from within an interactive Copilot session: \\\`/plugin marketplace browse awesome-copilot\\\`
- Install a plugin: \\\`copilot plugin install <plugin-name>@awesome-copilot\\\`
**Find & Install in VS Code:**
- Open the Extensions search view and type \\\`@agentPlugins\\\` to browse available plugins
- Or open the Command Palette and run \\\`Chat: Plugins\\\``,
- Browse the marketplace from within an interactive Copilot session: \`/plugin marketplace browse awesome-copilot\`
- Install a plugin: \`copilot plugin install <plugin-name>@awesome-copilot\`
**Find & Install in VS Code:**
- Open the Extensions search view and type \`@agentPlugins\` to browse available plugins
- Or open the Command Palette and run \`Chat: Plugins\``,

Copilot uses AI. Check for mistakes.
Comment on lines +19 to +24
- Browse the marketplace from within an interactive Copilot session: \`/plugin marketplace browse awesome-copilot\`
- Install a plugin: \`copilot plugin install <plugin-name>@awesome-copilot\`

**Find & Install in VS Code:**
- Open the Extensions search view and type \`@agentPlugins\` to browse available plugins
- Or open the Command Palette and run \`Chat: Plugins\`
Copy link

Copilot AI Mar 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These list items escape the inline-code backticks (e.g., \/plugin marketplace browse...`). In Markdown, `prevents inline code rendering and shows literal backticks instead. Regenerate this file after fixing the source template so these use normal inline code formatting (``...` ``) without backslashes.

Suggested change
- Browse the marketplace from within an interactive Copilot session: \`/plugin marketplace browse awesome-copilot\`
- Install a plugin: \`copilot plugin install <plugin-name>@awesome-copilot\`
**Find & Install in VS Code:**
- Open the Extensions search view and type \`@agentPlugins\` to browse available plugins
- Or open the Command Palette and run \`Chat: Plugins\`
- Browse the marketplace from within an interactive Copilot session: `/plugin marketplace browse awesome-copilot`
- Install a plugin: `copilot plugin install <plugin-name>@awesome-copilot`
**Find & Install in VS Code:**
- Open the Extensions search view and type `@agentPlugins` to browse available plugins
- Or open the Command Palette and run `Chat: Plugins`

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants