plugin-structure – Claude 插件结构设计 Skill

Skill 详细介绍

plugin-structure 是 Anthropic 官方 Claude 插件仓库 anthropics/claude-plugins-official 中提供的一个开发指南类 Skill。它的作用是指导用户正确组织 Claude 插件（Plugin）的目录结构、清单文件和组件布局。

它本身不是一个可以独立运行的软件，也不是安装后自动执行任务的工具。它本质上是一套结构规范加开发指导，帮助 Claude Code 在创建、扩展或检查插件时，遵循 Anthropic 官方推荐的插件组织方式。

安装后，Claude Code 在处理插件相关任务时多出一层结构感知能力，例如：

– 识别插件应有的标准目录布局，包括 .claude-plugin/、commands、agents、skills、hooks、MCP 配置等组件的放置位置
– 帮助生成符合规范的 plugin.json 清单文件
– 判断一个已有目录是否符合 Claude 插件结构要求
– 在搭建新插件时给出正确的文件层级建议
– 避免把命令、Agent、Skill 混放在错误位置，导致插件无法被 Claude Code 正确加载

典型使用场景

– 从零创建一个 Claude Code 插件项目，需要知道目录怎么建、清单文件放哪、各个组件分别放在什么地方
– 手上已经有一个插件目录，但 Claude Code 加载时报错或识别不到组件，想排查结构问题
– 想把一批命令、Agent、Skill 打包成一个可分发的插件，需要符合官方规范
– 想为自己的插件写 plugin.json，让 Claude Code 正确读取名称、版本、描述等信息

适合谁

– 正在开发 Claude Code 插件的开发者
– 想把自己的命令、Agent、Skill 打包分发的团队
– 需要对照官方标准检查插件结构的维护者

不适合谁

– 只想使用现成插件、不打算自己开发的普通用户
– 想要一个自动构建、自动打包、自动发布的流水线工具的人（plugin-structure 只负责结构指导，不负责构建发布流程）
– 非 Claude 插件体系的其他类型项目，例如纯 npm 包、VS Code 扩展等

与 Agent 自身能力的区别

Claude Code 本身可以处理文件、写代码、回答插件相关问题。但插件的目录约定、清单字段、组件位置属于一套比较具体的官方规范。plugin-structure 的价值在于把这套规范以 Skill 的形式提供给 Agent，让它在处理插件任务时更稳定地遵循官方结构，减少看起来合理但实际加载不到的情况。

Skill 安全评估

总体判断：plugin-structure 属于 Anthropic 官方仓库中提供的开发指导型 Skill，本身不包含可执行程序、不访问网络、不涉及凭证。它的主要安全关注点是 Agent 在它指导下对本地文件做了什么，而不是 Skill 本身。

来源可信度

该 Skill 来自 Anthropic 官方插件仓库 anthropics/claude-plugins-official，属于一手来源。相比第三方复刻或转载版本，官方仓库版本在内容准确性上更可靠。

权限与行为分析

– 网络访问：该 Skill 不需要联网即可工作，它提供的是一套结构规范。
– Shell 权限：Skill 本身不要求执行 Shell 命令。实际使用中，Claude Code 可能在你授权范围内执行目录创建、文件写入等操作，这些来源于 Agent 的常规能力，而不是 plugin-structure 强制的。
– 文件写入：如果让 Agent 按规范搭建插件结构，它会创建目录和文件，属于正常预期行为。
– API Key / Token：plugin-structure 本身不需要任何凭证。
– 第三方服务：不调用任何第三方 API。

风险点与建议

– 如果只想让它给出结构建议而不真的动文件，可以明确告诉 Agent 只输出结构方案，不要创建文件。
– 如果所在环境对自动创建目录比较敏感，可以关闭 Agent 自动执行文件写入的权限，由你手动按建议操作。
– 不要在插件项目里放敏感凭证再让 Agent 全量扫描。即使是本地操作，也要避免凭证被写入日志或对话上下文。

整体而言，这类 Skill 的风险主要来自 Agent 最终执行了什么动作，而不是 Skill 自身的行为。控制范围建议：仅在需要搭建或整理插件结构时启用，日常对话不需要时无需触发。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Anthropic 官方 Claude 插件仓库，主要面向 Claude Code 使用。它与 Claude Code 的插件机制、目录约定、清单字段在语义上高度一致，因此优先在 Claude Code 中使用。

