plugins/lisa-wiki-cursor/skills/lisa-wiki-migrate/SKILL.md
Migrate an existing, hand-rolled wiki implementation onto the lisa-wiki kernel — phased and compatibility-first, with a strict no-loss guarantee. Use when adopting lisa-wiki in a repo that already has its own wiki/, ingest skills, docs, or roles. Renaming things into the canonical shape is fine; losing functionality or data is not. Ends by running /doctor.
npx skillsauth add codyswanngt/lisa lisa-wiki-migrateInstall 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.
Move a repo's bespoke wiki onto the kernel without breaking it or producing one giant diff. Each phase is a reviewable change; nothing legacy is deleted until its replacement is parity-checked.
Any unique command, ingest path, or role is migrated as though created via /add-ingest
(front-door skill) or /add-role (subagent); wiki-ingest aliases (*-wiki-ingest, custom /ingest
routers, …) are renamed to the canonical /ingest. Loss of functionality or data is not
acceptable — for each migrated artifact, run the old path and the new path and diff the output
before deleting the old one.
wiki/lisa-wiki.config.json, render the contract
snapshot, add wiki/state/README.md, run validators in warning mode.scripts/absorb-docs.mjs moves the host repo's own
docs (docs/, specs/, top-level docs) into wiki/documentation/, ingests them, and conforms to
the structure manifest; scripts/rewrite-refs.mjs rewrites every internal link/citation/index
entry (zero dangling links). Keep-in-place files stay at conventional paths. Ask the README
mode (default rich; stub only on explicit choice). Wrapper mode moves only host docs, never
child-project docs. Idempotent (source fingerprints); parity-checked./add-ingest front-doors or /add-role subagents. Claude commands become facades.Run lisa-wiki-doctor --migration. The repo is not considered migrated until the verdict is READY
(or a human-approved READY_WITH_WARNINGS). Roll back by reverting the migration change.
lisa-wiki-doctor, lisa-wiki-setup, lisa-wiki-add-ingest, lisa-wiki-add-role.
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.