opencode-skills-doctor 0.6.3 → 0.8.0

package/README.md

@@ -116,6 +116,8 @@ 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 |
+| **Kimi Code** | `install --client kimi` writes `~/.kimi-code/mcp.json` + the audit skill |
 
 ## Why it is safe
 

package/docs/README.zh-CN.md

@@ -425,6 +425,29 @@ 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` 都会扫描。
+
+### Kimi Code（Moonshot）
+
+一条命令写入 MCP 配置和审计 skill：
+
+```powershell
+npx -y opencode-skills-doctor install --client kimi
+```
+
+它会把 `skills-doctor` 合并进 `~/.kimi-code/mcp.json`（或 `$KIMI_CODE_HOME/mcp.json`），并把 skill 复制到 `$KIMI_CODE_HOME/skills/`。之后开新的 Kimi Code 会话即可，工具名是 `mcp__skills_doctor__skills_doctor`。`check` 也会扫描 `~/.kimi-code/skills` 和项目 `.kimi-code/skills`；`uninstall --client kimi` 反向撤销。
+
 ## 检测规则
 
 | 规则 | 级别 | 含义 |

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`, `.kimi-code/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,29 @@ 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.
+
+### Kimi Code (Moonshot)
+
+One command writes the MCP entry and the audit skill:
+
+```powershell
+npx -y opencode-skills-doctor install --client kimi
+```
+
+It merges `skills-doctor` into `~/.kimi-code/mcp.json` (or `$KIMI_CODE_HOME/mcp.json`) and copies the skill to `$KIMI_CODE_HOME/skills/`. Start a new Kimi Code session afterwards; the tool is `mcp__skills_doctor__skills_doctor` (Kimi uses the same `mcp__<server>__<tool>` shape as Claude Code). `check` also scans `~/.kimi-code/skills` and project `.kimi-code/skills`; `uninstall --client kimi` reverses both.
+
 ## Rules
 
 | Rule | Level | Meaning |
@@ -451,9 +474,13 @@ 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. `~/.kimi-code/skills`
+12. project `.kimi-code/skills`
+13. `~/.config/opencode/skills`
+14. project `.opencode/skills`
+15. 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.8.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/cli.mjs

@@ -10,6 +10,7 @@ import { loadConfig } from "./config.mjs"
 import { startMcpServer } from "./mcp.mjs"
 import { installOpenCode, uninstallOpenCode } from "./install.mjs"
 import { installDsh, uninstallDsh } from "./dsh.mjs"
+import { installKimi, uninstallKimi } from "./kimi.mjs"
 import { writeHtmlReport, openReport } from "./html.mjs"
 import { planBudget } from "./plan.mjs"
 import {
@@ -75,6 +76,7 @@ function parseArgs(argv) {
     client: "auto",
     profile: null,
     dshHome: null,
+    kimiHome: null,
     configDir: null,
     noNpm: false,
     html: null,
@@ -162,6 +164,9 @@ function parseArgs(argv) {
       case "--dsh-home":
         options.dshHome = path.resolve(args[++i] ?? ".")
         break
+      case "--kimi-home":
+        options.kimiHome = path.resolve(args[++i] ?? ".")
+        break
       case "--no-npm":
         options.noNpm = true
         break
@@ -600,8 +605,8 @@ export async function main(argv) {
     process.exit(2)
   }
 
-  if (!["auto", "opencode", "desktop", "dsh"].includes(options.client)) {
-    console.error("unsupported --client: expected auto, opencode, desktop or dsh")
+  if (!["auto", "opencode", "desktop", "dsh", "kimi"].includes(options.client)) {
+    console.error("unsupported --client: expected auto, opencode, desktop, dsh or kimi")
     process.exitCode = 2
     return
   }
@@ -648,6 +653,25 @@ export async function main(argv) {
     return
   }
 
+  if (options.command === "install" && options.client === "kimi") {
+    const result = installKimi({ home: options.kimiHome ?? undefined, dryRun: options.dryRun })
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2))
+    } else {
+      console.log(bold(t("kimi.title")))
+      if (result.home) console.log(dim(t("kimi.home", { dir: result.home })))
+      if (result.mcpFile) console.log(dim(t("kimi.mcp", { file: result.mcpFile })))
+      if (result.skillDir) console.log(dim(t("kimi.skill", { dir: result.skillDir })))
+      if (result.dryRun) console.log(dim(t("install.dryRun")))
+      for (const action of result.actions) console.log(`  · ${action}`)
+      for (const error of result.errors) console.log(red(t("install.error", { error })))
+      console.log("")
+      console.log(result.errors.length ? red(t("kimi.failed")) : dim(t("kimi.restart")))
+    }
+    process.exitCode = result.errors.length ? 1 : 0
+    return
+  }
+
   if (options.command === "install") {
     const result = installOpenCode({
       configDir: options.configDir ?? undefined,
@@ -698,6 +722,23 @@ export async function main(argv) {
     return
   }
 
+  if (options.command === "uninstall" && options.client === "kimi") {
+    const result = uninstallKimi({ home: options.kimiHome ?? undefined, dryRun: options.dryRun })
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2))
+    } else {
+      console.log(bold(t("kimi.uninstallTitle")))
+      if (result.home) console.log(dim(t("kimi.home", { dir: result.home })))
+      if (result.dryRun) console.log(dim(t("install.dryRun")))
+      for (const action of result.actions) console.log(`  · ${action}`)
+      for (const error of result.errors) console.log(red(t("install.error", { error })))
+      console.log("")
+      console.log(result.errors.length ? red(t("kimi.failed")) : dim(t("kimi.restart")))
+    }
+    process.exitCode = result.errors.length ? 1 : 0
+    return
+  }
+
   if (options.command === "uninstall") {
     const result = uninstallOpenCode({
       configDir: options.configDir ?? undefined,

package/src/discover.mjs

@@ -120,9 +120,13 @@ 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. ~/.kimi-code/skills（Kimi Code）
+ * 12. 项目 .kimi-code/skills
+ * 13. ~/.config/opencode/skills
+ * 14. 项目 .opencode/skills（项目根 → cwd）
+ * 15. 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 +155,12 @@ 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("kimi-global", "global", path.join(home, ".kimi-code", "skills"))
+  for (const dir of projectChain) addSource("kimi-project", "project", path.join(dir, ".kimi-code", "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"))
 

package/src/i18n.mjs

@@ -36,9 +36,10 @@ Options:
   --html [file]        check: write a self-contained HTML report (default: skills-report.html)
   --open               check: open the HTML report after writing it
   --config-dir <dir>   install/uninstall: OpenCode config directory (default: ~/.config/opencode)
-  --client <name>      install/uninstall: auto | opencode | desktop | dsh (default auto)
+  --client <name>      install/uninstall: auto | opencode | desktop | dsh | kimi (default auto)
   --profile <name>     dsh: profile to install into (default: desktop, or the only one)
   --dsh-home <dir>     dsh: DSH home directory (default: ~/.dsh)
+  --kimi-home <dir>    kimi: Kimi Code home (default: ~/.kimi-code or $KIMI_CODE_HOME)
   --no-npm             install/uninstall: do not run npm (1.x)
   --apply              upgrade: run npm install -g opencode-skills-doctor@latest
   --no-update-check    skip the automatic update check for this run
@@ -129,6 +130,13 @@ Exit codes: 0 ok; 1 errors (and warnings with --strict); 2 bad arguments or runt
     "dsh.skill": "  skill: {dir}",
     "dsh.restart": "Restart DSH to load the MCP tool (HMR reloads the patch when enabled; the skill updates live).",
     "dsh.failed": "DSH integration failed.",
+    "kimi.title": "Kimi Code integration",
+    "kimi.uninstallTitle": "Remove Kimi Code integration",
+    "kimi.home": "  home: {dir}",
+    "kimi.mcp": "  mcp: {file}",
+    "kimi.skill": "  skill: {dir}",
+    "kimi.restart": "Start a new Kimi Code session to load the MCP tool.",
+    "kimi.failed": "Kimi Code integration failed.",
     "update.toolAvailable":
       "  ! skills-doctor {latest} is available (you have {current}); update with: {cmd}  ·  {url}",
     "upgrade.title": "skills-doctor upgrade",
@@ -257,9 +265,10 @@ Exit codes: 0 ok; 1 errors (and warnings with --strict); 2 bad arguments or runt
   --html [file]       check: 生成自包含 HTML 报告（默认 skills-report.html）
   --open              check: 写完报告后用浏览器打开
   --config-dir <dir>  install/uninstall: OpenCode 配置目录（默认 ~/.config/opencode）
-  --client <name>     install/uninstall: auto | opencode | desktop | dsh（默认 auto）
+  --client <name>     install/uninstall: auto | opencode | desktop | dsh | kimi（默认 auto）
   --profile <name>    dsh: 安装到哪个 profile（默认 desktop，或唯一的一个）
   --dsh-home <dir>    dsh: DSH 主目录（默认 ~/.dsh）
+  --kimi-home <dir>   kimi: Kimi Code 主目录（默认 ~/.kimi-code 或 $KIMI_CODE_HOME）
   --no-npm            install/uninstall: 不执行 npm（1.x）
   --apply             upgrade: 执行 npm install -g opencode-skills-doctor@latest
   --no-update-check   本次运行跳过自动更新检查
@@ -350,6 +359,13 @@ Exit codes: 0 ok; 1 errors (and warnings with --strict); 2 bad arguments or runt
     "dsh.skill": "  skill: {dir}",
     "dsh.restart": "重启 DSH 加载 MCP 工具（启用 HMR 时会自动重载 patch；skill 即时更新）。",
     "dsh.failed": "DSH 集成失败。",
+    "kimi.title": "Kimi Code 集成",
+    "kimi.uninstallTitle": "撤销 Kimi Code 集成",
+    "kimi.home": "  主目录: {dir}",
+    "kimi.mcp": "  mcp: {file}",
+    "kimi.skill": "  skill: {dir}",
+    "kimi.restart": "开一个新的 Kimi Code 会话加载 MCP 工具。",
+    "kimi.failed": "Kimi Code 集成失败。",
     "update.toolAvailable": "  ! skills-doctor 有新版本 {latest}（当前 {current}）；更新：{cmd}  ·  {url}",
     "upgrade.title": "skills-doctor 自更新",
     "upgrade.current": "  当前版本: {version}",

package/src/kimi.mjs

@@ -0,0 +1,121 @@
+import fs from "node:fs"
+import path from "node:path"
+import os from "node:os"
+import { fileURLToPath } from "node:url"
+
+export const SERVER_NAME = "skills-doctor"
+export const SKILL_NAME = "skills-doctor-audit"
+
+const ENTRY = { command: "npx", args: ["-y", "opencode-skills-doctor", "mcp"] }
+
+export function kimiHome(env = process.env) {
+  return env.KIMI_CODE_HOME || path.join(os.homedir(), ".kimi-code")
+}
+
+function skillSourceDir() {
+  return fileURLToPath(new URL("../skills/dsh-skills-doctor", import.meta.url))
+}
+
+function readJson(file) {
+  if (!fs.existsSync(file)) return {}
+  try {
+    return JSON.parse(fs.readFileSync(file, "utf8").replace(/^\uFEFF/, ""))
+  } catch {
+    return null
+  }
+}
+
+function copySkill(source, target, dryRun, act, dry) {
+  const file = path.join(source, "SKILL.md")
+  if (!fs.existsSync(file)) return false
+  const targetFile = path.join(target, "SKILL.md")
+  if (fs.existsSync(targetFile) && fs.readFileSync(targetFile, "utf8") === fs.readFileSync(file, "utf8")) {
+    act(`skill already up to date ${target}`)
+    return true
+  }
+  if (dryRun) {
+    dry(`install skill ${SKILL_NAME} into ${target}`)
+    return true
+  }
+  fs.mkdirSync(target, { recursive: true })
+  fs.copyFileSync(file, targetFile)
+  act(`wrote skill ${targetFile}`)
+  return true
+}
+
+function removeSkill(target, dryRun, act, dry) {
+  const file = path.join(target, "SKILL.md")
+  if (!fs.existsSync(file)) return false
+  if (!fs.readFileSync(file, "utf8").includes("Skill audit workflow")) {
+    act(`kept ${target} (not the generated skill)`)
+    return false
+  }
+  if (dryRun) {
+    dry(`delete skill ${target}`)
+    return true
+  }
+  fs.rmSync(target, { recursive: true, force: true })
+  act(`deleted skill ${target}`)
+  return true
+}
+
+export function installKimi({ home = kimiHome(), dryRun = false } = {}) {
+  const actions = []
+  const errors = []
+  const act = (message) => actions.push(message)
+  const dry = (message) => actions.push(`[dry-run] ${message}`)
+
+  const mcpFile = path.join(home, "mcp.json")
+  const skillDir = path.join(home, "skills", SKILL_NAME)
+
+  const config = readJson(mcpFile)
+  if (config === null) {
+    errors.push(`cannot parse ${mcpFile}`)
+    return { ok: false, home, mcpFile, skillDir, actions, errors, dryRun }
+  }
+  config.mcpServers = config.mcpServers && typeof config.mcpServers === "object" ? config.mcpServers : {}
+
+  const existing = config.mcpServers[SERVER_NAME]
+  const same = existing && existing.command === ENTRY.command && JSON.stringify(existing.args) === JSON.stringify(ENTRY.args)
+  if (same) {
+    act(`${SERVER_NAME} already present in ${mcpFile}`)
+  } else if (dryRun) {
+    dry(`add ${SERVER_NAME} to mcpServers in ${mcpFile}`)
+  } else {
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-")
+    if (fs.existsSync(mcpFile)) fs.copyFileSync(mcpFile, `${mcpFile}.bak-${stamp}`)
+    config.mcpServers[SERVER_NAME] = ENTRY
+    fs.mkdirSync(home, { recursive: true })
+    fs.writeFileSync(mcpFile, JSON.stringify(config, null, 2) + "\n", "utf8")
+    act(`wrote ${SERVER_NAME} to ${mcpFile}`)
+  }
+
+  copySkill(skillSourceDir(), skillDir, dryRun, act, dry)
+  return { ok: errors.length === 0, home, mcpFile, skillDir, actions, errors, dryRun }
+}
+
+export function uninstallKimi({ home = kimiHome(), dryRun = false } = {}) {
+  const actions = []
+  const errors = []
+  const act = (message) => actions.push(message)
+  const dry = (message) => actions.push(`[dry-run] ${message}`)
+
+  const mcpFile = path.join(home, "mcp.json")
+  const skillDir = path.join(home, "skills", SKILL_NAME)
+
+  const config = readJson(mcpFile)
+  if (config && config.mcpServers && config.mcpServers[SERVER_NAME]) {
+    if (dryRun) {
+      dry(`remove ${SERVER_NAME} from ${mcpFile}`)
+    } else {
+      const stamp = new Date().toISOString().replace(/[:.]/g, "-")
+      fs.copyFileSync(mcpFile, `${mcpFile}.bak-${stamp}`)
+      delete config.mcpServers[SERVER_NAME]
+      fs.writeFileSync(mcpFile, JSON.stringify(config, null, 2) + "\n", "utf8")
+      act(`removed ${SERVER_NAME} from ${mcpFile}`)
+    }
+  }
+
+  removeSkill(skillDir, dryRun, act, dry)
+  return { ok: errors.length === 0, home, mcpFile, skillDir, actions, errors, dryRun }
+}