需通过标准导入机制将外部技能库集成进hermes agent:一、验证格式合规性;二、用hermes skill import命令导入;三、手动复制+显式注册;四、git仓库远程导入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已拥有外部开发或整理的技能库文件,希望将其集成进 Hermes Agent 系统中使用,则需通过标准导入机制完成加载。Hermes Agent 不支持直接运行任意脚本或动态注入未签名技能,所有外部技能必须符合其技能规范结构并经由官方命令注册。以下是具体操作步骤:
一、验证外部技能库格式合规性
Hermes Agent 要求外部技能库为符合 skills/ 目录规范的 YAML 或 JSON 文件集合,每个技能须包含 name、description、steps、tools 四个必需字段,且 steps 中调用的工具名必须已在当前环境注册(如 terminal、browser、file_read)。若技能含自定义工具,须先通过 hermes tool install 完成工具注册。
1、检查技能目录根路径是否存在 manifest.yaml 或 manifest.json 文件,该文件需声明技能集名称、版本及入口文件列表。
2、确认每个技能子目录下存在 skill.yaml(或 skill.json),且其中 name 字段值唯一、不含空格与特殊符号。
3、运行校验命令:hermes skill validate --path /path/to/external/skills,输出 “✅ All skills valid” 表示格式通过。
二、使用 hermes skill import 命令导入
该命令将外部技能库复制至本地 ~/.hermes/skills/ 下对应命名空间,并自动注册到运行时技能索引中,导入后即可在对话中被调用或通过 /skills 查看。
1、执行基础导入:hermes skill import --from /path/to/external/skills --namespace myorg。
2、如需覆盖同名已有技能,添加强制标志:--force。
3、导入完成后,立即刷新技能缓存:hermes skill reload,确保新技能进入可用列表。
三、手动复制 + 显式注册(适用于离线或定制化部署)
当网络受限或需对技能元数据进行精细控制时,可跳过 import 命令,改用文件级操作配合显式注册。此方式绕过自动校验,但要求操作者完全理解 Hermes 技能生命周期。
1、将外部技能目录整体拷贝至:~/.hermes/skills/myorg/(路径中 myorg 为自定义命名空间)。
2、编辑 ~/.hermes/skills/registry.yaml,在 namespaces 列表中新增条目:- name: myorg; path: ~/.hermes/skills/myorg。
3、执行显式注册:hermes skill register --namespace myorg。
4、验证注册结果:hermes skill list --namespace myorg,确认技能名称全部列出且状态为 active。
四、通过 Git 仓库远程导入技能集
Hermes 支持从公开或私有 Git 仓库拉取技能库,适用于团队协同维护或版本化技能分发场景。仓库需为纯技能目录结构,不包含无关构建文件或文档。
1、执行远程导入:hermes skill import --git https://github.com/username/skills-repo.git --ref v1.2.0 --namespace team。
2、若为私有仓库,需提前配置 SSH 密钥或设置 GIT_AUTH_TOKEN 环境变量。
3、导入成功后,Hermes 将自动创建本地克隆副本于 ~/.hermes/skills/_git/team/,并完成注册。











