Claude 插件市场创建与管理指南：构建团队插件集合与分发平台

Creating and Managing Plugin Marketplaces by bbrowning/bbrowning-claude-marketplace

1 GitHub Stars

安装命令

npx skills add https://github.com/bbrowning/bbrowning-claude-marketplace --skill 'Creating and Managing Plugin Marketplaces'

开发自动化团队沟通

🇨🇳中文介绍

Claude 代码市场构建器

什么是市场？

市场是一个 Claude 代码插件集合，可以作为一个整体单元进行共享。市场支持：

集中分发多个相关插件
通过 git 仓库进行版本控制和共享
团队或社区范围内的插件发现
按主题、团队或用途组织的插件集合

市场目录结构

市场遵循以下结构：

my-marketplace/
├── .claude-plugin/
│   └── marketplace.json      # 市场清单文件（必需）
├── plugin-one/
│   └── .claude-plugin/
│       └── plugin.json       # 单个插件清单文件
├── plugin-two/
│   └── .claude-plugin/
│       └── plugin.json
└── README.md                 # 文档（推荐）

关键点

市场清单文件必须位于市场根目录的 .claude-plugin/marketplace.json
市场中的每个插件都有自己的 plugin.json 清单文件
插件可以放在你喜欢的任何子目录结构中
推荐使用 Git 版本控制进行共享和协作

市场清单文件 (marketplace.json)

位置和要求

市场清单文件必须位于：

.claude-plugin/marketplace.json

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

可选元数据字段

{
  "name": "my-marketplace",
  "description": "Marketplace description",
  "version": "1.0.0",
  "owner": {
    "name": "Your Name",
    "email": "you@example.com"
  },
  "homepage": "https://github.com/username/marketplace",
  "plugins": []
}

description：市场用途的简要概述
version：市场版本（语义化版本）
homepage：市场文档或仓库的 URL

向市场添加插件

plugins 数组中的每个插件都需要：

{
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugin-directory",
      "description": "Brief description"
    }
  ]
}

插件条目字段：

name：插件标识符（必须与插件的 plugin.json 中的名称匹配）
source：插件的路径或 URL（参见插件来源部分）
description：简要描述（可选，但推荐用于提高可发现性）

包含多个插件的示例

{
  "name": "team-productivity",
  "owner": {
    "name": "Engineering Team"
  },
  "description": "Productivity tools for our engineering team",
  "plugins": [
    {
      "name": "code-review-helper",
      "source": "./code-review-helper",
      "description": "Automated code review assistance"
    },
    {
      "name": "pr-templates",
      "source": "./pr-templates",
      "description": "Standardized PR templates and workflows"
    },
    {
      "name": "testing-utils",
      "source": "./testing-utils",
      "description": "Test generation and coverage tools"
    }
  ]
}

marketplace.json 中的插件来源支持多种格式：

本地路径（相对路径）

{
  "name": "local-plugin",
  "source": "./local-plugin"
}

用于存储在市场目录内的插件。路径必须相对于市场根目录。

{
  "name": "github-plugin",
  "source": "github:username/repo"
}

用于托管在 GitHub 上的插件。Claude 代码将克隆该仓库。

{
  "name": "git-plugin",
  "source": "https://github.com/username/repo.git"
}

用于托管在任何 Git 提供商上的插件。支持完整的 git URL。

{
  "plugins": [
    {
      "name": "internal-tool",
      "source": "./internal-tool",
      "description": "Internal team tool"
    },
    {
      "name": "community-plugin",
      "source": "github:community/awesome-plugin",
      "description": "Community-maintained plugin"
    },
    {
      "name": "external-tool",
      "source": "https://gitlab.com/team/tool.git",
      "description": "External Git repository"
    }
  ]
}

创建市场：分步指南

步骤 1：创建市场目录

mkdir my-marketplace
cd my-marketplace

步骤 2：创建市场清单文件

mkdir .claude-plugin

创建 .claude-plugin/marketplace.json：

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Name"
  },
  "plugins": []
}

步骤 3：初始化 Git（推荐）

版本控制支持：

通过仓库 URL 轻松共享
版本历史跟踪
协作工作流程
向用户分发

步骤 4：添加插件

对于要包含的每个插件：

创建插件目录：

mkdir my-plugin
mkdir my-plugin/.claude-plugin

