[Bug]: Plugin not compatible with Copilot CLI Plugin Marketplace

[bgeorges35]

MCP Client

VS Code

Context7 MCP Version

1.0.0

Bug Description

The Context7 plugin (at plugins/claude/context7/) is structured for Claude Code but is not compatible with the Copilot CLI Plugin Marketplace specification. Several issues prevent it from being correctly discovered, loaded, and used by copilot plugin install.

Steps to Reproduce

1. Register the marketplace:

   copilot plugin marketplace add upstash/context7

2. Install the plugin:

   copilot plugin install context7-plugin@context7-marketplace

3. Verify loaded components:

   /agent        → docs-researcher agent is NOT listed
   /skills list  → context7-mcp skill may not load
   

4. The agent, commands, skill and MCP server are not discovered properly by Copilot CLI.

Expected Behavior

After installing the plugin via copilot plugin install, all components should be properly loaded:

• /agent should list docs-researcher
• /skills list should list context7-mcp
• The /context7:docs command should be available
• The MCP server context7 should be registered and functional

Actual Behavior

Multiple components fail to load due to the following incompatibilities:

Current plugin.json:

{
  "name": "context7-plugin",
  "description": "...",
  "author": { "name": "Upstash" }
}

Missing fields:

• version — required for marketplace distribution
• commands — has no default convention, so commands/docs.md is completely invisible to Copilot CLI
• mcpServers — should be explicitly declared (though .mcp.json matches a default lookup path)
• agents, skills — have defaults but explicit declaration is recommended

Suggested plugin.json:

{
  "name": "context7-plugin",
  "description": "Upstash Context7 MCP server for up-to-date documentation lookup...",
  "version": "1.0.0",
  "author": { "name": "Upstash" },
  "license": "MIT",
  "keywords": ["documentation", "context", "mcp", "library-docs"],
  "repository": "https://github.com/upstash/context7",
  "agents": "agents/",
  "skills": "skills/",
  "commands": "commands/",
  "mcpServers": ".mcp.json"
}

Error Messages / Logs

- MCP server "context7" is not discovered automatically after plugin install.
  The plugin's .mcp.json is not picked up because plugin.json does not declared

- agents/docs-researcher.md is silently ignored (missing .agent.md extension).

- commands/docs.md is silently ignored (no "commands" path declared in plugin.json
  and no default convention exists for commands).

- No error is raised — components are silently not loaded because file naming
  and manifest conventions don't match Copilot CLI expectations.

Transport Method

http

Node.js Version

No response

Operating System

all affected

Configuration

Additional Context

References:

• Creating a plugin for GitHub Copilot CLI
• Creating a plugin marketplace for GitHub Copilot CLI
• GitHub Copilot CLI plugin reference

[fahreddinozcan]

Hey @bgeorges35,

thanks for the heads up. We'll update the marketplace manifest.