How do I install the Wiki Lint skill?

Run npx skillmds@latest add zuoguyoupan2023/wiki-lint 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 Wiki Lint safe to use?

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

Which AI agents work with Wiki Lint?

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 Wiki Lint free to use?

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

Who published Wiki Lint?

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

Wiki Lint by zuoguyoupan2023 — Agent Skill

Name: Wiki Lint
Rating: 4.2 (5 reviews)
Author: zuoguyoupan2023

Wiki Lint

Run a health check on the LLM Wiki vault — mechanical checks (orphans, broken links, stale pages, missing frontmatter, log gap, duplicates) plus semantic checks (contradictions, cross-reference gaps, concepts missing their own page). Outputs a markdown report with suggested actions. Usage /wiki-lint [--stale-days N] [--log-gap-days N]

File contents

/wiki-lint

Health-check the wiki. Surfaces orphan pages, broken wikilinks, stale claims, missing frontmatter, contradictions, and structural drift. Reports, doesn't silently fix — you decide what to change.

Run this weekly, after batch ingests, and always before sharing the wiki.

Usage

/wiki-lint
/wiki-lint --stale-days 60
/wiki-lint --log-gap-days 7

What happens

Pass 1 — Mechanical (scripts)

scripts/lint_wiki.py — orphans, broken links, stale pages, missing frontmatter, duplicate titles, log gap
scripts/graph_analyzer.py — hubs, sinks, connected components, graph stats

Pass 2 — Semantic (LLM reads and thinks)

Contradictions between recently-updated pages
Stale claims superseded by newer sources
Concepts mentioned in plain text across 3+ pages without their own page
Cross-reference gaps (entities mentioned but not wikilinked)
Index drift (index.md out of sync with wiki/)

Pass 3 — Report

A markdown report grouped by severity:

# Wiki lint — <date>

**Total pages:** N  **Components:** N  **Last log:** <date>

## Found
- ⚠️ <N> contradictions (list)
- <N> orphans
- <N> broken links
- <N> stale pages
- ...

## Suggested actions
1. Investigate contradiction between [[sources/a]] and [[sources/b]]
2. Create concept page for "<name>"
3. Fix broken link in [[concepts/x]]
4. Re-ingest [[sources/c]] — stale + contradicted
5. ...

Then appends a lint entry to log.md.

Sub-agent

Dispatches the wiki-linter sub-agent. See agents/wiki-linter.md.

Scripts

engineering/llm-wiki/scripts/lint_wiki.py
engineering/llm-wiki/scripts/graph_analyzer.py
engineering/llm-wiki/scripts/append_log.py

Frequency

Trigger	Pass
Weekly	Mechanical only — fast
After batch ingest	Full (mechanical + semantic)
Monthly	Full + structural review
Before sharing	Full + extra review

Skill Reference

→ engineering/llm-wiki/SKILL.md → engineering/llm-wiki/references/lint-workflow.md

---name: wiki-lintdescription: Run a health check on the LLM Wiki vault — mechanical checks (orphans, broken links, stale pages, missing frontmatter, log gap, duplicates) plus semantic checks (contradictions, cross-reference gaps, concepts missing their own page). Outputs a markdown report with suggested actions. Usage /wiki-lint [--stale-days N] [--log-gap-days N]---# /wiki-lintHealth-check the wiki. Surfaces orphan pages, broken wikilinks, stale claims, missing frontmatter, contradictions, and structural drift. **Reports, doesn't silently fix** — you decide what to change.Run this weekly, after batch ingests, and always before sharing the wiki.## Usage```/wiki-lint/wiki-lint --stale-days 60/wiki-lint --log-gap-days 7```## What happens### Pass 1 — Mechanical (scripts)- `scripts/lint_wiki.py` — orphans, broken links, stale pages, missing frontmatter, duplicate titles, log gap- `scripts/graph_analyzer.py` — hubs, sinks, connected components, graph stats### Pass 2 — Semantic (LLM reads and thinks)- Contradictions between recently-updated pages- Stale claims superseded by newer sources- Concepts mentioned in plain text across 3+ pages without their own page- Cross-reference gaps (entities mentioned but not wikilinked)- Index drift (index.md out of sync with wiki/)### Pass 3 — ReportA markdown report grouped by severity:```markdown# Wiki lint — <date>**Total pages:** N **Components:** N **Last log:** <date>## Found- ⚠️ <N> contradictions (list)- <N> orphans- <N> broken links- <N> stale pages- ...## Suggested actions1. Investigate contradiction between [[sources/a]] and [[sources/b]]2. Create concept page for "<name>"3. Fix broken link in [[concepts/x]]4. Re-ingest [[sources/c]] — stale + contradicted5. ...```Then appends a `lint` entry to `log.md`.## Sub-agentDispatches the `wiki-linter` sub-agent. See `agents/wiki-linter.md`.## Scripts- `engineering/llm-wiki/scripts/lint_wiki.py`- `engineering/llm-wiki/scripts/graph_analyzer.py`- `engineering/llm-wiki/scripts/append_log.py`## Frequency| Trigger | Pass ||---|---|| Weekly | Mechanical only — fast || After batch ingest | Full (mechanical + semantic) || Monthly | Full + structural review || Before sharing | Full + extra review |## Skill Reference→ `engineering/llm-wiki/SKILL.md`→ `engineering/llm-wiki/references/lint-workflow.md`

Frequently asked questions