You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Make marketplace and plugins discoverable by both GitHub Copilot CLI and Claude Code (#3)
* Initial plan
* Make marketplace and plugins discoverable by both GitHub Copilot CLI and Claude Code
Co-authored-by: heaths <1532486+heaths@users.noreply.github.com>
* Fix .claude/settings.json example in Sharing with contributors section
Co-authored-by: heaths <1532486+heaths@users.noreply.github.com>
---------
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: heaths <1532486+heaths@users.noreply.github.com>
Copy file name to clipboardExpand all lines: AGENTS.md
+9-6Lines changed: 9 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,12 +2,12 @@
2
2
3
3
## Architecture
4
4
5
-
This is a GitHub Copilot CLI plugin marketplace. The marketplace is defined in `.github/plugin/marketplace.json` and contains multiple plugins, each under `plugins/<name>/`. Plugins can declare skills (prompt-based capabilities in `SKILL.md` files) and MCP servers (in `.mcp.json` files).
5
+
This is a plugin marketplace compatible with [GitHub Copilot CLI] and [Claude Code]. The marketplace is defined in `.claude-plugin/marketplace.json` and contains multiple plugins, each under `plugins/<name>/`. Plugins can declare skills (prompt-based capabilities in `SKILL.md` files) and MCP servers (in `.mcp.json` files).
6
6
7
7
### Key files
8
8
9
-
-`.github/plugin/marketplace.json` — marketplace manifest listing all plugins with their versions and sources.
10
-
-`plugins/<name>/.github/plugin/plugin.json` — per-plugin details including name, description, version, author, and skills.
9
+
-`.claude-plugin/marketplace.json` — marketplace manifest listing all plugins with their versions and sources.
10
+
-`plugins/<name>/.claude-plugin/plugin.json` — per-plugin details including name, description, version, author, and skills.
11
11
-`plugins/<name>/skills/<skill-name>/SKILL.md` — skill definition with YAML frontmatter (`name`, `description`, `compatibility`) and markdown instructions.
12
12
-`plugins/<name>/.mcp.json` — MCP server configuration for a plugin.
13
13
@@ -37,7 +37,7 @@ The marketplace and each plugin have independent semver versions in `marketplace
37
37
38
38
### In-repository plugins
39
39
40
-
Plugins that live in this repository (`source` is a local path like `"plugins/<name>"`) should include the following fields in both `marketplace.json` and their `plugins/<name>/.github/plugin/plugin.json`:
40
+
Plugins that live in this repository (`source` is a local path like `"plugins/<name>"`) should include the following fields in both `marketplace.json` and their `plugins/<name>/.claude-plugin/plugin.json`:
-`source` — object with `"source": "github"` and `"repo": "<owner>/<repo>"`
51
51
-`repository` — full URL to the repository (e.g., `"https://github.com/<owner>/<repo>"`)
52
-
-`author`, `license`, `category`, `keywords` — copy from the remote plugin's `.github/plugin/plugin.json` for discoverability
52
+
-`author`, `license`, `category`, `keywords` — copy from the remote plugin's `.claude-plugin/plugin.json` for discoverability
53
53
54
54
The remote repository owns its own `plugin.json`; do not duplicate skill or MCP server definitions locally.
55
55
56
56
## Pre-commit checklist
57
57
58
58
Before committing, verify:
59
59
60
-
1. If any files under `plugins/<name>/` changed, that plugin's `version` in both `marketplace.json` and `plugins/<name>/.github/plugin/plugin.json` has been bumped following semver rules above.
60
+
1. If any files under `plugins/<name>/` changed, that plugin's `version` in both `marketplace.json` and `plugins/<name>/.claude-plugin/plugin.json` has been bumped following semver rules above.
61
61
2. If a plugin was added or removed from the marketplace, the marketplace `metadata.version` has been bumped accordingly (minor for additions, minor for removals if still 0.x.y, or major for removals once 1.0.0 or later).
62
62
3. Otherwise, if any plugin version was bumped, the marketplace `metadata.version` patch version has been incremented.
63
63
@@ -73,3 +73,6 @@ The commit or pull request body should provide additional context when the title
73
73
- SKILL.md frontmatter fields should not end with a trailing period.
74
74
- Line endings are LF (enforced by `.gitattributes` and `.editorconfig`).
Copy file name to clipboardExpand all lines: README.md
+49Lines changed: 49 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,22 +2,64 @@
2
2
3
3
## Installation
4
4
5
+
Plugins are compatible with both [GitHub Copilot CLI] and [Claude Code].
6
+
7
+
### GitHub Copilot CLI
8
+
5
9
To install this marketplace into [GitHub Copilot CLI] run:
6
10
7
11
```bash
8
12
copilot plugin marketplace add heaths/plugins
9
13
```
10
14
15
+
### Claude Code
16
+
17
+
To install this marketplace into [Claude Code] run:
18
+
19
+
```text
20
+
/plugin marketplace add heaths/plugins
21
+
```
22
+
23
+
## Sharing with contributors
24
+
25
+
You can recommend this marketplace and its plugins to everyone who works in a repository by committing a `.claude/settings.json` file to that repository. When contributors trust the project folder in [Claude Code], they are prompted to install the marketplace and any enabled plugins.
26
+
27
+
Example `.claude/settings.json`:
28
+
29
+
```json
30
+
{
31
+
"extraKnownMarketplaces": {
32
+
"heaths-plugins": {
33
+
"source": {
34
+
"source": "github",
35
+
"repo": "heaths/plugins"
36
+
}
37
+
}
38
+
},
39
+
"enabledPlugins": {
40
+
"linting@heaths-plugins": true
41
+
}
42
+
}
43
+
```
44
+
45
+
> **Note:**[GitHub Copilot CLI] does not currently support project-level plugin recommendations. Contributors using Copilot CLI should run the marketplace and plugin install commands above individually.
46
+
11
47
## Plugins
12
48
13
49
### azsdk-samples-mcp
14
50
15
51
Discovers and retrieves code samples from Azure SDK packages in .NET, Node.js, and Rust projects.
0 commit comments