reviewing-plugin-marketplace

用途

该技能用于审查 Claude Code 插件市场与插件配置是否符合官方最佳实践及常见规范的规避要求。适用于分析 marketplace.json 和 plugin.json 文件的结构问题时使用。

自动化审查：运行 bash scripts/verify-marketplace.sh [marketplace-directory]，自动检查 marketplace.json 结构、Skills 路径校验、Git remote URL、README.md 中的仓库引用，以及 plugin.json 是否存在（存在则警告）。
手动审查：向用户索取市场目录（如 .claude-plugin/），读取 marketplace.json 与 plugin.json（若存在），对照官方格式与常见错误检查，并给出带优先级的详细反馈。
结构校验：检查 marketplace.json 的必填字段与每个插件的必填字段，包括 name、source（必须以 ./ 开头）、description。
路径校验：验证 source 路径与 skills 路径是否真实存在，并检查 source 目录是否包含带 SKILL.md 文件的 skills 子目录。
一致性检查：比对 marketplace.json、plugin.json、README.md 与 git remote 中的仓库 URL 是否指向同一仓库；检查 README.md 是否记录了 marketplace.json 中的全部技能、项目结构图是否与实际文件一致、权限配置是否涵盖所有技能。
冲突检查：提示 Anthropic 官方格式仅使用 marketplace.json，同时存在两者可能造成混淆；若两者都存在，需确保名称一致。

自动化方式：运行验证脚本 bash scripts/verify-marketplace.sh [marketplace-directory]。

手动方式分五步：

读取配置文件：.claude-plugin/marketplace.json（市场必需）、.claude-plugin/plugin.json（可选，检查是否存在）、README.md（用于仓库 URL 一致性）、Git remote URL（若在 git 仓库中）。
校验 marketplace.json 结构：必填字段包括 name、owner.name、plugins（数组）；每个插件需有 name、source、description；推荐字段包括 metadata.description、metadata.version；skills 字段指定 skills 目录路径（根相对，如 "./plugins/plugin-name/skills/"）；strict: false 仅当插件缺少 plugin.json 时才需要。
检查常见错误：仓库 URL 一致性、source 路径校验、skills 路径校验、plugin.json 冲突、README.md 一致性（技能文档、项目结构准确性、权限部分完整性、仓库引用）。
与 Anthropic 格式对比：marketplace.json 位于 .claude-plugin/marketplace.json，不使用 plugin.json，source 指向插件目录且以 ./ 开头，skills 字段为根相对路径。
生成反馈：按优先级组织为 Critical Issues（破坏功能）、Important Issues（造成混淆）、Suggestions（最佳实践），并给出合规评分。

适用于需要检查 Claude Code 插件市场配置是否合规、排查插件未加载或找不到插件等问题、以及让配置对齐 Anthropic 官方格式的场景。根据实际经验，三大高频问题是：

enabledPlugins 格式错误（破坏功能）：使用数组 ["plugin@marketplace"] 而非对象 {"plugin@marketplace": true}，导致插件不加载、无法激活，这是“插件不工作”的首要原因。
仓库 URL 不匹配：README/settings 使用的 owner 与实际 git remote 不同，导致“Plugin 'name' not found in marketplace”。
source 路径错误：指向不存在的目录，导致插件无法找到。

资料未提供该技能的收费、价格、平台支持范围或效果保障等信息。审查范围限于上述配置文件的格式与一致性问题，其他功能暂未提供说明。