# Lisa Wiki Lint

> Health-check the LLM Wiki

- Skill: `codyswanngt/lisa-wiki-lint` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add codyswanngt/lisa-wiki-lint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/codyswanngt/lisa-wiki-lint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: codyswanngt (https://skillmd.com/u/codyswanngt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/codyswanngt/lisa-wiki-lint

---


# lisa-wiki-lint

Run the wiki's integrity checks and report findings by severity. Lint is **read-only**: it diagnoses,
it does not repair (use `/ingest`, `/setup`, or `/migrate` to fix).

## What it checks (deterministic core via `scripts/lint-wiki.mjs`)
- **Frontmatter** present/valid where required (per `schema/page-frontmatter.schema.json`).
- **Index coverage**: every page appears in `wiki/index.md`; no index rows point at missing pages.
- **Log coverage**: material changes have `wiki/log.md` entries.
- **Links**: no broken internal links; no orphan pages (unreferenced and unlinked).
- **State ordering**: no state cursor advanced without its source notes + synthesis + index + log.
- **Structure**: files conform to `schema/wiki-structure.schema.json` (canonical locations).
- **Safety**: secret patterns, tenant/contamination terms, stray binaries, child-repo contents
  staged in wrapper mode.

## What it checks (LLM-assisted)
- **Contradictions** between claims; **stale** claims (older than the configured staleness window);
  **coverage gaps** vs the wiki's stated `purpose`.

## Output
A report grouped by severity, with each item marked `PASS | WARN | FAIL`. During phased migration,
legacy issues are reported as `WARN`; in hard-enforcement mode structural/integrity issues are `FAIL`.
Read-only: lint prints the report and does not modify the wiki (it does not write a `LINT` log entry).

## Related
`lisa-wiki-doctor` (broader post-migration verification that runs lint among other checks),
`lisa-wiki-ingest`, `lisa-wiki-setup`.