[Bug]: Hermes Agent not implement

[whaleprince]

Description

Steps to Reproduce

when I ask the hot topic of douyin, the opencli skills are not used

Expected Behavior

use the opencli skill

OpenCLI Version

latest

Node.js Version

Other

Operating System

Linux

Logs / Screenshots

[Astro-Han]

感谢详细的调查和截图。这个问题本质上是 Hermes 的 skill 发现路径配置问题，而不是格式不兼容。

核心结论

OpenCLI 的 SKILL.md 格式与 Hermes 完全兼容（都是 YAML frontmatter + Markdown）。Hermes 找不到 OpenCLI skills 是因为 npx skills add 安装的路径不在 Hermes 默认扫描范围内。

解决方案

方案 A：配置 External Dirs（推荐，一劳永逸）

Hermes 原生支持扫描外部 skill 目录。只需在 ~/.hermes/config.yaml 中配置 external_dirs 指向 OpenCLI 的安装路径：

skills:
  external_dirs:
    - ~/.hermes/profiles/.agents/skills/

配置后重启 Hermes，OpenCLI skills 会自动出现在 skills_list() 中，可以通过 /opencli-browser 等 slash 命令直接调用。

方案 B：Prompt 引导（即时生效）

即使不修改配置，也可以在对话开始时直接引导 Hermes 使用 OpenCLI：

请使用 opencli 命令来获取数据。
1. 先运行 opencli --help 查看所有可用站点（80+ 个）。
2. 使用 opencli <site> <command> 执行查询。
例如：opencli douyin hot, opencli xiaohongshu search "关键词"

Hermes 会直接调用 opencli --help 发现可用命令并执行，不需要加载任何 skill 文件。

为什么 Hermes 走了 curl？

因为 OpenCLI skills 没有被加载到 Hermes 的 skill 列表中，Hermes 不知道 opencli douyin hot 这个命令的存在，所以选择了自己实现（curl）。

• 方案 A 让 Hermes 通过 skill 系统自动发现 OpenCLI 能力。
• 方案 B 让 Hermes 通过 CLI help 直接发现命令。

两种方案都能解决问题，方案 A 更自动化，方案 B 更直接。

[jackwener]

Closing this as an external Hermes configuration issue, not an OpenCLI implementation bug.

OpenCLI skill files use the standard YAML frontmatter + Markdown format. The reported behavior comes from Hermes not scanning the directory where npx skills add installed the OpenCLI skills. The fix is to add that installed skills directory to Hermes External Dirs, or install/symlink the skills into a path Hermes already scans.

No OpenCLI code change is needed for this issue as currently described.