用途:指导创建和整理 Claude Code 插件的目录结构,使插件能被自动发现并与 Claude Code 正确集成。
主要能力:说明约定式目录布局(.claude-plugin/plugin.json 为必需清单,commands、agents、skills、hooks 等组件目录须位于插件根目录而非 .claude-plugin 内);清单中可配置元数据(name 必需,version、description、author、homepage、repository、license、keywords 等可选)与自定义组件路径(相对根目录、以 ./ 开头、不支持绝对路径,且自定义路径是补充而非替换默认目录);各组件的文件格式与自动发现机制;hooks 支持的事件(PreToolUse、PostToolUse、Stop、SubagentStop、SessionStart、SessionEnd、UserPromptSubmit、PreCompact、Notification);MCP 服务器配置。
使用方式:按示例布局组织组件,命令与代理为带 YAML frontmatter 的 .md 文件,技能为含 SKILL.md 的子目录,钩子与 MCP 用 JSON 配置;所有插件内部路径引用统一使用 ${CLAUDE_PLUGIN_ROOT},例如 "bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate.sh"。命名统一使用 kebab-case。
适用场景:需要编写、重构或排查 Claude Code 插件加载问题的开发者。
限制:资料未提供该技能的安装命令、收费与具体版本信息。排错提示包括检查文件位置与扩展名、frontmatter 语法、路径写法,并确认插件已启用、必要时重启 Claude Code 重新加载配置。