用途：解决同一插件内两处及以上 SKILL.md 或 agent 文件需要相同说明性文本时，共享副本应放在何处的问题。仅适用于同一插件内 2 个以上技能或 agent 共享同一段文本；单个技能内容过长、判断内容应放在 SKILL.md 还是自身 references/、以及共享可执行代码等情形分别由 /plugin-creator:refactor-skill、/plugin-creator:optimize、/plugin-creator:agentskills、/plugin-creator:component-patterns 处理。
主要能力与用法：当文本被 2 个以上技能目录中的组件或 agent 消费时，放入插件根目录 docs/，以相对链接引用；当仅由一个技能及其调度的 agent 使用时，放入该技能的 references/，使用 ${CLAUDE_SKILL_DIR} 形式。若共享文档超过约 3 个，可增加索引技能，使消费者只需激活该技能而非重复路径。索引技能在自身 SKILL.md 中列出每个共享文档： <doc name> — contains <what>; read before <when>. 每个消费者只写一句：For <topic>, activate the /plugin-name:index-skill-name skill.
限制与注意事项：共享内容必须位于随插件分发的目录内，仓库其他位置的文档对已安装消费者不可见。${CLAUDE_PLUGIN_ROOT} 与 ${CLAUDE_SKILL_DIR} 为 Claude Code 专用，可移植技能不适用。使用前需确认引用文件在每种环境中都存在，否则应内联、打包、加保护或删除。编写引用链接前应加载 annotation-format.md，使用符号链接、../ 路径或复制粘贴前应加载 what-not-to-use.md，新增或修改共享引用后应加载 verification.md。其他事实暂未提供。