用途：面向 Claude Code 插件的校验与最佳实践指南，当用户要求校验插件结构、审查 manifest、检查 frontmatter 合规性或验证工具调用时使用。主要内容以导航指南形式呈现，细节放在 references/ 目录。
主要能力：按五项顺序检查覆盖插件质量维度——结构（文件模式、目录布局、kebab-case 命名）、manifest（plugin.json 必填字段与 schema）、frontmatter（组件 YAML 与第三人称描述）、工具调用（隐式与显式调用反模式检测）、token 预算（渐进式披露，SKILL.md 正文低于 5k tokens）。还给出组件选型指引（指令型/知识型技能、agents、MCP、LSP、hooks、monitors、themes、输出样式），以及要求级别（RFC 2119 的 MUST/SHOULD/MAY）。
使用方式：对插件运行 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-plugin.py <plugin-path>；只跑特定检查时追加 --check=manifest,frontmatter；加 -v 可查看全部通过项。
关键约定：插件组件使用 plugin-name:component-name 限定名；allowed-tools 不使用裸 Bash，而是 Bash(git:*) 等过滤写法；MCP 工具用自然语言描述意图，不写死 MCP 工具名；MCP 配置不得硬编码密钥，使用 ${ENV_VAR}。技能按类型命名，指令型用 use-<action> 前缀，知识型用 using-<topic> 前缀。
适用场景与限制：适合插件作者在开发与审查阶段核对结构、命名、frontmatter 和 token 预算，以及选择组件类型。资料未提供安装方式、收费与具体价格、运行环境版本等事实，暂未提供。Agent Teams 为实验性功能，需 export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 启用。