VS Code compatibility guide

Agent Plugins in VS Code.

Use Agent Plugins in VS Code from a marketplace, Git repository, or local directory, then verify Skills and MCP servers and troubleshoot common loading problems.

By Agent Plugins Hub Editorial Team

01

Agent Plugins in VS Code support

VS Code is listed by the Agent Plugins project as a compatible client. For portable Agent Plugins 1.0 packages, VS Code supports Agent Skills and MCP servers over stdio, Streamable HTTP, and legacy SSE transports.

VS Code also recognizes Copilot, Claude, and legacy OpenPlugin formats. Those formats may add custom agents, hooks, or slash commands, but those capabilities are client-specific rather than portable Agent Plugins 1.0 components.

  • Portable package marker: a root plugin.json declaring the Agent Plugins 1.0 schema.
  • Portable Skills location: immediate child directories under skills/, each with SKILL.md.
  • Portable MCP location: mcp.json at the plugin root.
  • VS Code currently ignores Agent Plugins client-extension namespaces it does not implement.

02

Check the prerequisites before installing

Use a current VS Code release with agent plugin support enabled. The chat.plugins.enabled setting can be controlled by an organization, so a managed environment may require an administrator even when the package itself is valid.

Before trusting a repository, inspect its publisher, license, manifest, Skills, scripts, MCP commands, remote endpoints, and requested credentials. Installation makes plugin components available to the agent; it is not a security review.

Editorial note: A marketplace trust prompt verifies that you chose to trust that source. It does not prove every package in the marketplace is safe.

03

Install from marketplace, source, or a local directory

To browse configured marketplaces, open the Extensions view and search for @agentPlugins, or open Chat: Open Customizations and choose the Plugins tab. Select a package, inspect its source, and choose Install.

To install directly from a public repository, run Chat: Install Plugin From Source from the Command Palette and enter the repository URL. For a manually cloned package, register its directory through chat.pluginLocations instead of copying files into an undocumented internal cache.

"chat.pluginLocations": {
  "/absolute/path/to/reviewed-plugin": true
}

04

Verify the loaded components

Open the Agent Plugins - Installed view or the Plugins tab in Agent Customizations and confirm the expected package is enabled. Skills should appear in the Configure Skills menu. Plugin MCP servers should appear in MCP: List Servers and their tools in Configure Tools.

Start with a harmless, read-only task. Confirm that the expected Skill is selected, that no unexpected server or hook starts, and that credentials remain in client-managed storage rather than package files.

05

Troubleshoot a plugin that does not appear

First check chat.plugins.enabled and any organization policy. Then verify that plugin.json is at a recognized root, the declared name follows its format rules, and a portable package uses the canonical 1.0 schema URL.

If a Skill is skipped, confirm that SKILL.md uses valid YAML frontmatter, that its name is kebab-case, and that the directory name matches. For MCP failures, inspect the exact transport, executable, arguments, working directory, and environment requirements instead of disabling safety controls.

  • Use Extensions: Check for Extension Updates to check cloned sources for updates.
  • Disable a plugin while investigating unexpected behavior; disabling stops its MCP servers.
  • Uninstall from the Agent Plugins - Installed view when the source is no longer trusted or needed.