How do I install the Lisa Wiki Doctor skill?

Run npx skillmds@latest add codyswanngt/lisa-wiki-doctor-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Lisa Wiki Doctor safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Lisa Wiki Doctor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Lisa Wiki Doctor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Lisa Wiki Doctor?

codyswanngt (@codyswanngt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Lisa Wiki Doctor by codyswanngt — Agent Skill

Name: Lisa Wiki Doctor
Author: codyswanngt

Lisa Wiki Doctor

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.

codyswanngt Updated Sep 21, 2026

File contents

lisa-wiki-doctor

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.

Verdict

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.

Checklist

A. Structure & config (deterministic): validate-config.mjs + structure-manifest conformance; required files present; schemaVersion set and rendered kernelVersion matches the installed plugin; README mode recorded (never implicit stub).
B. Integrity & safety (deterministic): 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).
C. No-loss / parity: pre/post manifest maps every legacy page/doc/command/ingest-path/role; nothing dropped; docs absorption idempotent with zero dangling links; old README ingested before rewrite; no leftover project-local machinery except generated overlays + role agents.
D. Runtime surfaces (both runtimes): canonical commands resolve on Claude; $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.
E. Functional smoke (skill-orchestrated): targeted ingest of a small fixture exercises the full ordered pipeline (in the migration branch or dry/scratch mode — no extra PR); /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.
F. Mode-specific: embedded self-ingest at HEAD; wrapper child-docs ingested-not-moved and not staged; standalone/subdir path resolution; no-PR mode does not require PR creation.
G. Git / CI / distribution (deterministic): clean working tree (only intended changes); no secrets/OAuth committed; PR/auto-merge policy honored; CI validator green if --with-ci; (Lisa only) bun run build:plugins builds both artifacts and check:plugins passes.

Notes

Deterministic items are run by scripts/verify-migration.mjs (which emits the JSON report); this skill adds the functional smoke tests and interprets phase-allowed warnings.
Read-mostly: the smoke tests must not open an extra PR or perform external writes.

lisa-wiki-migrate, lisa-wiki-lint, lisa-wiki-setup.

---name: lisa-wiki-doctor-2description: 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.---# lisa-wiki-doctorThe post-migration / post-setup verification checklist. Orchestrates the deterministic scripts andfunctional smoke tests, then writes `wiki/state/migration/doctor-report.json` and prints the blockingitems.## VerdictEach item is `PASS | WARN | FAIL | SKIP`; overall is `READY | READY_WITH_WARNINGS | NOT_READY`. Inhard-enforcement mode (`--migration` after phase 5) `WARN` on structure/integrity items is notallowed; earlier phases allow documented legacy warnings. Build checks (group G) are Lisa/release-onlyand `SKIP` in downstream repos.## Checklist- **A. Structure & config** (deterministic): `validate-config.mjs` + structure-manifest conformance; required files present; `schemaVersion` set and rendered `kernelVersion` matches the installed plugin; README mode recorded (never implicit `stub`).- **B. Integrity & safety** (deterministic): `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).- **C. No-loss / parity**: pre/post manifest maps every legacy page/doc/command/ingest-path/role; nothing dropped; docs absorption idempotent with zero dangling links; old README ingested before rewrite; no leftover project-local machinery except generated overlays + role agents.- **D. Runtime surfaces** (both runtimes): canonical commands resolve on Claude; `$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.- **E. Functional smoke** (skill-orchestrated): targeted ingest of a small fixture exercises the full ordered pipeline (in the migration branch or dry/scratch mode — **no extra PR**); `/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.- **F. Mode-specific**: embedded self-ingest at HEAD; wrapper child-docs ingested-not-moved and not staged; standalone/subdir path resolution; no-PR mode does not require PR creation.- **G. Git / CI / distribution** (deterministic): clean working tree (only intended changes); no secrets/OAuth committed; PR/auto-merge policy honored; CI validator green if `--with-ci`; (Lisa only) `bun run build:plugins` builds both artifacts and `check:plugins` passes.## Notes- Deterministic items are run by `scripts/verify-migration.mjs` (which emits the JSON report); this skill adds the functional smoke tests and interprets phase-allowed warnings.- Read-mostly: the smoke tests must not open an extra PR or perform external writes.## Related`lisa-wiki-migrate`, `lisa-wiki-lint`, `lisa-wiki-setup`.

Frequently asked questions