# Skill Backup > Maintain a personal skills index repository such as L-yifan/skills. Use when the user wants to back up a self-built skill, add an external skill reference, or sync and publish their personal skills index. - Skill: `l-yifan/skill-backup` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add l-yifan/skill-backup` - Raw SKILL.md: https://api.skillmd.com/api/skills/l-yifan/skill-backup/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: l-yifan (https://skillmd.com/u/l-yifan) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/l-yifan/skill-backup --- # Skill Backup 个人技能索引分为两类：**自建技能**备份其源文件；**外部技能**只在 README 中保留上游引用与安装信息。 托管安装目录（如 `.agents/skills/` 或插件缓存）不是可靠的技能源：它们可能被包管理器覆盖或删除。若用户在其中完成了修改，先复制到用户拥有的目录，再将该目录作为后续备份源。 ## Workflow ### Step 1：定位索引仓库并分类 优先使用用户给出的本地 checkout 或仓库地址；否则查找常见本地 clone，必要时使用 `L-yifan/skills` 建立具名临时 clone。记录实际工作目录、是否为本次创建的临时 clone，以及其初始 `git status`。用户提供的 checkout 永远不是临时目录，不得自动删除。 随后分类：GitHub URL、市场链接或第三方技能默认是**外部技能**；本地目录、用户新建或为该仓库编写的技能是**自建技能**。用户明确要求 vendoring 时，按自建技能处理。 完成条件：已确定一个可写的索引仓库工作目录、初始工作树状态和唯一分类。 ### Step 2A：记录外部技能 读取上游 `SKILL.md` 与其官方安装说明；在 README 的外部技能表中添加或更新一行，保留来源和可验证的安装命令。描述遵循所在表格的语言与格式。 完成条件：README 条目能追溯到上游；安装命令来自上游而非猜测。 ### Step 2B：核验自建技能源 优先使用用户指定的、用户拥有的源目录。需要寻找副本时，先列出每个候选的文件清单，再与仓库旧版本比较；选择“文件完整且符合本次改动意图”的候选，修改时间只用于同等候选的决胜。托管安装目录只能作为恢复候选，不能作为唯一可信源。 若源目录缺少仓库旧版本中的文件，先判定该差异是有意删除还是源文件丢失；无法判定时保留旧文件并向用户报告。 完成条件：已记录选中的源目录及依据；`SKILL.md`、reference 和 script 的文件清单均已与旧版本核验。若为托管安装目录建立了用户拥有的中转源副本，也记录其路径和“仅本次中转”身份。 ### Step 3：同步自建技能与 README 将经核验的完整源目录同步到索引仓库中的技能目录，并只应用已确认的删除。更新 README 的自建技能条目、描述和版本日期（如该索引使用版本日期）。 完成条件：目标目录包含全部已核验文件；README 条目反映当前技能；仓库 diff 不包含未解释的删除或额外文件。 ### Step 4：验证、发布与交付 检查 `git diff` 与 `git status --short`；验证 README 表格列数一致；对自建技能验证 frontmatter 的 `name` 与 `description` 均存在且非空。仅在用户要求时提交、推送或创建 PR。 **临时目录收尾规则：** - 若本次创建了临时 clone 或中转源副本，且用户要求的推送已成功：确认提交已在远端、`git status --short` 为空、分支不再领先远端后，自动删除这两个临时目录。 - 若未获授权提交/推送、推送失败，或尚有未提交变更：保留临时 clone 与中转源副本，明确报告路径和保留原因，不能为了清理而丢弃未发布内容。 - 用户明确提供的 checkout、原始自建技能目录及其他预先存在的目录永远不得自动删除。 - 清理前先解析每个目标的绝对路径，确认其位于本次创建的临时父目录内；清理后验证路径不存在。 最终回复列出已改变的文件、发布状态和完整安装命令：自建技能使用实际索引仓库与同步目录名；外部技能仅使用上游已验证命令。未推送的自建技能须说明命令会在推送后取得本次版本；没有可靠外部命令时明确说明不可安全推断。 完成条件：所有变更均已验证并说明；临时目录已根据上述收尾规则清理，或说明保留路径与原因；交付中不存在猜测的安装命令。