Hermes Agent技能库需按core/workflow/data三级目录结构初始化，仅扫描skills/下一级子目录中的skill.yaml；首个技能weekly_report_summary须配置trigger.keywords为中文无空格词组，logic调用内置工具，安装后通过hermes skills install、list和触发测试验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让Hermes Agent记住你常用的查询逻辑、自动处理重复的文档格式、或把上周刚跑通的爬虫流程变成下次一键调用的能力——这需要一套真正属于你自己的技能库，而不是临时拼凑的零散脚本。
初始化技能目录结构
进入 Hermes Agent 项目根目录后，执行：
mkdir -p skills/core skills/workflow skills/data
这三个目录分别对应基础能力、业务流程、数据处理三类技能。不要跳过这一步，【Hermes 只扫描 skills/ 下一级子目录中的 skill.yaml 文件】，如果直接把文件扔进 skills/ 根目录，Agent 将完全忽略它。
这一步操作起来很简单，直接把文件夹建好就行。
创建第一个自定义技能：周报自动汇总
进入 workflow 目录：
cd skills/workflow
新建 skill.yaml 文件，填入以下内容：
name: weekly_report_summary
description: 从指定目录读取本周所有 Markdown 周报，提取“进展”“阻塞”“下周计划”三段内容，合并为一份摘要
version: 1.0.0
trigger:
intent: "生成本周工作摘要"
keywords: ["周报", "本周总结", "汇总"]
tools:
- file_read
- regex_extract
- markdown_to_text
logic: |
files = list_files("reports/", pattern="*.md", last_modified_within_days=7)
summary = ""
for f in files:
content = file_read(f)
summary += regex_extract(content, r"## 进展(.*?)##", flags="s") + "\n"
return summary
注意 trigger.keywords 必须是中文词组，且不能含空格或标点；logic 中的函数名必须是 Hermes 内置工具或已注册的自定义工具名，拼错一个字母就会导致技能加载失败。
安装与验证新技能
第一步：运行技能注册命令
hermes skills install ./skills/workflow
第二步：检查是否成功加载
hermes skills list --verbose
第三步：触发测试（在任意聊天通道中发送）
“生成本周工作摘要”
如果返回“未匹配到技能”，说明 trigger.intent 或 keywords 没有命中当前语义解析结果。此时不要修改 skill.yaml 后立刻重装，先执行 hermes doctor --check skills，它会指出 YAML 语法错误、缺失字段或路径权限问题。
技能分类管理实战策略
方法一：按使用频率分层
高频技能（每日必用）→ 放入 skills/core/，确保首次加载时优先编译
中频技能（每周1–3次）→ 放入 skills/workflow/，依赖触发关键词激活
低频技能（每月≤1次）→ 放入 skills/archive/，并添加 metadata.disabled: true 字段，避免启动时加载拖慢响应
方法二：按数据源隔离
所有对接飞书文档的技能 → 统一加前缀 ls_，如 ls_daily_checkin
所有读写本地 Excel 的技能 → 统一加前缀 xl_，如 xl_sales_merge
所有调用企业内网 API 的技能 → 单独建 skills/internal/ 目录，并在 config.yaml 中设置 internal_only: true
方法三：按版本控制收敛
每个 skills/{category}/ 目录下保留一个 CHANGELOG.md，记录每次 skill.yaml 修改原因、影响范围和回滚方式；主干分支只允许合并通过 hermes test --skill-path=./skills/workflow/weekly_report_summary 的技能。
