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.md and wiki tree with wiki_search and wiki_read_page, always passing the operation issue's wikiId and spaceSlug. Build a mental map of: pages that exist, pages referenced from index.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. Flag the older page; never overwrite.
- Orphan pages — a
wiki/ page is not linked from index.md and not referenced from any other wiki page. Either it should be linked, removed, or merged.
- Concept gaps — a term appears on three or more pages but has no dedicated
wiki/concepts/<slug>.md. Recommend creating one.
- Broken
[[wiki-links]] — a link target file does not exist.
- Weak provenance — a non-trivial claim is uncited or cites only the wiki itself in a circle. The original source ref should be findable.
- Index / log drift — pages exist that are not in
index.md, or index.md lists pages that no longer exist. Recent operations in wiki/log.md that did not produce a corresponding page change.
- Return a triage list, grouped by severity:
- critical: contradictions, broken links to active pages, fabricated citations.
- medium: stale claims, weak provenance, large concept gaps.
- low: orphans, log drift, small index gaps.
Each item has: file path, evidence (a 1–2 line quote), suggested fix, and the operation that should follow up (
ingest, paperclip-distill, index-refresh, manual review).
- Do not write to
wiki/. Lint is read-only by design — the maintainer or the routine that follows decides which findings to act on.
- Append a log entry describing the run:
## [YYYY-MM-DD] lint | <N findings, M critical>
- operation issue: <issue identifier>
- critical: <count>
- medium: <count>
- low: <count>
Voice
- Lead with the count by severity.
- Each finding is one bullet. Resist commentary.
- When in doubt about severity, say so and surface it as medium with a "verify" note.
Verification
Before closing the operation issue:
Tools
wiki_search, wiki_read_page, wiki_list_sources, wiki_read_source, wiki_write_page (only wiki/log.md). Always include the operation issue's wikiId and spaceSlug.
1---
2name: wiki-lint
3description: Use when an LLM Wiki operation issue is a lint or health check. Audit for contradictions, orphans, weak provenance, broken links, missing concept pages, and index/log drift; return triage findings without auto-fixing.
4metadata:
5 source: https://skillmd.com/skills/paperclipai/wiki-lint
6---
7
8# Wiki Lint
9
10Audit, do not edit. Return findings the maintainer (human or agent) can triage.
11
12## Inputs
13
14- An operation issue with `operationType: "lint"`.
15- 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.
16
17## Workflow
18
191. **Walk the target space's `wiki/index.md` and wiki tree** with `wiki_search` and `wiki_read_page`, always passing the operation issue's `wikiId` and `spaceSlug`. Build a mental map of: pages that exist, pages referenced from `index.md`, pages referenced from other pages, and raw sources.
202. **Check for the seven recurring issues**, in this order:
21 1. **Contradictions** — two pages making incompatible claims about the same entity, decision, or status. Flag both pages, name the conflicting claims, and quote evidence.
22 2. **Stale claims** — a page asserts X, but a newer source under `raw/` has superseded it. Flag the older page; never overwrite.
23 3. **Orphan pages** — a `wiki/` page is not linked from `index.md` and not referenced from any other wiki page. Either it should be linked, removed, or merged.
24 4. **Concept gaps** — a term appears on three or more pages but has no dedicated `wiki/concepts/<slug>.md`. Recommend creating one.
25 5. **Broken `[[wiki-links]]`** — a link target file does not exist.
26 6. **Weak provenance** — a non-trivial claim is uncited or cites only the wiki itself in a circle. The original source ref should be findable.
27 7. **Index / log drift** — pages exist that are not in `index.md`, or `index.md` lists pages that no longer exist. Recent operations in `wiki/log.md` that did not produce a corresponding page change.
283. **Return a triage list**, grouped by severity:
29 - **critical**: contradictions, broken links to active pages, fabricated citations.
30 - **medium**: stale claims, weak provenance, large concept gaps.
31 - **low**: orphans, log drift, small index gaps.
32 Each item has: file path, evidence (a 1–2 line quote), suggested fix, and the operation that should follow up (`ingest`, `paperclip-distill`, `index-refresh`, manual review).
334. **Do not write to `wiki/`.** Lint is read-only by design — the maintainer or the routine that follows decides which findings to act on.
345. **Append a log entry** describing the run:
35 ```
36 ## [YYYY-MM-DD] lint | <N findings, M critical>
37 - operation issue: <issue identifier>
38 - critical: <count>
39 - medium: <count>
40 - low: <count>
41 ```
42
43## Voice
44
45- Lead with the count by severity.
46- Each finding is one bullet. Resist commentary.
47- When in doubt about severity, say so and surface it as medium with a "verify" note.
48
49## Verification
50
51Before closing the operation issue:
52
53- [ ] Findings are grouped by severity with file paths, evidence, and suggested fix per item.
54- [ ] No files under `raw/` were modified. No files under `wiki/` were modified except `wiki/log.md`.
55- [ ] If the run found nothing, the issue is closed with "no findings" and the log entry still exists so future audits can see this run happened.
56
57## Tools
58
59`wiki_search`, `wiki_read_page`, `wiki_list_sources`, `wiki_read_source`, `wiki_write_page` (only `wiki/log.md`). Always include the operation issue's `wikiId` and `spaceSlug`.