Skip to content

Commit 1b15663

Browse files
Copilotaaronpowell
andauthored
Update docs to reflect awesome-copilot as default plugin marketplace in CLI and VS Code (#901)
* Initial plan * docs: update plugin discovery for default marketplace in CLI and VS Code Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> * docs: revert README.md changes (covered by #900), update README.plugins.md Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> * fix: update plugin template in constants.mjs so README.plugins.md survives rebuilds Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
1 parent e643790 commit 1b15663

4 files changed

Lines changed: 69 additions & 14 deletions

File tree

docs/README.plugins.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
# 🔌 Plugins
22

3-
Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI.
3+
Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI or VS Code.
4+
5+
> **Awesome Copilot is a default plugin marketplace** — no setup required in either Copilot CLI or VS Code.
46
### How to Contribute
57

68
See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how to contribute new plugins, improve existing ones, and share your use cases.
@@ -13,10 +15,13 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t
1315
- Each plugin includes agents and skills for specific workflows
1416
- Plugins make it easy to adopt comprehensive toolkits for particular scenarios
1517

16-
**Install Plugins:**
17-
- Use \`copilot plugin install <plugin-name>@awesome-copilot\` to install a plugin
18-
- Or browse to the individual files to copy content manually
19-
- Plugins help you discover related customizations you might have missed
18+
**Find & Install in Copilot CLI:**
19+
- Browse the marketplace from within an interactive Copilot session: \`/plugin marketplace browse awesome-copilot\`
20+
- Install a plugin: \`copilot plugin install <plugin-name>@awesome-copilot\`
21+
22+
**Find & Install in VS Code:**
23+
- Open the Extensions search view and type \`@agentPlugins\` to browse available plugins
24+
- Or open the Command Palette and run \`Chat: Plugins\`
2025

2126
| Name | Description | Items | Tags |
2227
| ---- | ----------- | ----- | ---- |

eng/constants.mjs

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,9 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-instructions) for guidelines on
2727

2828
pluginsSection: `## 🔌 Plugins
2929
30-
Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI.`,
30+
Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI or VS Code.
31+
32+
> **Awesome Copilot is a default plugin marketplace** — no setup required in either Copilot CLI or VS Code.`,
3133

3234
pluginsUsage: `### How to Contribute
3335
@@ -41,10 +43,13 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t
4143
- Each plugin includes agents and skills for specific workflows
4244
- Plugins make it easy to adopt comprehensive toolkits for particular scenarios
4345
44-
**Install Plugins:**
45-
- Use \\\`copilot plugin install <plugin-name>@awesome-copilot\\\` to install a plugin
46-
- Or browse to the individual files to copy content manually
47-
- Plugins help you discover related customizations you might have missed`,
46+
**Find & Install in Copilot CLI:**
47+
- Browse the marketplace from within an interactive Copilot session: \\\`/plugin marketplace browse awesome-copilot\\\`
48+
- Install a plugin: \\\`copilot plugin install <plugin-name>@awesome-copilot\\\`
49+
50+
**Find & Install in VS Code:**
51+
- Open the Extensions search view and type \\\`@agentPlugins\\\` to browse available plugins
52+
- Or open the Command Palette and run \\\`Chat: Plugins\\\``,
4853

4954
featuredPluginsSection: `## 🌟 Featured Plugins
5055

website/src/content/learning-hub/installing-and-using-plugins.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -94,12 +94,12 @@ Plugins are especially valuable when you want to:
9494

9595
## Finding Plugins
9696

97-
Plugins are collected in **marketplaces** — registries you can browse and install from. Copilot CLI comes with two marketplaces registered by default:
97+
Plugins are collected in **marketplaces** — registries you can browse and install from. Both Copilot CLI and VS Code come with two marketplaces registered by default**no setup required**:
9898

9999
- **`copilot-plugins`** — Official GitHub Copilot plugins
100100
- **`awesome-copilot`** — Community-contributed plugins from this repository
101101

102-
### Browsing a Marketplace
102+
### Browsing in Copilot CLI
103103

104104
List your registered marketplaces:
105105

@@ -121,6 +121,13 @@ Or from within an interactive Copilot session:
121121

122122
> **Tip**: You can also browse plugins on this site's [Plugins Directory](../../plugins/) to see descriptions, included agents, and skills before installing.
123123
124+
### Browsing in VS Code
125+
126+
Because `awesome-copilot` is a default marketplace in VS Code, you can discover plugins without any configuration:
127+
128+
- Open the **Extensions** search view and type **`@agentPlugins`** to see all available plugins
129+
- Or open the **Command Palette** (`Ctrl+Shift+P` / `Cmd+Shift+P`) and run **Chat: Plugins**
130+
124131
### Adding More Marketplaces
125132

126133
Register additional marketplaces from GitHub repositories:
@@ -137,9 +144,9 @@ copilot plugin marketplace add /path/to/local-marketplace
137144

138145
## Installing Plugins
139146

140-
### From a Registered Marketplace
147+
### From Copilot CLI
141148

142-
The most common way to install a plugin — reference it by name and marketplace:
149+
Reference a plugin by name and marketplace:
143150

144151
```bash
145152
copilot plugin install database-data-management@awesome-copilot
@@ -151,6 +158,10 @@ Or from an interactive session:
151158
/plugin install database-data-management@awesome-copilot
152159
```
153160

161+
### From VS Code
162+
163+
Browse to the plugin via `@agentPlugins` in the Extensions search view or via **Chat: Plugins** in the Command Palette, then click **Install**.
164+
154165
## Managing Plugins
155166

156167
Once installed, plugins are managed with a few simple commands:

website/src/pages/plugins.astro

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,15 @@ import PageHeader from '../components/PageHeader.astro';
1111

1212
<div class="page-content">
1313
<div class="container">
14+
<div class="how-to-access">
15+
<p><strong>Awesome Copilot is a default plugin marketplace</strong> — no setup required. Access it directly from your tools:</p>
16+
<ul>
17+
<li><strong>GitHub Copilot CLI</strong>: Type <code>/plugin marketplace browse awesome-copilot</code> in a Copilot session</li>
18+
<li><strong>VS Code</strong>: Type <code>@agentPlugins</code> in the Extensions search view, or open the Command Palette and run <code>Chat: Plugins</code></li>
19+
</ul>
20+
<p>Install any plugin with: <code>copilot plugin install &lt;plugin-name&gt;@awesome-copilot</code></p>
21+
</div>
22+
1423
<div class="search-bar">
1524
<label for="search-input" class="sr-only">Search plugins</label>
1625
<input type="text" id="search-input" placeholder="Search plugins..." autocomplete="off">
@@ -44,4 +53,29 @@ import PageHeader from '../components/PageHeader.astro';
4453
<script>
4554
import '../scripts/pages/plugins';
4655
</script>
56+
57+
<style>
58+
.how-to-access {
59+
background: var(--sl-color-bg-nav);
60+
border: 1px solid var(--sl-color-hairline);
61+
border-radius: 0.5rem;
62+
padding: 1rem 1.25rem;
63+
margin-bottom: 1.5rem;
64+
font-size: 0.9rem;
65+
line-height: 1.6;
66+
}
67+
.how-to-access p { margin: 0 0 0.5rem; }
68+
.how-to-access p:last-child { margin-bottom: 0; }
69+
.how-to-access ul {
70+
margin: 0.25rem 0 0.5rem 1.25rem;
71+
padding: 0;
72+
}
73+
.how-to-access li { margin: 0.2rem 0; }
74+
.how-to-access code {
75+
background: var(--sl-color-bg-inline-code);
76+
padding: 0.1em 0.35em;
77+
border-radius: 0.2rem;
78+
font-size: 0.85em;
79+
}
80+
</style>
4781
</StarlightPage>

0 commit comments

Comments
 (0)