plugins/lisa-wiki/skills/lisa-wiki-doctor/SKILL.md
Verify that a wiki is correctly set up and (after migration) fully functional. Runs the deterministic checks plus functional smoke tests, writes a doctor report, and returns an overall verdict. Use as the final gate of /migrate, after /setup, or anytime to confirm wiki health. A repo is not "migrated" until its doctor verdict is READY.
npx skillsauth add codyswanngt/lisa lisa-wiki-doctorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
The post-migration / post-setup verification checklist. Orchestrates the deterministic scripts and
functional smoke tests, then writes wiki/state/migration/doctor-report.json and prints the blocking
items.
Each item is PASS | WARN | FAIL | SKIP; overall is READY | READY_WITH_WARNINGS | NOT_READY. In
hard-enforcement mode (--migration after phase 5) WARN on structure/integrity items is not
allowed; earlier phases allow documented legacy warnings. Build checks (group G) are Lisa/release-only
and SKIP in downstream repos.
validate-config.mjs + structure-manifest conformance;
required files present; schemaVersion set and rendered kernelVersion matches the installed
plugin; README mode recorded (never implicit stub).lint-wiki.mjs + diff-guard.mjs; index/log coverage;
state-order invariant; no broken/orphan links; secret/tenant/contamination/sensitivity scans;
memory sources project-scoped only (no global Codex memory / Chronicle).$lisa-wiki-* on
Codex; each config.staff[] role has its doc page + both subagents; MCP doctor passes or connector
cleanly disabled; external-write connectors skipped unless explicit intent./query returns
a cited answer; /lint clean (or expected phase warnings); /onboard-me completes read-mostly with
no PII; bare /ingest --dry-run lists non-external-write sources; /doctor rerun is idempotent.--with-ci; (Lisa
only) bun run build:plugins builds both artifacts and check:plugins passes.scripts/verify-migration.mjs (which emits the JSON report); this
skill adds the functional smoke tests and interprets phase-allowed warnings.lisa-wiki-migrate, lisa-wiki-lint, lisa-wiki-setup.
development
Prepare a machine — a fresh laptop or a throwaway container — to run coding agents, before any repository exists. Detects which of Lisa's supported agents (Claude Code, Codex, Cursor, OpenCode, Antigravity, Copilot) are already installed, asks which credential manager the machine uses (Bitwarden, 1Password, Doppler, Vault, AWS, or none), and installs only what is missing, each by its vendor's own preferred method. Idempotent, headless by default, and emits a Dockerfile for a spin-up/spin-down environment. Run it on a new machine, in a container, or before cloning anything.
tools
Provision and verify a remote execution environment for a host project — Codex Cloud today, other remote surfaces as they are added. Generates a repository-owned setup script that installs the declared toolchain, materializes secrets through lisa-secrets-access, and runs the project's own hook. Provisions by API where one exists, by driving the vendor console where one does not, and by emitting exact config otherwise — then proves the result with the same read-back regardless of which tier did the work. Use before dispatching any work with executionEnv.
tools
Bring a developer's machine in line with the toolchain the project declares. Reports every tool in remoteEnv.tools that is missing, outdated, or unpinned for this platform, and installs the missing ones into ~/.local/bin from the same pinned, checksummed entries the remote surfaces use — but only when asked. Same manifest, same pins, same installers as lisa-setup-remote-env; what differs is consent and that the pin is a floor rather than an equality. Run it on a fresh checkout, after a manifest change, or when a tool fails at the moment of use.
tools
Route one unit of work to a remote execution surface. Reads the executionEnv parameter (local by default, codex-cloud or claude-web today), verifies the environment is provisioned and bound to this repository, submits a thin skill invocation, records the task identifier to .lisa/remote-dispatch.json, and exits without polling. Routing only — the remote runs the identical skill from the identical repository. Composable and inline: other skills invoke it via the Skill tool rather than users calling it directly.