Anthropic 官方没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 通用工作方式看，在支持 Skill、自定义指令或类似加载机制的 Agent 环境中，例如 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等，通常也可以尝试使用。但插件结构约定本身是 Claude Code 特有的场景，实际效果以对应 Agent 当前版本为准。

二、运行环境 / 依赖

该 Skill 是开发指南型 Skill，不依赖特定编程语言运行时。

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先，其他兼容 Agent 可尝试 |
| Node.js / Python | 非必需，仅当你要开发的插件本身需要时 |
| Git | 非必需，除非你需要管理插件仓库 |
| 网络 | 非必需，Skill 内容本身可离线使用 |

三、权限

– 文件读取：可选，用于检查现有插件结构
– 文件写入：可选，用于创建或调整插件目录
– Shell：可选，由 Agent 常规能力决定，非 Skill 强制
– 网络：不需要

四、账号 / API Key

Skill 本身不需要任何账号、API Key 或 Token。你后续搭建的插件若涉及 MCP 服务器或第三方服务，则可能需要相应的凭证，但那属于你开发目标项目的要求，与 plugin-structure 无关。

最小使用条件

– 一个支持 Skill 加载的 Agent，优先 Claude Code
– 本地具备创建目录和文件的权限（若希望 Agent 直接搭建结构）
– 无需网络，无需凭证

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。

如果你不确定自己的 Agent 如何安装 Skill，可以直接在当前 Agent 中询问：

如何安装 anthropics/claude-plugins-official#plugin-structure？

如何在 Claude Code 中安装 anthropics/claude-plugins-official#plugin-structure？

如何在 Codex 中安装 anthropics/claude-plugins-official#plugin-structure？

如何在 Cursor 中安装 anthropics/claude-plugins-official#plugin-structure？

让当前 Agent 根据自己的 Skill 加载和管理机制给出对应的安装方式。

二、安装后如何使用

安装后，在涉及 Claude 插件结构、目录布局、plugin.json 等问题时，让 Agent 参考 plugin-structure 即可。不需要特定的 Slash Command。

使用 plugin-structure，帮我设计一个 Claude 插件项目，包含一个 command、一个 agent 和一个 skill，给出完整目录结构和 plugin.json 示例。

使用 plugin-structure，检查我当前的插件目录是否符合 Claude 官方插件规范，指出结构问题和不规范的地方。

使用 plugin-structure，为我的插件生成一个符合官方规范的 plugin.json，插件名是 my-tools，版本 0.1.0。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。通常你可以：

– 使用对应 Agent / Skill 管理器提供的删除方式移除该 Skill
– 或直接询问当前 Agent：

如何卸载 anthropics/claude-plugins-official#plugin-structure？

如果没有统一的卸载命令，让 Agent 根据自身的 Skill 管理机制指导移除是最稳妥的方式。

常见问题

1. plugin-structure 会自动帮我创建插件目录吗？

不会自动执行。它提供的是一套结构规范和指导。只有在你的 Agent 具备文件写入权限并接受了你的指令时，才会实际创建文件。

2. 安装后 Claude Code 还是没按插件规范组织项目，是什么原因？

常见原因包括：Agent 未正确加载该 Skill、任务描述不够明确、或 Agent 在生成时忽略了 Skill 上下文。可以尝试在请求里明确说参考 plugin-structure 的规范，或先询问 Agent 是否已加载该 Skill。

3. 它可以用来开发非 Claude 体系的插件吗？

不建议。plugin-structure 的规范针对的是 Claude Code 插件体系，包括目录布局、清单字段、组件位置。开发 npm 包、VS Code 扩展或其他体系插件时参考价值有限。

4. 是否可以在多个 Agent 中同时安装？

可以，只要对应 Agent 支持 Skill 加载机制。多个 Agent 各自维护自己的 Skill 目录，互不影响。

5. 使用它需要联网吗？

不需要。该 Skill 提供的是结构规范内容，使用过程本身不依赖网络。

6. Skill 更新后需要重新安装吗？

如果 Agent 采用自动同步或指向官方仓库的方式加载，通常会跟随更新。如果是手动复制安装到本地，则可能需要重新拉取以获取最新内容。具体以你使用的 Agent 的 Skill 管理方式为准。

7. 中国大陆使用是否有网络要求？

Skill 内容本身不依赖网络，本地使用无特殊网络要求。但首次安装通常需要访问 Skill 来源仓库，此时能否顺利获取取决于你的网络环境。