# 技能仓库维护规则

- 新仓库模板只在 `skills/` 下放置 `README.md`，不会按仓库名称创建默认技能。
- 后续技能放在 `skills/<skill-directory>/` 下，每个技能目录都应包含 `SKILL.md`，并在 frontmatter 中声明 `name` 和 `description`；`name` 是展示名称，目录名只作为路径安全的存放位置。
- `README.md` 是仓库级索引和维护入口；导入、删除、重命名技能后同步更新 README 的技能索引。
- 外部导入会替换 `skills/` 目录，不应覆盖仓库级 `README.md` 和 `AGENTS.md`。
- 长背景资料、示例和外部系统说明放入对应技能的 `references/`，不要塞进 `SKILL.md`。