wiki-lint

Scan Brain-1 wiki pages for orphans, missing links, stale signals, and contradictions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill wiki-lint-cleanexpo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/CleanExpo/Pi-Dev-Ops/tree/main/skills/wiki-lint
Command: npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill wiki-lint-cleanexpo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents knowledge bases from silently degrading by detecting orphan pages, broken topic cross-references, outdated claims, and internal contradictions before they mislead future work.

Core Features & Use Cases

  • Orphan detection & auto-fix: Finds pages under Wiki/ not listed in index.md and adds them to an ## Orphaned section to restore discoverability.
  • Cross-reference repair: Detects plain-text mentions of wiki topics and wraps them in [[...]] links to maintain navigability.
  • Staleness & contradiction surfacing: Flags pages with outdated updated: signals based on topic decay thresholds, and reports contradictions across pages for founder review.
  • Run scheduling & audit trail: Supports weekly execution (Saturdays) and manual operator commands, appending a log entry to Wiki/log.md after each run.

Quick Start

Ask the AI operator to "lint the wiki" to scan the Brain-1 wiki and apply orphan and cross-reference fixes while producing a report for stale claims and contradictions.

Frequently Asked Questions about wiki-lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect orphan pages and broken cross-references in my wiki?

Orphan detection scans your wiki for pages not listed in index.md and adds them to an Orphaned section, while cross-reference repair wraps plain-text topic mentions in [[...]] links to restore navigability.

What is the best way to find contradictory claims in a knowledge base?

Contradiction detection uses LLM-assisted scanning across wiki pages to surface conflicting factual assertions, producing a structured report for founder review rather than applying automated fixes.

Can I automatically flag stale wiki pages based on outdated update signals?

Yes, staleness surfacing flags pages with outdated updated: signals by applying topic decay thresholds to identify engineering knowledge base entries requiring fresh review or revision.

How do I schedule weekly maintenance checks for a Brain-1 knowledge base?

Weekly maintenance checks can be scheduled for Saturdays or triggered via manual operator commands, executing linting scans that append a structured log entry to Wiki/log.md after each run.

Does wiki linting apply conservative automated fixes or require manual review?

Wiki linting applies conservative automated fixes for index updates and cross-link wrapping, but requires LLM-assisted contradiction detection and produces a structured report for human review of stale claims and factual conflicts.