# Lint

> Audit and safely maintain an LLM Wiki vault. Use whenever the user invokes `/lint`, asks to check wiki quality or health, or asks to find and optionally repair broken links, missing frontmatter, stale pages, orphan pages, source drift, or duplicate topics.

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

---


# Lint an LLM Wiki

Audit structural integrity and knowledge quality. Read `wiki-schema.md` first;
it is the authority for page types, fields, naming, and tags.

## Scan

Inspect all `wiki/` pages and `sources/` files, then use `llm-wiki graph` to
cross-check the wikilink graph. Report these categories:

- **Structural:** broken links, orphan pages, wanted pages, missing required
  frontmatter, missing aliases, naming violations, and duplicate topics.
- **Content:** conflicting claims, stale pages whose sources changed, unsourced
  claims, and pages too shallow to be useful.
- **Sources:** unreferenced or untracked source material and source drift.

## Report

Present the findings before changing files unless the user explicitly passed
`--fix`. Use this structure:

```markdown
## Lint Report — YYYY-MM-DD

### Summary
- Total pages: N | Total sources: N
- Issues: N (critical: X, warning: Y, info: Z)

### Critical
### Warning
### Info
```

Always write the same result in `.llm-wiki/lint-result.yaml` with date,
summary counts, and issue objects (`type`, `severity`, `page`, `detail`).

## Fixes

With `--fix`, repair only safe, evidence-preserving issues: add missing
frontmatter defaults, repair or remove plainly invalid links, add clearly
relevant backlinks, and merge unambiguous duplicates while retaining aliases.
Never auto-resolve a contradiction. Do not edit raw files under `sources/`.

Record fixes and unresolved findings in `wiki-log.md`. Run `llm-wiki sync`
when changes were made.