用途：该技能面向 Claude Code 插件的创建与结构理解，帮助按标准化目录组织插件组件，使插件可被自动发现并正常加载。
主要能力：讲解约定式目录布局与自动发现机制；说明 .claude-plugin/plugin.json 清单驱动配置；涵盖命令、智能体、技能、钩子、MCP 服务器等组件的组织方式；说明显式路径与自动发现组件加载的区别，以及使用 ${CLAUDE_PLUGIN_ROOT} 的可移植路径引用。
结构要点：plugin.json 必须位于 .claude-plugin/ 目录；commands、agents、skills、hooks 等组件目录必须位于插件根目录，不能嵌套在 .claude-plugin/ 内；仅创建实际使用的组件目录；目录与文件名使用 kebab-case。清单中 name 为必填，采用 kebab-case 且全局唯一；version、description、author、homepage、repository、license、keywords 为推荐元数据。自定义组件路径须相对插件根目录、以 ./ 开头、不可用绝对路径，且为补充而非替换默认目录。
组件组织：commands/ 与 agents/ 下为带 YAML frontmatter 的 .md 文件，自动加载；skills/ 下每个技能一个子目录并含 SKILL.md，可附脚本、参考与示例；hooks/hooks.json 或清单内联定义事件处理，支持 PreToolUse、PostToolUse、Stop、SubagentStop、SessionStart、SessionEnd、UserPromptSubmit、PreCompact、Notification；.mcp.json 或清单内联定义 MCP 服务器，插件启用时自动启动。
路径与限制：所有插件内路径引用应使用 ${CLAUDE_PLUGIN_ROOT}，避免硬编码绝对路径、相对工作目录路径或 ~ 快捷方式。组件变更在下一个 Claude Code 会话生效，无需重启。常见问题包括组件未加载、路径解析错误、自动发现失效与插件冲突，可按资料中的排查要点核对目录位置、扩展名、frontmatter 与启用状态。更详细的示例与高级模式见资料所述 references/ 与 examples/ 目录。