创建插件清单文件 (my-plugin/.claude-plugin/plugin.json)：

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "Plugin description"
}

添加插件组件（技能、命令、代理等）

更新 marketplace.json：

{
  "plugins": [
    {
      "name": "my-plugin",
      "source": "./my-plugin",
      "description": "Plugin description"
    }
  ]
}

步骤 5：本地测试

将市场添加到 Claude 代码：

/plugin marketplace add /path/to/my-marketplace

安装并测试插件：

/plugin install my-plugin@my-marketplace

运行 /plugin 查看已安装的插件
检查 /help 获取新命令
测试插件功能

本地开发工作流程

修改市场中的插件时：

卸载旧版本：

/plugin uninstall plugin-name@marketplace-name

重新安装更新版本：

/plugin install plugin-name@marketplace-name

或者，重启 Claude 代码以重新加载所有插件。

推荐的工作流程：

修改插件文件
卸载 → 重新安装插件
测试功能
提交更改到 git
根据需要重复

使用调试模式进行故障排除：

市场加载状态
插件加载状态
清单验证错误
组件注册
任何警告或错误

提交到 git：

git add .
git commit -m "Add marketplace with plugins"

推送到远程仓库：

git remote add origin <repository-url>
git push -u origin main

与用户共享： 用户添加你的市场：
```
/plugin marketplace add <repository-url>
```

或对于本地路径：

     /plugin marketplace add /path/to/marketplace

4. 安装插件：

     /plugin install plugin-name@marketplace-name

管理插件生命周期

用户可以管理已安装的插件：

# 启用插件
/plugin enable plugin-name@marketplace-name

# 禁用插件
/plugin disable plugin-name@marketplace-name

# 卸载插件
/plugin uninstall plugin-name@marketplace-name

marketplace.json 包含必需字段（name、owner、plugins）
所有插件条目都有 name 和 source
插件名称与其 plugin.json 中的名称匹配
本地插件路径是相对路径并以 ./ 开头
所有插件安装时没有错误
使用 claude --debug 测试警告
README.md 记录了市场用途和插件
仓库已正确初始化 git
所有更改都已提交

有关组织、版本控制、分发和协作的全面最佳实践，请参阅 reference/best-practices.md。

市场清单文件必须位于 .claude-plugin/marketplace.json（不在根目录）
每个插件条目需要 name、source，可选 description
插件来源可以是本地路径（./plugin）、GitHub 仓库（github:user/repo）或 Git URL
添加市场一次：/plugin marketplace add <path-or-url>
安装插件：/plugin install plugin-name@marketplace-name

创建包含 .claude-plugin/marketplace.json 的市场目录
添加具有自己的 plugin.json 清单文件的插件
共享前本地测试：/plugin marketplace add /local/path
使用 git 进行版本控制和分发
更新工作流程：卸载 → 重新安装或重启 Claude 代码

通过 git 仓库 URL 或本地路径共享
用户添加市场，然后浏览/安装插件
市场可以混合本地和远程插件来源
对市场和插件都使用语义化版本控制
在 README 中记录安装和使用方法

有关个人、团队、社区和混合市场模式的详细示例，请参阅 reference/best-practices.md。

🇺🇸English

Claude Code Marketplace Builder

What is a Marketplace?

A marketplace is a collection of Claude Code plugins that can be shared as a cohesive unit. Marketplaces enable:

Centralized distribution of multiple related plugins
Version control and sharing via git repositories
Team-wide or community-wide plugin discovery
Organized collections of plugins by theme, team, or purpose

Marketplace Directory Structure

A marketplace follows this structure:

my-marketplace/
├── .claude-plugin/
│   └── marketplace.json      # Marketplace manifest (REQUIRED)
├── plugin-one/
│   └── .claude-plugin/
│       └── plugin.json       # Individual plugin manifest
├── plugin-two/
│   └── .claude-plugin/
│       └── plugin.json
└── README.md                 # Documentation (recommended)

Key Points

Marketplace manifest must be at .claude-plugin/marketplace.json in the marketplace root
Each plugin within the marketplace has its own plugin.json manifest
Plugins can be in any subdirectory structure you prefer
Git version control is recommended for sharing and collaboration

Marketplace Manifest (marketplace.json)

Location and Requirements

The marketplace manifest MUST be located at:

.claude-plugin/marketplace.json

This file defines the marketplace metadata and lists all available plugins.

