wiki-lint

Audits wiki topic pages for orphans, dead links, contradictions, and stale content.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill wiki-lint-hivgb1-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/hivgb1-ai/do-better-workspace-v2/tree/main/.claude/skills/wiki-lint
Command: npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill wiki-lint-hivgb1-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Personal knowledge wikis degrade over time: pages become orphaned, links break, information goes stale, and contradictions accumulate silently. This Skill performs a systematic health check across all wiki topic pages and produces a prioritized report so you can fix issues before knowledge quality erodes. ## Core Features & Use Cases - 13-Point Health Audit: Checks orphan pages, dead links, stale pages (90+ days), contradictions, missing cross-references, missing topics, oversized pages, data gaps, ingest activity, infobox integrity, index description quality, facet bloat, and hub block drift. - Report-First, Approval-Gated Fixes: Generates a structured Wiki Health Report and only edits index.md, Related sections, or log.md after explicit user approval. - Use Case: Run a monthly wiki review by asking for a health check; the Skill scans every topic page in 30-knowledge/00-wiki, flags a page whose Last enriched date is 120 days old, finds two dead wikilinks, and proposes index.md additions for three orphan pages. ## Quick Start Ask the assistant to run a wiki health check on the 00-wiki directory and show the report before making any fixes.

Frequently Asked Questions about wiki-lint

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

FAQPage Schema
How do I check a personal wiki for broken links and orphan pages?

Run a wiki lint pass that globs all topic pages, extracts their Related sections and wikilinks, then cross-references them against actual files and the index. Pages never referenced elsewhere are flagged as orphans, and links pointing to nonexistent files are flagged as dead links.

What does a wiki health check report include?

The report summarizes total topics and counts of healthy, warning, and action-needed pages, then details findings per check: orphan pages, dead links, stale pages, contradictions, missing cross-references, oversized pages, and infobox or index quality issues.

Does the wiki lint skill edit files automatically?

No. It generates a health report first and asks for explicit approval via a confirmation prompt before editing anything. Approved changes are applied to index.md or Related sections and recorded in log.md.

How are stale wiki pages detected?

Pages whose Last enriched date is 90 days or older are flagged as stale. The check also uses log.md to find seed pages never enriched and categories with no ingest activity in the last 30 days.

Can wiki lint detect contradictions between pages automatically?

It finds candidate page pairs sharing common keywords via grep and compares their claims, flagging potential contradictions with a marker. Judgment is left to the user; the skill only flags, never resolves.