用途:该技能是反面示例(anti-pattern),展示技能编写中违反自包含原则的各种错误做法,官方明确标注“DO NOT COPY(请勿复制)”,用于与正确示例 good-self-contained-skill 对照学习。
主要列出的违规点:使用相对路径(../、../../)引用其他技能文档,在扁平部署(如 ~/.claude/skills/)下会失效;缺失必要内容,只写“见其他技能”而不内联实际代码;把其他技能列为必需依赖;跨技能导入(如 from skills.database_skill import ...);假设层级目录结构;示例不完整;references 目录含跨技能路径;metadata.json 中 requires 列出其他技能且 self_contained 为 false。
正确做法要点:不写相对路径,用技能名称并注明“若已部署”;将必要代码内联为完整可运行示例;其他技能仅列为可选补充(complementary);导入实现自包含;metadata 中 requires 为空、self_contained 为 true。文中给出验证命令示例,如 grep -r "../" skill-name/ 与 grep -r "from skills." skill-name/,并建议复制到临时目录做隔离测试。
适用场景:技能作者编写或审查 SKILL.md 时的反面参考。限制:本身不是可用的功能技能,不应复制其结构;涉及的示例代码与命令仅为演示,具体规范以对应的自包含技能标准文件为准。