Required Fields

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Name"
  },
  "plugins": []
}

Field Descriptions:

name: Marketplace identifier in kebab-case (e.g., "team-tools", "data-science-plugins")
owner.name: Maintainer's name (REQUIRED)
owner.email: Maintainer's email (OPTIONAL)
plugins: Array of plugin entries (can be empty initially)

Optional Metadata Fields

{
  "name": "my-marketplace",
  "description": "Marketplace description",
  "version": "1.0.0",
  "owner": {
    "name": "Your Name",
    "email": "you@example.com"
  },
  "homepage": "https://github.com/username/marketplace",
  "plugins": []
}

Additional Fields:

description: Brief overview of the marketplace's purpose
version: Marketplace version (semantic versioning)
homepage: URL to marketplace documentation or repository

Adding Plugins to Marketplace

Plugin Entry Structure

Each plugin in the plugins array requires:

{
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugin-directory",
      "description": "Brief description"
    }
  ]
}

Plugin Entry Fields:

name: Plugin identifier (MUST match the plugin's plugin.json name)
source: Path or URL to plugin (see Plugin Sources section)
description: Brief description (optional but recommended for discoverability)

Example with Multiple Plugins

{
  "name": "team-productivity",
  "owner": {
    "name": "Engineering Team"
  },
  "description": "Productivity tools for our engineering team",
  "plugins": [
    {
      "name": "code-review-helper",
      "source": "./code-review-helper",
      "description": "Automated code review assistance"
    },
    {
      "name": "pr-templates",
      "source": "./pr-templates",
      "description": "Standardized PR templates and workflows"
    },
    {
      "name": "testing-utils",
      "source": "./testing-utils",
      "description": "Test generation and coverage tools"
    }
  ]
}

Plugin Sources

Plugin sources in marketplace.json support multiple formats:

Local Path (Relative)

{
  "name": "local-plugin",
  "source": "./local-plugin"
}

Use for plugins stored within the marketplace directory. Paths must be relative to the marketplace root.

GitHub Repository

{
  "name": "github-plugin",
  "source": "github:username/repo"
}

Use for plugins hosted on GitHub. Claude Code will clone the repository.

Git URL

{
  "name": "git-plugin",
  "source": "https://github.com/username/repo.git"
}

Use for plugins hosted on any Git provider. Full git URLs are supported.

Mixed Sources Example

{
  "plugins": [
    {
      "name": "internal-tool",
      "source": "./internal-tool",
      "description": "Internal team tool"
    },
    {
      "name": "community-plugin",
      "source": "github:community/awesome-plugin",
      "description": "Community-maintained plugin"
    },
    {
      "name": "external-tool",
      "source": "https://gitlab.com/team/tool.git",
      "description": "External Git repository"
    }
  ]
}

Creating a Marketplace: Step-by-Step

Step 1: Create Marketplace Directory

mkdir my-marketplace
cd my-marketplace

Step 2: Create Marketplace Manifest

mkdir .claude-plugin

Create .claude-plugin/marketplace.json:

{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Name"
  },
  "plugins": []
}

Step 3: Initialize Git (Recommended)

git init

Version control enables:

Easy sharing via repository URL
Version history tracking
Collaboration workflows
Distribution to users

Step 4: Add Plugins

For each plugin you want to include:

Create plugin directory:

mkdir my-plugin
mkdir my-plugin/.claude-plugin

Create plugin manifest (my-plugin/.claude-plugin/plugin.json):

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "Plugin description"
}

Add plugin components (skills, commands, agents, etc.)

Update marketplace.json:

{
  "plugins": [
    {
      "name": "my-plugin",
      "source": "./my-plugin",
      "description": "Plugin description"
    }
  ]
}

Step 5: Test Locally

Add marketplace to Claude Code:

/plugin marketplace add /path/to/my-marketplace

Install and test plugins:

/plugin install my-plugin@my-marketplace

Verify installation:

Run /plugin to see installed plugins
Check /help for new commands
Test plugin functionality

Local Development Workflow

Testing Changes

When modifying plugins in your marketplace:

Uninstall old version:

/plugin uninstall plugin-name@marketplace-name

Reinstall updated version:

/plugin install plugin-name@marketplace-name

Alternatively, restart Claude Code to reload all plugins.

Development Iteration

Recommended workflow:

Make changes to plugin files
Uninstall → Reinstall plugin
Test functionality
Commit changes to git
Repeat as needed

