wiki-lint

Audit wiki documentation for stale pages, broken links, and structural violations.

3|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/zoraxl/team-brain --skill wiki-lint-zoraxl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/zoraxl/team-brain/tree/main/.cursor/skills/wiki-lint
Command: npx skills add https://github.com/zoraxl/team-brain --skill wiki-lint-zoraxl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the common issue of wiki rot, where documentation becomes stale, disorganized, or disconnected from the actual implementation, making it difficult for teams to find authoritative information.

Core Features & Use Cases

  • Structural Auditing: Identifies orphan pages, missing backlinks, and incorrect file placements based on the wiki-zone model.
  • Health Monitoring: Detects stale content, unsourced claims, and unresolved open questions that require human review.
  • Use Case: Run this skill after a major infrastructure migration to ensure all engineering runbooks and ADRs are correctly categorized and linked to the updated system architecture.

Quick Start

Run the wiki-lint skill to audit the current repository wiki and report any structural inconsistencies or stale documentation.

Frequently Asked Questions about wiki-lint

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

FAQPage Schema
How do I audit wiki documentation for stale pages and broken links?

To audit wiki documentation for stale pages and broken links, you can run a maintenance validation tool that scans your repository to detect outdated review dates, missing references, and structural violations. This ensures your team wiki remains aligned with implementation reality.

What is the best way to identify orphan pages and missing backlinks in a team wiki?

Identifying orphan pages and missing backlinks in a team wiki requires structural auditing across defined namespace zones. This process checks file organization against repository conventions to find disconnected pages and categorize engineering runbooks correctly.

How does a wiki health monitor detect unsourced claims and open questions?

A wiki health monitor detects unsourced claims and open questions by scanning documentation content for unresolved markers and stale information. It flags these areas for human review, ensuring product knowledge remains accurate and authoritative.

Can I check for improper file organization in my engineering runbooks and ADRs?

Yes, you can check for improper file organization in engineering runbooks and ADRs by validating file placements against established repository conventions. This ensures documents are correctly categorized within the wiki-zone model.

When should I run a documentation maintenance audit on my repository wiki?

You should run a documentation maintenance audit on your repository wiki after major infrastructure migrations or system architecture updates. This ensures all product knowledge and implementation runbooks are correctly linked and categorized.

Does wiki linting work with namespace zones to validate structural consistency?

Yes, wiki linting works by operating across defined namespace zones to validate structural consistency. It checks alignment between product knowledge and implementation reality, reporting broken links and outdated content within those specific boundaries.