opencode-skills-doctor 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-doctor",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "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": {
@@ -8,7 +8,8 @@
     "./plugin": "./src/plugin.mjs",
     "./server": "./src/plugin-v1.mjs",
     "./v1": "./src/plugin-v1.mjs",
-    "./audit": "./src/audit.mjs"
+    "./audit": "./src/audit.mjs",
+    "./cli": "./src/cli.mjs"
   },
   "bin": {
     "skills-doctor": "./bin/skills-doctor.mjs"

package/src/audit.mjs

@@ -16,13 +16,14 @@ export function auditSkills({
   configPath = null,
   budget = null,
   staleDays = null,
+  extraDirs = [],
 } = {}) {
   const loaded = loadConfig(cwd, configPath)
   const config = loaded.config
   const resolvedLang = normalizeLang(lang) ?? normalizeLang(config.lang) ?? detectLang()
   const t = translator(resolvedLang)
 
-  const discovered = scanAll(discoverSources({ cwd, includeGlobal }))
+  const discovered = scanAll(discoverSources({ cwd, includeGlobal, extraDirs }))
   const managedInfo = inspectManaged(discovered.scans, { t })
 
   const effectiveBudget = Number.isFinite(budget) && budget > 0 ? budget : config.budget ?? 1200

package/src/cli.mjs

@@ -77,6 +77,7 @@ function parseArgs(argv) {
     profile: null,
     dshHome: null,
     kimiHome: null,
+    extraDirs: [],
     configDir: null,
     noNpm: false,
     html: null,
@@ -167,6 +168,9 @@ function parseArgs(argv) {
       case "--kimi-home":
         options.kimiHome = path.resolve(args[++i] ?? ".")
         break
+      case "--extra-dir":
+        options.extraDirs.push(path.resolve(args[++i] ?? "."))
+        break
       case "--no-npm":
         options.noNpm = true
         break
@@ -814,6 +818,7 @@ export async function main(argv) {
       configPath: options.config,
       budget: options.budget,
       staleDays: options.staleDays,
+      extraDirs: options.extraDirs,
     })
     const plan = planBudget(audit, { descTarget: options.descTarget, steps: options.steps })
     if (options.json) console.log(JSON.stringify(plan, null, 2))
@@ -829,6 +834,7 @@ export async function main(argv) {
       configPath: options.config,
       budget: options.budget,
       staleDays: options.staleDays,
+      extraDirs: options.extraDirs,
     })
     const result = buildCheckResult(audit, options)
 
@@ -855,7 +861,7 @@ export async function main(argv) {
     return
   }
 
-  const discovered = scanAll(discoverSources({ cwd, includeGlobal: options.global }))
+  const discovered = scanAll(discoverSources({ cwd, includeGlobal: options.global, extraDirs: options.extraDirs }))
   const managedInfo = inspectManaged(discovered.scans, { t })
 
   if (options.command === "scan") {
@@ -893,6 +899,7 @@ export async function main(argv) {
       configPath: options.config,
       budget: options.budget,
       staleDays: options.staleDays,
+      extraDirs: options.extraDirs,
     })
     process.exitCode = runFix(audit, options, t)
   }

package/src/discover.mjs

@@ -128,7 +128,7 @@ function isUnder(parent, child) {
  * 14. 项目 .opencode/skills（项目根 → cwd）
  * 15. opencode.json(c) 里的 skills 数组 / skills.paths
  */
-export function discoverSources({ cwd = process.cwd(), home = os.homedir(), includeGlobal = true } = {}) {
+export function discoverSources({ cwd = process.cwd(), home = os.homedir(), includeGlobal = true, extraDirs = [] } = {}) {
   const projectRoot = findProjectRoot(cwd) ?? path.resolve(cwd)
   const projectChain = pathChain(projectRoot, cwd)
   const sources = []
@@ -164,6 +164,12 @@ export function discoverSources({ cwd = process.cwd(), home = os.homedir(), incl
   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"))
 
+  for (const dir of extraDirs) {
+    if (typeof dir !== "string" || !dir.trim()) continue
+    const abs = path.resolve(dir)
+    if (fs.existsSync(abs)) addSource("extra", isUnder(projectRoot, abs) ? "project" : "global", abs)
+  }
+
   const configFiles = []
   if (includeGlobal) {
     for (const file of configCandidates(path.join(home, ".config", "opencode"))) {

package/src/i18n.mjs

@@ -40,6 +40,7 @@ Options:
   --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)
+  --extra-dir <dir>    scan an additional skill directory (repeatable; e.g. ~/.openclaw/skills)
   --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
@@ -269,6 +270,7 @@ Exit codes: 0 ok; 1 errors (and warnings with --strict); 2 bad arguments or runt
   --profile <name>    dsh: 安装到哪个 profile（默认 desktop，或唯一的一个）
   --dsh-home <dir>    dsh: DSH 主目录（默认 ~/.dsh）
   --kimi-home <dir>   kimi: Kimi Code 主目录（默认 ~/.kimi-code 或 $KIMI_CODE_HOME）
+  --extra-dir <dir>   额外扫描一个 skill 目录（可重复；例如 ~/.openclaw/skills）
   --no-npm            install/uninstall: 不执行 npm（1.x）
   --apply             upgrade: 执行 npm install -g opencode-skills-doctor@latest
   --no-update-check   本次运行跳过自动更新检查