wiki-lint
Wiki Lint scans a wiki space to surface seven classes of structural and content issues: contradictions between pages, stale claims, orphaned pages, concept gaps, broken wiki-links, weak provenance, and index drift. It returns a severity-grouped triage list with evidence and suggested fixes, but never modifies wiki content—leaving all decisions to the maintainer.
Wiki Lint audits your wiki space for contradictions, broken links, orphans, stale claims, and provenance gaps—then reports findings for triage.
AI-generated summary based on this skill's SKILL.md
Install
paperclipai/paperclip/wiki-lint · repository language: TypeScript
git clone https://github.com/paperclipai/paperclip
cp -r paperclip/packages/plugins/plugin-llm-wiki/skills/wiki-lint ~/.claude/skills/wiki-lintFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does wiki-lint do?
Wiki Lint scans a wiki space to surface seven classes of structural and content issues: contradictions between pages, stale claims, orphaned pages, concept gaps, broken wiki-links, weak provenance, and index drift. It returns a severity-grouped triage list with evidence and suggested fixes, but never modifies wiki content—leaving all decisions to the maintainer.
Can wiki-lint check my wiki for broken links and contradictions?
Yes. Wiki Lint audits your wiki for broken links and contradictions as core functions. It identifies hyperlinks that point to missing or deleted pages and detects logical conflicts between claims across different pages, then reports both in a severity-grouped triage list with evidence.
How does wiki-lint find orphan pages and concept gaps?
Wiki Lint identifies orphan pages—those with no inbound links from other wiki pages—and detects missing concept pages by analyzing provenance chains and link structure. It flags weak provenance (claims lacking proper sourcing) and concept gaps where expected reference pages are absent, helping you spot incomplete documentation.
Does wiki-lint detect wiki index and log drift?
Yes. Wiki Lint detects index and log drift in wiki structure by comparing the actual page graph against expected indices and tracking structural changes. It logs these discrepancies so you can identify when your wiki's organization has drifted from its intended design.
Will wiki-lint modify my wiki content?
No. Wiki Lint is read-only and never modifies wiki content. It triages wiki health issues by severity and provides evidence and suggested fixes, but leaves all decisions and changes to the maintainer. It's designed for audit and validation only.
What license does wiki-lint use?
Wiki Lint is released under the MIT license, allowing free use, modification, and distribution with minimal restrictions.
SKILL.md
rendered from the published skill — quoted content, verbatim
Wiki Lint
Audit, do not edit. Return findings the maintainer (human or agent) can triage.
Inputs
- An operation issue with
operationType: "lint". - The operation issue's target
wikiId,spaceSlug, and space root. Lint only that space unless the issue explicitly says this is a multi-space sweep.
Workflow
- Walk the target space's
wiki/index.mdand wiki tree withwiki_searchandwiki_read_page, always passing the operation issue'swikiIdandspaceSlug. Build a mental map of: pages that exist, pages referenced fromindex.md, pages referenced from other pages, and raw sources. - Check for the seven recurring issues, in this order:
- Contradictions — two pages making incompatible claims about the same entity, decision, or status. Flag both pages, name the conflicting claims, and quote evidence.
- Stale claims — a page asserts X, but a newer source under
raw/has superseded it.
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
packages/plugins/plugin-llm-wiki/skills/wiki-lint/SKILL.md