若无法查找、安装或移除技能,需检查索引同步、缓存异常或路径配置;按搜索→安装→列出→禁用/启用→删除五步完成全生命周期管理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已成功安装并运行 Hermes Agent,但无法查找、安装或移除特定技能(Skills),则可能是由于技能索引未同步、本地 Hub 缓存异常或技能路径配置错误。以下是完成技能全生命周期管理的实操步骤:
一、搜索可用技能
技能搜索依赖于 Hermes Agent 内置的 Skills Hub 索引服务,该服务默认连接 agentskills.io 开放标准仓库,支持按关键词、分类、作者、兼容性标签进行全文匹配。首次搜索前需确保网络可访问公共 Hub 且本地索引已初始化。
1、启动 Hermes Agent CLI:输入 hermes 命令进入交互模式。
2、执行技能搜索命令:输入 /skill search web-scrape(替换为任意关键词)。
3、等待返回结果列表,每项包含技能名称、版本号、作者 ID、简要描述及兼容性标识(如 ✅ Hermes v0.8+)。
4、若返回空结果或提示“Hub unreachable”,请运行 hermes hub sync --force 强制刷新远程索引缓存。
二、安装指定技能
安装操作将从远程 Hub 下载技能元数据(YAML 描述文件)、执行安全扫描,并将其持久化至 ~/.hermes/skills/ 目录;安装后技能立即可用于当前会话及后续自动调用。
1、确认目标技能名称与版本,例如 web-scraper@v1.3.0。
2、在 CLI 中输入安装指令:/skill install web-scraper@v1.3.0。
3、系统将自动校验签名、扫描潜在危险指令(如 shell 命令注入、未授权文件写入),并通过 /skill list --pending 查看待批准安装项。
4、如启用命令审批机制,需手动输入 /approve 完成最终部署。
三、列出已安装技能
已安装技能以独立目录形式存在于本地文件系统,其元数据由 Hermes Agent 统一注册至内存技能注册表;该步骤用于验证安装状态、识别冲突版本及定位调试路径。
1、在 CLI 中执行:/skill list。
2、输出中每行显示技能名、当前激活版本、安装时间戳及状态标识(如 ACTIVE、DISABLED 或 BROKEN)。
3、若需查看某技能详细信息,运行:/skill info file-manager(替换为实际技能名)。
4、如发现重复版本(如 note-taker@v1.1.0 和 note-taker@v1.2.0 并存),系统默认启用高版本,低版本保留在磁盘但不加载。
四、禁用与启用技能
禁用操作仅解除技能在运行时的注册状态,不删除文件或元数据,适用于临时关闭高风险技能或测试兼容性;启用操作则重新触发加载流程并校验依赖完整性。
1、禁用指定技能:/skill disable calendar-sync。
2、确认状态变更:再次执行 /skill list,对应条目应显示 DISABLED。
3、启用已被禁用的技能:/skill enable calendar-sync。
4、如依赖缺失(如缺少 ics Python 包),CLI 将提示具体缺失项并中断启用流程。
五、彻底删除技能
删除操作将永久移除技能目录、元数据文件及所有关联缓存条目,不可逆;执行前系统会强制要求二次确认,并跳过已禁用技能的依赖检查。
1、在 CLI 中输入删除指令:/skill remove pdf-converter@v0.9.2。
2、终端将显示待删除路径:~/.hermes/skills/pdf-converter@v0.9.2/,并提示“Confirm deletion? (y/N)”。
3、键入 y 并回车,系统开始递归删除目录及注册表条目。
4、删除完成后,执行 /skill list | grep pdf-converter 应无任何输出。











