opencode-skills-doctor 0.9.1 → 0.9.4

package/README.md

@@ -35,7 +35,7 @@
 
 - [The 30-second version](#the-30-second-version) · [Privacy](#privacy-local-only-no-data-collection)
 - [See it](#see-it) · [How it works](#how-it-works) · [Quick start](#quick-start)
-- [Install](#install) · [Commands](#commands) · [Works where you work](#works-where-you-work)
+- [Install](#install) · [Use it in CI](#use-it-in-ci-github-action) · [Commands](#commands) · [Works where you work](#works-where-you-work)
 - [Why it is safe](#why-it-is-safe) · [Development](#development)
 
 ## The 30-second version
@@ -138,6 +138,46 @@ npx -y opencode-skills-doctor mcp
 
 Nothing to configure for **skills discovery**: it reads `.opencode/skills`, `.claude/skills`, `.agents/skills`, `.grok/skills`, `.cursor/skills`, `.hermes/skills`, `.kimi-code/skills`, `.dsh/skills` (plus `$DSH_HOME`) and their user-level equivalents. See the [full reference](docs/REFERENCE.md) for OpenCode 1.x, DSH YAML, Codex TOML and Claude Code details.
 
+## Use it in CI (GitHub Action)
+
+A composite action ships in this repo: no install step, no runtime dependencies —
+it runs the checked-out code directly.
+
+```yaml
+name: skills
+on: [push, pull_request]
+
+permissions:
+  contents: read
+  pull-requests: write # only needed for `comment: true`
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: wangyuchen5110/opencodeplugginprogram@v0.9.4
+        with:
+          budget: "1200"
+          fail-on: warn             # error | warn | never
+          html: skills-report.html  # written and uploaded as an artifact
+          comment: "true"           # post the summary on the PR
+```
+
+It writes a summary to the job page, uploads the HTML report, optionally comments
+on the pull request, and fails the job according to `fail-on`.
+
+| Input | Default | Purpose |
+|---|---|---|
+| `root` | `.` | Directory to audit |
+| `budget` | `1200` | Description tokens paid per model step |
+| `fail-on` | `error` | Fail on `error`, `warn`, or `never` |
+| `extra-args` | — | Extra `check` flags, e.g. `--no-global` |
+| `html` | — | HTML report path; uploaded as an artifact when set |
+| `comment` | `false` | Post/append the summary as a pull request comment |
+
+Outputs: `exit-code`, `error-count`, `warning-count`, `advertised-tokens`.
+
 ## Commands
 
 | Command | What it does |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-doctor",
-  "version": "0.9.1",
+  "version": "0.9.4",
   "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, Hermes Agent, Kimi Code and DeepSeek Harness.",
   "type": "module",
   "exports": {

package/src/desktop.mjs

@@ -21,8 +21,10 @@ export function desktopCandidates(platform = process.platform, env = process.env
   return ["/usr/bin/opencode-desktop", "/usr/local/bin/opencode-desktop", "/opt/OpenCode/opencode-desktop", "/opt/opencode-desktop/opencode-desktop"]
 }
 
-function asarPathFor(exe) {
-  if (process.platform === "darwin" || exe.includes(".app")) {
+function asarPathFor(exe, platform = process.platform) {
+  // Callers may probe another platform (tests, cross-platform tooling), so use
+  // the requested platform instead of the host one.
+  if (platform === "darwin" || exe.includes(".app")) {
     return path.join(path.dirname(path.dirname(path.dirname(path.dirname(exe)))), "Resources", "app.asar")
   }
   return path.join(path.dirname(exe), "resources", "app.asar")
@@ -71,8 +73,9 @@ export function readAsarVersion(asarFile) {
 export function detectDesktop({ platform = process.platform, env = process.env, home = os.homedir() } = {}) {
   for (const exe of desktopCandidates(platform, env, home)) {
     if (!fs.existsSync(exe)) continue
-    const version = readAsarVersion(asarPathFor(exe))
-    return { installed: true, exe, version, asar: asarPathFor(exe) }
+    const asar = asarPathFor(exe, platform)
+    const version = readAsarVersion(asar)
+    return { installed: true, exe, version, asar }
   }
   return { installed: false, exe: null, version: null, asar: null }
 }