researchforge-doctor · git:20260713.896358d · 2026-07-13 · sha256 be1d308aaa4866d1

researchforge-doctor git:20260713.896358dA

Immutable. This exact content never changes and is served at /api/v1/blob/be1d308aaa4866d1.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_4262lcjv4ihgrcec/be1d308aaa4866d1481973c858ff4afe6ae7e46ce7e53305cedfcfa2770edcdc.json

Then /plugin install researchforge-doctor@markdownregistry-4262lcjv4ihgrcec in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: researchforge-doctor
description: Check that ResearchForge's dependencies (git, Python, optionally Docker) are available and explain any failures. Use when setup fails, before starting a project, or when the user asks whether their machine is ready.
---

# Diagnose the ResearchForge environment

```bash
researchforge doctor --json
```

Each entry has `name`, `ok`, `required`, `detail`, and an optional `hint`.

- All required checks pass → say the environment is ready and continue.
- A required check fails → explain the failure in plain language, show the
  `hint`, and stop: later commands will refuse to run. Do not try to work
  around a failed required check.
- An optional check fails (e.g. Docker) → note the limitation: experiments
  fall back to `.venv` mode, which is dependency isolation, not a security
  sandbox — only trusted repositories should be run there.

If skills seem out of date or missing, `researchforge claude status --json`
reports the installed/modified/missing state of each skill and
`researchforge claude install` refreshes unmodified ones.

## Rules

- The Python engine is the boundary: never work around a validation error, a
  protected path, or an approval gate — fix the artifact or ask the user.
- Approvals belong to the user: never pass `--yes` or type a confirmation
  unless the user explicitly approved that step in this conversation.
- Ground every summary in stored data: quote only numbers returned by
  `--json` output or files under `.researchforge/` — never invent metrics.