wiki-lint

Validate markdown wiki front-matter and wikilinks against SCHEMA.md.

6|1|Updated May 13, 2026
One-click install
npx skills add https://github.com/Xipher-Labs/walter-os --skill wiki-lint-xipher-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/Xipher-Labs/walter-os/tree/main/skills/wiki-lint
Command: npx skills add https://github.com/Xipher-Labs/walter-os --skill wiki-lint-xipher-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken and stale wiki content from corrupting ingestion and confusing downstream agent work by surfacing link issues, invalid page metadata, or consistency problems before they spread.

Core Features & Use Cases

  • Broken link detection (critical): Finds [[wikilinks]] that point to missing pages so further /ingest can be blocked until fixed.
  • Schema/front-matter validation (critical): Flags malformed or missing required fields per wiki/SCHEMA.md, including decision/source requirements.
  • Wiki hygiene checks (high/info): Detects orphans, missing entity stubs, stale time_sensitive claims, index.md drift, and cross-page contradictions via an expensive weekly LLM scan.

Quick Start

Run wiki lint for immediate health feedback by asking walter-os wiki lint.

Frequently Asked Questions about wiki-lint

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

FAQPage Schema
How do I validate markdown wiki front-matter against a schema?

To validate markdown wiki front-matter against a schema, parse page metadata using a defined SCHEMA.md to flag missing required fields and malformed content. This enforces data quality by preventing ingestion failures caused by invalid page structures.

What is the best way to detect broken wikilinks in a markdown wiki?

Detecting broken wikilinks involves extracting [[wikilinks]] from markdown pages to build inbound and outbound link graphs. This identifies missing pages and enforces critical findings as ingest blockers to stop corrupted content from spreading.

How do I prevent ingestion failures from broken wiki content?

Preventing ingestion failures from broken wiki content requires health-checking markdown pages to surface link issues and metadata inconsistencies before ingestion. Critical findings like broken links and invalid front-matter are enforced as ingest blockers.

Can I check for orphan pages and missing entity stubs in my wiki?

Yes, you can check for orphan pages and missing entity stubs by running wiki hygiene checks. This process detects isolated pages and incomplete content, generating a structured report with optional safe auto-fixes for index and log synchronization.

What limitations exist when scanning markdown for cross-page contradictions?

Scanning markdown for cross-page contradictions is limited by its high computational cost, restricting the operation to an optional weekly LLM scan. This constraint prevents excessive resource consumption while still detecting logical inconsistencies across wiki pages.