用途：帮助作者创建 Claude Code 插件，将技能、代理、钩子和 MCP 服务器打包为可分享的插件包。插件中的技能会被加上命名空间前缀，形如 /plugin-name:skill-name，用于避免不同插件间同名技能的冲突。
主要能力与结构：插件根目录下放置 skills/、commands/、agents/、hooks/、.mcp.json、.lsp.json、settings.json 和 README.md；.claude-plugin/ 目录中只放 plugin.json 清单。关键点是 skills/、agents/、hooks/ 必须位于插件根目录，而不是 .claude-plugin/ 里面。plugin.json 只有 name 和 description 为必填，version 使用语义化版本，还可配置 author、homepage、repository、license。
用法：技能放在 plugin-root/skills/，每个包含带 frontmatter 的 SKILL.md；代理使用与 .claude/agents/ 相同的 Markdown 格式，放在 plugin-root/agents/；钩子写在 hooks/hooks.json，格式与 settings.json 中的钩子一致；MCP 服务器在插件根目录的 .mcp.json 中配置，路径建议使用 ${CLAUDE_PLUGIN_ROOT}；settings.json 当前仅支持 agent 键，启用插件时把指定代理设为主线程。
本地测试：可用 claude --plugin-dir ./my-plugin 直接测试，无需安装；多个插件可重复传 --plugin-dir。用 /help 查看命名空间下的技能、/agents 查看代理、/mcp 查看运行中的 MCP 服务器。改动需重启才能生效。
分发：可推送到 Git 仓库，通过 claude.ai/settings/plugins/submit 提交插件市场，或在 .claude/plugins.json 配置团队市场。个人工作流、单项目或快速实验宜用独立技能，需要团队分享或跨项目复用时再转为插件。
限制与常见问题：不要在 .claude-plugin/ 内放其他组件；plugin.json 缺少 description 会影响发现；MCP 配置避免硬编码路径；应提供 README 和语义化版本说明。完整清单 schema 与目录细节见其引用的文档，资料未提供更多细节。