用途:批量删除本机各 AI 代理已安装的 agent skills,仅保留用户指定项。适用于一个技能在多个代理路径下以不同名字、符号链接或 git 克隆形式重复存在的情况。
主要能力:先做只读盘点,遍历常见技能根目录(如 ~/.claude/skills、~/.agents/skills、~/.cursor/skills、~/.copilot/skills、~/.config/opencode/skills、~/.codeium/windsurf/skills、~/.gemini/skills),区分真实目录、符号链接/junction 及其目标,识别位于 git 工作树中的克隆并列为受保护源。解析保留清单(self、collection、none 或指定文件夹名),归档真实目录后,在明确确认下先删链接再删真实目录,最后重新盘点验证并输出报告。
使用方式:/awesome-skills-purge [--keep collection|self|none|<name>[,<name>…]] [--scope global|project <path>|all] [--no-backup]。无参数时先出盘点并询问保留清单。默认 --keep self,默认先备份归档,archive 路径会报告且不删除。
限制:删除前必须显式确认;链接只删链接本身,不递归其目标;git 工作树内目录永不删除;Windows 上运行中代理可能占用文件导致部分删除失败,需关闭后重跑;插件自带技能、网页端托管技能及超出 scope 的项目目录需另行处理;删除后需重启代理,克隆仍在磁盘可重新安装。若命令执行中途删除数为零应停止并重新盘点,不得强制升级。