plugin-manager（插件管理器）

Plugin Manager

Maintain plugin packaging for both ecosystems in a single repository, using a shared plugins/ directory and a shared top-level skills/ source of truth.

Working Rules

• Keep each plugin self-contained in plugins/<plugin-name>/.
• Keep shared reusable skill content in top-level skills/.
• Expose shared skills per plugin via symlinks in plugins/<plugin-name>/skills/.
• Keep MCP config plugin-local at plugins/<plugin-name>/mcp.json.
• Keep both marketplace manifests at repo root:

- .claude-plugin/marketplace.json - .cursor-plugin/marketplace.json

Required Plugin Layout

For every plugin, ensure this layout exists:

plugins/<plugin-name>/
  .claude-plugin/plugin.json
  .cursor-plugin/plugin.json
  skills/
    <skill-name> -> ../../../skills/<skill-name>   # symlink
  mcp.json
  assets/

Create or Update a Plugin

1. Create plugins/<plugin-name>/.
2. Add both manifests:

- plugins/<plugin-name>/.claude-plugin/plugin.json - plugins/<plugin-name>/.cursor-plugin/plugin.json

1. Add or update plugins/<plugin-name>/mcp.json for plugin-specific MCP servers.
2. Symlink required top-level skills into plugins/<plugin-name>/skills/.
3. Add plugins/<plugin-name>/assets/logo.svg for Cursor.
4. Register plugin in both marketplaces using source: "./plugins/<plugin-name>".
5. Validate JSON and path references before finishing.

Manifest Guidelines

• Claude plugin manifest

- Path: plugins/<plugin-name>/.claude-plugin/plugin.json - Prefer plugin-local relative paths, for example: - "skills": "./skills/" - "mcpServers": "./mcp.json"

• Cursor plugin manifest

- Path: plugins/<plugin-name>/.cursor-plugin/plugin.json - Prefer plugin-local relative paths, for example: - "skills": "./skills/" - "mcpServers": "./mcp.json" - "logo": "assets/logo.svg"

• Marketplace manifests

- .claude-plugin/marketplace.json uses source: "./plugins/<plugin-name>". - .cursor-plugin/marketplace.json uses metadata.pluginRoot: "plugins" and plugin entries with source: "<plugin-name>".

References

• For detailed examples and checklists, read references/plugin-guidelines.md.