Rig Doctor

Check opencode-rig install health and report exact remediation steps.

SKILL.md

GitHub

Rig Doctor

Run rig_doctor and interpret the report. Doctor is read-only.

Checks

  • Plugin is loaded and reports the expected version.
  • package.json, rig.json, src/version.ts, and the README marker agree.
  • Agent files are installed and stamped with the current version.
  • Git is available and a local Git grant state can be read.
  • The artifact root exists or can be created, and is gitignored.
  • Configured gates are detectable.
  • Stale run directories older than the configured TTL are reported.

Use action: "assets" (CLI: opencode-rig doctor --assets) to curate the shipped cards: rig.json roster agreement, skill frontmatter and headings, relative reference links, duplicated prose, and oversized skill or role cards. Roster drift and dead links fail; duplication and size warn.

Response

Report each line as pass, warn, or fail. For every failure, give the exact command or edit that fixes it:

  • Missing or stale agents: opencode-rig init --project (or --upgrade).
  • Missing Git grant: answer Approve always once in the main checkout, or keep per-commit questions.
  • Missing artifact ignore: add .opencode-rig/ to .gitignore.
  • No gates: configure a Makefile or package script, or set options.gates.
  • Asset roster drift: update rig.json and src/resources/agents.json together with the card.
  • Dead reference link or duplicated prose: fix the link, or move the shared text into a reference file.

Do not change files while diagnosing. Do not run paid checks.