paperclipai/paperclip / packages/plugins/plugin-llm-wiki/skills/wiki-lint
wiki-lint
VerifiedUse 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.
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. Flag the older page; never overwrite. - Orphan pages — a
wiki/page is not linked fromindex.mdand 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, orindex.mdlists pages that no longer exist. Recent operations inwiki/log.mdthat 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:
- Findings are grouped by severity with file paths, evidence, and suggested fix per item.
- No files under
raw/were modified. No files underwiki/were modified exceptwiki/log.md. - 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.
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 463k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 463k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 463k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |