需通过标准导入机制将外部技能库集成进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/，并完成注册。
