codyswanngt/lisa-wiki-migrate
plugins/lisa-wiki-agy/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.
$ install --global
skillsauthnpx skillsauth add codyswanngt/lisa lisa-wiki-migrateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 24, 2026, 3:51 AM110.7s1 file scanned
SKILL.md
- name:
- lisa-wiki-migrate
- description:
- 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.
lisa-wiki-migrate
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.
Migration invariant — rename, never lose
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.
Phases (per repo; one reviewable change each)
- 0 — Inventory. Profile the repo: mode, root, categories, frontmatter coverage, log/index format, source dirs, state files, connectors, runtime surfaces, MCP config, scripts, PR policy. Write a pre/post manifest mapping every legacy page, source note, doc, command, ingest path, role.
- 1 — Adopt kernel (no content rewrite). Add
wiki/lisa-wiki.config.json, render the contract snapshot, addwiki/state/README.md, run validators in warning mode. - 1b — Documentation absorption & structure.
scripts/absorb-docs.mjsmoves the host repo's own docs (docs/,specs/, top-level docs) intowiki/documentation/, ingests them, and conforms to the structure manifest;scripts/rewrite-refs.mjsrewrites every internal link/citation/index entry (zero dangling links). Keep-in-place files stay at conventional paths. Ask the README mode (defaultrich;stubonly on explicit choice). Wrapper mode moves only host docs, never child-project docs. Idempotent (source fingerprints); parity-checked. - 2 — Runtime consolidation. Replace duplicated local wiki skills with the plugin's; bespoke ones
become
/add-ingestfront-doors or/add-rolesubagents. Claude commands become facades. - 3 — Connector consolidation. Centralize shared connectors (e.g. Slack); keep org-specific ones as contrib/overlay.
- 4 — Normalize by touch. New/touched pages get frontmatter; new logs use the canonical table; legacy stays parseable until deliberately migrated.
- 5 — Hard enforcement. Flip validators to hard-fail (and enable CI) once the baseline is clean.
Finish
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.
Related
lisa-wiki-doctor, lisa-wiki-setup, lisa-wiki-add-ingest, lisa-wiki-add-role.
Related Skills
codyswanngt/lisa-wiki-onboard-me
documentation
VerifiedTrustedCommunity
Onboard a user to the project via its LLM Wiki. Interviews the user about themselves in relation to the project, captures that to project-scoped memory only, then gives a guided tour of what the project is and sample questions they can ask. Use when someone is new to the project or asks to be onboarded. Read-mostly — it does not open PRs or write PII into the wiki.
1SKILL.mdUpdated Jun 5, 2026
codyswanngt/lisa-wiki-lint
development
VerifiedTrustedCommunity
Health-check the LLM Wiki. Reports orphan pages, contradictions, stale claims, broken internal links, missing index/log coverage, structure-manifest violations, and secret/tenant leaks. Use periodically or before hardening a wiki. Read-only — it reports findings, it does not fix them.
1SKILL.mdUpdated Jun 5, 2026
codyswanngt/lisa-wiki-ingest
testing
VerifiedTrustedCommunity
Ingest source material into the LLM Wiki. With an argument (URL, file path, or prompt) it ingests that one source; with no argument it runs a full ingest across every enabled non-external-write source. Routes to the right connector, then runs the ordered pipeline (source note → synthesis → index → log → verify → state → commit/PR). Use whenever new knowledge should enter the wiki.
1SKILL.mdUpdated Jun 5, 2026
codyswanngt/lisa-wiki-doctor
testing
VerifiedTrustedCommunity
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.
1SKILL.mdUpdated Jun 5, 2026