ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

手把手:3 步把插件提交进 Claude 官方目录,让全球开发者搜到你

手把手:3 步把插件提交进 Claude 官方目录,让全球开发者搜到你 手把手3 步把插件提交进 Claude 官方目录让全球开发者搜到你【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-plugins-officialClaude Code 插件系统发布以来Anthropic 官方维护的插件目录claude-plugins-official就成了全球开发者发现插件的第一入口——它直接内置于 Claude Code 的/plugin面板用户一条命令即可安装无需配置任何市场地址。过去第三方插件作者只能自建市场、自己拉流量如今 Anthropic 开放了官方目录的提交门户并在插件上线后提供页面浏览、搜索来源、分入口安装等数据。这意味着写好插件与被搜到从此是两件可以分别解决的事。本文以官方仓库源码与社区情报为据拆解从账号准备、填表审核到数据优化的完整 3 步流程。为什么进官方目录是插件的分水岭先看这个仓库本身。根目录 README.md 把全部插件分成两块/pluginsAnthropic 内部团队开发维护的官方插件/external_plugins来自合作伙伴与社区的第三方插件。第三方作者的目标就是进入external_plugins/。进入前后的体验差异是决定性的目录外的插件用户得先claude plugin marketplace add注册你的市场再安装而目录内的插件用户直接在 Claude Code 里运行/plugin install {plugin-name}claude-plugins-official或在/plugin Discover标签页里浏览即可。官方目录的Discover入口是随客户端自带的分发渠道等于把你的插件摆在了每一位 Claude Code 用户的货架上。值得注意的是README 开头就有一句醒目的安全提示Anthropic 不控制插件内含的 MCP 服务器、文件或其他软件也无法验证它们是否会按预期工作、是否会被变更。这句提示恰恰说明了官方目录的定位——它不是内容担保而是质量与安全标准的把关闸门通过审批进入目录本身就是对插件可信度的一次背书。第一步提交前的准备——账号与质量门槛社区情报显示官方提交入口面向付费 Claude 计划的开发者。所以在动手之前先确认两件事账号属于付费计划插件本体已经打磨到位。后者才是审核真正的分水岭可以从三个维度自查。结构合规manifest 是硬门槛一个插件是否被 Claude Code 识别取决于一个文件位于插件根目录.claude-plugin/plugin.json的清单。官方参考实现 plugins/example-plugin/README.md 给出的标准结构是example-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件元数据必需 ├── .mcp.json # MCP 服务器配置可选 ├── skills/ # Skill 定义可选 └── commands/ # 斜杠命令可选旧格式plugin.json里只有name是必填的但想通过审核、让用户一眼看懂就得把元数据写全。仓库的清单字段参考 plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md 给出了完整规范其中三条最容易被提交者忽略name是 kebab-case 不可变 slug只允许小写字母、数字和连字符且必须以字母开头、以字母或数字结尾。更关键的是一旦上架name就永远不能改——用户是按这个 slug 安装的改名会让已安装用户报plugin-not-found。想改显示名用displayName确需迁移才走.claude-plugin/marketplace.json的renames映射description控制在 50–200 字符这是用户在目录列表里看到的第一行字要写插件做什么而不是插件怎么做避免空泛表述keywords填 5–10 个功能类别、技术栈、工作流关键词都算这是目录搜索命中率的直接来源。参考官方插件 plugins/example-plugin/.claude-plugin/plugin.json一个合格的清单长这样{ name: example-plugin, description: A comprehensive example plugin demonstrating all Claude Code extension options including commands, agents, skills, hooks, and MCP servers, author: { name: Anthropic, email: supportanthropic.com } }用官方校验器自检与其等审核打回不如提交前先跑一遍自检。仓库里现成的工具就是 plugins/plugin-dev/agents/plugin-validator.md——一个专门的校验 agent会按十步流程检查插件定位.claude-plugin/plugin.json并校验name格式与语义化版本、用 Glob 核对commands/agents/skills/hooks/目录与自动发现、逐文件验证 frontmatter、检查 MCP 配置的stdio/sse/http/ws字段、最后做安全扫描硬编码凭据、非 HTTPS 的 MCP 地址都是红线。输出会按 critical/major/minor 分级并给出修复建议。提交前跑一次能把大部分打回理由消灭在源头。第二步填表、审核、上架结构合规之后提交动作本身很简单按根目录 README.md 的 Contributing 一节外部插件通过官方插件目录提交表单clau.de/plugin-directory-submission发起申请提交后进入 Anthropic 的审核流程通过质量与安全标准的插件才会被合入external_plugins/。审核环节有两点值得提前规划第一审核看的是能不能放心给所有人用。官方目录的插件会被全球开发者安装到各种环境里所以面向分发的插件要比个人工具苛刻得多。仓库的 plugins/plugin-dev/skills/command-development/references/marketplace-considerations.md 直接点出了分发设计的核心跨平台命令里不要写死 macOS 专属的pbcopy之类命令要按uname检测平台并优雅降级最小依赖脚本开头先检查 git、jq、node 等必需工具缺失就给出安装指引而不是直接报错幂等与原子性重复执行不产生副作用失败时能回滚保证用户在不确定状态下的安全。第二名称不可变带来的连带要求。既然name上架后不能改提交前就要把插件目录名、plugin.json的name、以及你打算对外宣传的名字三者统一避免上架后才发现命名不理想而陷入迁移流程。renames机制虽然能自动迁移存量安装但每多一次迁移就多一分用户侧的出错概率。参照已上架的第三方插件 external_plugins/asana/README.md 可以看到生态的成熟度——它已经包含完整的 OAuth 设置引导、迁移说明V1 服务器下线时间都写清楚了和专属安装命令。这种开箱即用、文档完整的插件正是审核方期望看到的形态。第三步上线后如何看数据、持续优化提交门户开放带来的一个重要变化是把用户没看到和看到了不想用这两件事分开呈现给开发者。社区情报披露了官方目录的数据维度插件上线后开发者可以看到页面浏览、用户通过哪些搜索词找到它以及不同产品入口和版本的安装情况。这相当于给了每个插件作者一份曝光—转化漏斗报表。用好这份数据需要做三件事一是盯搜索词反向校准元数据。目录搜索命中的依据就是description和keywords。如果数据显示用户通过 XX 关键词找到你但转化低说明描述与搜索意图有偏差如果某类搜索词流量很大而你从未命中就该在keywords里补上这些词。注意 keywords 不要重复插件名也不要堆砌与功能无关的热词——目录审核对描述与能力的一致性是有要求的。二是按入口拆解安装量。不同产品入口CLI 安装 vs Discover 浏览和不同版本的数据能告诉你用户是从哪条路径认识你的插件的。如果 Discover 浏览多而安装少问题大概率出在列表页的 description 不够有吸引力如果某版本安装率骤降就要排查该版本是否引入了破坏性变更。三是持续迭代而非一劳永逸。仓库 plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md 的维护规范写得很明确每次功能变更按语义化版本递增、同步更新keywords与description、维护 changelog、保持仓库链接有效。上架不是终点——目录里躺着大量插件让用户不断回来更新你的插件靠的是版本节奏和文档维护。最后的检查清单把全文压缩成一张提交前自查表账号与资格确认付费 Claude 计划账号结构合规.claude-plugin/plugin.json存在name为 kebab-case 且确定不改description精炼有力keywords覆盖目标搜索词自检通过跑一遍 plugins/plugin-dev/agents/plugin-validator.md 的校验流程无 critical 问题分发就绪跨平台、依赖可检测、错误可恢复README 与 LICENSE 齐备提交并等待审核通过官方表单提交等待质量与安全审批上线后持续优化跟踪页面浏览、搜索来源、分入口安装数据迭代元数据与版本。Claude 插件生态的分发格局刚刚被官方目录重塑过去是自建市场、自求多福现在是一个入口、全球可见、数据可查。把上述 3 步走完你的插件就真正站上了面向全球开发者的货架。【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-plugins-official创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进