opencode-skills-doctor 0.6.3 → 0.7.0

package/README.md

@@ -116,6 +116,7 @@ All commands accept `--json`, `--lang en|zh`, `--budget`, `--root` and `--no-glo
 | **DeepSeek Harness** | `install --client dsh` adds the MCP entry and the `skills-doctor-audit` skill |
 | **Claude Code / Codex** | MCP server (`npx -y opencode-skills-doctor mcp`) |
 | **Grok CLI / Cursor** | their skill roots are scanned natively |
+| **Hermes Agent** | MCP entry in `~/.hermes/config.yaml`; `~/.hermes/skills` is scanned |
 
 ## Why it is safe
 

package/docs/README.zh-CN.md

@@ -425,6 +425,19 @@ grok mcp doctor skills-doctor   # ✓ server started · handshake OK · 1 tool d
 
 Grok 的工具命名是 `<server>__<tool>`，所以调用 `skills_doctor__skills_doctor`；配置写入 `~/.grok/config.toml` 的 `[mcp_servers.skills-doctor]`。
 
+### Hermes Agent（Nous Research）
+
+Hermes 从 `~/.hermes/config.yaml` 读取 MCP server：
+
+```yaml
+mcp_servers:
+  skills_doctor:
+    command: "npx"
+    args: ["-y", "opencode-skills-doctor", "mcp"]
+```
+
+Hermes 的工具命名是 `mcp_<server>_<tool>`，即 `mcp_skills_doctor_skills_doctor`。它的 skill 在 `~/.hermes/skills`（含导入的 `openclaw-imports/`）和项目 `.hermes/skills`，`check` 都会扫描。
+
 ## 检测规则
 
 | 规则 | 级别 | 含义 |

package/docs/REFERENCE.md

@@ -10,7 +10,7 @@ Local scanner, linter, fixer, updater and **OpenCode plugin** for agent skills
 |---|---|
 | **What it is** | Audit, fix and update the skills your coding agent loads |
 | **Interfaces** | CLI · OpenCode plugin (1.x / 2.x) · MCP server (Claude Code, Codex, DSH, …) · Grok CLI compatible |
-| **Skill sources** | `.opencode/skills`, `.claude/skills`, `.agents/skills`, `.grok/skills`, `.cursor/skills`, `opencode.json(c)` entries, HTTP catalogs |
+| **Skill sources** | `.opencode/skills`, `.claude/skills`, `.agents/skills`, `.grok/skills`, `.cursor/skills`, `.hermes/skills`, `opencode.json(c)` entries, HTTP catalogs |
 | **What it finds** | shadowed IDs, duplicates, long descriptions, oversized bodies, per-step token budget, broken file references, invalid frontmatter, empty bodies, stale skills |
 | **What it fixes** | archives shadowed definitions (reversible), hides low-frequency skills, syncs catalogs with drift detection |
 | **Reports** | terminal, JSON, or a self-contained HTML report (`--html [file] --open`) |
@@ -408,6 +408,19 @@ grok mcp doctor skills-doctor   # ✓ server started · handshake OK · 1 tool d
 
 Grok namespaces tools as `<server>__<tool>`, so call `skills_doctor__skills_doctor`. The config lands in `~/.grok/config.toml` as `[mcp_servers.skills-doctor]`.
 
+### Hermes Agent (Nous Research)
+
+Hermes reads MCP servers from `~/.hermes/config.yaml`:
+
+```yaml
+mcp_servers:
+  skills_doctor:
+    command: "npx"
+    args: ["-y", "opencode-skills-doctor", "mcp"]
+```
+
+Hermes names tools `mcp_<server>_<tool>`, so the tool is `mcp_skills_doctor_skills_doctor`. Its skills live in `~/.hermes/skills` (including imported `openclaw-imports/`) and project `.hermes/skills`; `check` scans both.
+
 ## Rules
 
 | Rule | Level | Meaning |
@@ -451,9 +464,11 @@ Grok namespaces tools as `<server>__<tool>`, so call `skills_doctor__skills_doct
 6. project `.cursor/skills`
 7. `~/.grok/skills`
 8. project `.grok/skills`
-9. `~/.config/opencode/skills`
-10. project `.opencode/skills`
-11. the `skills` array in `opencode.json(c)` (2.x) or `skills.paths` (1.x); relative paths resolve from the working directory; supports `~/`, absolute paths and HTTP catalogs
+9. `~/.hermes/skills`
+10. project `.hermes/skills`
+11. `~/.config/opencode/skills`
+12. project `.opencode/skills`
+13. the `skills` array in `opencode.json(c)` (2.x) or `skills.paths` (1.x); relative paths resolve from the working directory; supports `~/`, absolute paths and HTTP catalogs
 
 ## JSON output
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-doctor",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Audit, fix and update agent skills: token cost, broken references, shadowed duplicates, HTML reports, catalog sync. CLI, OpenCode plugin, MCP server; works with OpenCode, Claude Code, Codex, Grok CLI, Cursor and DeepSeek Harness.",
   "type": "module",
   "exports": {

package/src/discover.mjs

@@ -120,9 +120,11 @@ function isUnder(parent, child) {
  *  6. 项目 .cursor/skills
  *  7. ~/.grok/skills
  *  8. 项目 .grok/skills
- *  9. ~/.config/opencode/skills
- * 10. 项目 .opencode/skills（项目根 → cwd）
- * 11. opencode.json(c) 里的 skills 数组 / skills.paths
+ *  9. ~/.hermes/skills（Hermes Agent）
+ * 10. 项目 .hermes/skills
+ * 11. ~/.config/opencode/skills
+ * 12. 项目 .opencode/skills（项目根 → cwd）
+ * 13. opencode.json(c) 里的 skills 数组 / skills.paths
  */
 export function discoverSources({ cwd = process.cwd(), home = os.homedir(), includeGlobal = true } = {}) {
   const projectRoot = findProjectRoot(cwd) ?? path.resolve(cwd)
@@ -151,6 +153,9 @@ export function discoverSources({ cwd = process.cwd(), home = os.homedir(), incl
   if (includeGlobal) addSource("grok-global", "global", path.join(home, ".grok", "skills"))
   for (const dir of projectChain) addSource("grok-project", "project", path.join(dir, ".grok", "skills"))
 
+  if (includeGlobal) addSource("hermes-global", "global", path.join(home, ".hermes", "skills"))
+  for (const dir of projectChain) addSource("hermes-project", "project", path.join(dir, ".hermes", "skills"))
+
   if (includeGlobal) addSource("opencode-global", "global", path.join(home, ".config", "opencode", "skills"))
   for (const dir of projectChain) addSource("opencode-project", "project", path.join(dir, ".opencode", "skills"))