Debugging

Use debug mode to troubleshoot:

claude --debug

This shows:

Marketplace loading status
Plugin loading status
Manifest validation errors
Component registration
Any warnings or errors

Distribution and Sharing

Sharing Your Marketplace

Commit to git:

git add .
git commit -m "Add marketplace with plugins"

Push to remote repository:

git remote add origin <repository-url>
git push -u origin main

Share with users: Users add your marketplace:
```
/plugin marketplace add <repository-url>
```

Or for local paths:

     /plugin marketplace add /path/to/marketplace

4. Install plugins:

     /plugin install plugin-name@marketplace-name

Managing Plugin Lifecycle

Users can manage installed plugins:

# Enable plugin
/plugin enable plugin-name@marketplace-name

# Disable plugin
/plugin disable plugin-name@marketplace-name

# Uninstall plugin
/plugin uninstall plugin-name@marketplace-name

Testing Checklist

Before distributing your marketplace:

marketplace.json has required fields (name, owner, plugins)
All plugin entries have name and source
Plugin names match their plugin.json names
Local plugin paths are relative and start with ./
All plugins install without errors
Tested with claude --debug for warnings
README.md documents marketplace purpose and plugins
Repository is properly initialized with git
All changes are committed

Best Practices

For comprehensive best practices on organization, versioning, distribution, and collaboration, see reference/best-practices.md.

Key Takeaways

Marketplace Essentials

Marketplace manifest MUST be at .claude-plugin/marketplace.json (not root)
Each plugin entry needs name, source, and optionally description
Plugin sources can be local paths (./plugin), GitHub repos (github:user/repo), or Git URLs
Add marketplace once: /plugin marketplace add <path-or-url>
Install plugins: /plugin install plugin-name@marketplace-name

Development Workflow

Create marketplace directory with .claude-plugin/marketplace.json
Add plugins with their own plugin.json manifests
Test locally before sharing: /plugin marketplace add /local/path
Use git for version control and distribution
Update workflow: uninstall → reinstall or restart Claude Code

Distribution

Share via git repository URL or local path
Users add marketplace, then browse/install plugins
Marketplace can mix local and remote plugin sources
Use semantic versioning for both marketplace and plugins
Document installation and usage in README

Common Patterns

For detailed examples of personal, team, community, and hybrid marketplace patterns, see reference/best-practices.md.

Weekly Installs

Repository

bbrowning/bbrow…ketplace

GitHub Stars

First Seen

Jan 1, 1970

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

147,400 周安装

Claude 插件市场创建与管理指南：构建团队插件集合与分发平台

🇨🇳中文介绍

Claude 代码市场构建器

什么是市场？

市场目录结构

关键点

市场清单文件 (marketplace.json)

位置和要求

相关 Skills

必需字段

可选元数据字段

向市场添加插件

插件条目结构

包含多个插件的示例

插件来源

本地路径（相对路径）

GitHub 仓库

Git URL

混合来源示例

创建市场：分步指南

步骤 1：创建市场目录

步骤 2：创建市场清单文件

步骤 3：初始化 Git（推荐）

步骤 4：添加插件

步骤 5：本地测试

本地开发工作流程

测试更改

开发迭代

调试

分发和共享

共享你的市场

管理插件生命周期

测试清单

最佳实践

关键要点

市场要点

开发工作流程

分发

常见模式

🇺🇸English

Claude Code Marketplace Builder

What is a Marketplace?

Marketplace Directory Structure

Key Points

Marketplace Manifest (marketplace.json)

Location and Requirements

Required Fields

Optional Metadata Fields

Adding Plugins to Marketplace

Plugin Entry Structure

Example with Multiple Plugins

Plugin Sources

Local Path (Relative)

GitHub Repository

Git URL

Mixed Sources Example

Creating a Marketplace: Step-by-Step

Step 1: Create Marketplace Directory

Step 2: Create Marketplace Manifest

Step 3: Initialize Git (Recommended)

Step 4: Add Plugins

Step 5: Test Locally

Local Development Workflow

Testing Changes

Development Iteration

Debugging

Distribution and Sharing

Sharing Your Marketplace

Managing Plugin Lifecycle

Testing Checklist

Best Practices

Key Takeaways

Marketplace Essentials

Development Workflow

Distribution

Common Patterns

最新 Skills