---

name: skill-installer description: 在生态系统中安装、验证、注册和检验新技能。10 项安全检查、复制、编排器注册和安装后验证。 risk: safe source: community date_added: '2026-03-06' author: renat tags:

• skill-management
• deployment
• validation
• installation tools:
• claude-code
• antigravity
• cursor
• gemini-cli
• codex-cli

---

Skill Installer v3.0

概述

在生态系统中安装、验证、注册和检验新技能。10 项安全检查、复制、编排器注册和安装后验证。

何时使用此技能

• 当用户提到"安装技能"或相关话题时
• 当用户提到"install skill"或相关话题时
• 当用户提到"注册技能"或相关话题时
• 当用户提到"新技能"或相关话题时
• 当用户提到"new skill"或相关话题时
• 当用户提到"添加技能到生态系统"或相关话题时

不使用此技能的情况

• 任务与技能安装无关
• 更简单、更具体的工具可以处理请求
• 用户需要无领域专业知识的通用帮助

工作原理

企业级安装代理，确保每个创建的技能（通过 skill-creator 或手动创建）都能正确安装、注册和验证到生态系统中。包含自动修复、回滚、模拟运行、仪表板和高级诊断。

原则：最大冗余

六层验证确保没有技能安装不当：

| 层级 | 脚本 | 验证内容 | |--------|--------|-------------| | 1 | detect_skills.py | SKILL.md 存在 + 有 frontmatter | | 2 | validate_skill.py | 10 项深度检查 | | 3 | install_skill.py (前) | 冲突、权限、空间、版本 | | 4 | install_skill.py (后) | 文件正确复制 | | 5 | scan_registry.py | 技能出现在注册表中（带去重） | | 6 | package_skill.py | ZIP 有效无反斜杠、非空、完整性检查 |

---

文件位置

C:\Users\renat\skills\skill-installer\
├── SKILL.md              <- 此文件
├── scripts/
│   ├── install_skill.py  <- 主安装器（11 步）+ 所有命令
│   ├── detect_skills.py  <- 未安装技能扫描器
│   ├── validate_skill.py <- 深度验证（10 项检查）
│   ├── package_skill.py  <- ZIP 打包器 + 完整性验证器
│   └── requirements.txt
├── references/
│   └── known-locations.md
└── data/
    ├── install_log.json  <- 操作日志（自动生成，带轮转）
    ├── backups/          <- 覆盖前的备份
    └── staging/          <- 安全复制的临时区域

---

主工作流

当此技能被激活时，按顺序执行以下步骤：

场景 1：Skill-Creator 完成后

skill-creator 刚在某个目录创建了一个技能。执行：

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --source "<技能创建路径>" --force

将 <技能创建路径> 替换为 skill-creator 保存技能的目录。

场景 2：用户要求安装特定技能

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --source "<路径>" [--name "名称覆盖"] [--force]

场景 3：模拟安装不做任何操作（Dry-Run）

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --source "<路径>" --dry-run

精确显示 11 个步骤中每步将执行的操作，不修改任何文件。

场景 4：检测并安装待处理技能

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --detect
python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --detect --auto

扫描已知位置（桌面、下载、临时文件夹、工作区）并显示带时间戳和大小的候选项。使用 --auto 自动安装所有。

场景 5：卸载技能

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --uninstall "技能名称"

从 skills/、.claude/skills/ 中移除，更新注册表并从桌面移除 ZIP。移除前自动备份。

场景 6：健康检查 + 自动修复

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --health
python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --health --repair

--health 验证所有技能：frontmatter、注册、注册表、重复项。 --health --repair 发现问题并自动修复：

• 未注册的技能 -> 注册
• 注册表中缺失的技能 -> 更新
• 重复项 -> 移除

场景 7：回滚（从备份恢复）

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --rollback "技能名称"

找到技能的最新备份并恢复到之前的状态。重新注册并更新注册表。