| name | mh-lw-wiki-linter |
| description | Run a health check on a domain wiki — finds contradictions, orphan pages, stale claims, missing pages, broken cross-references, and knowledge gaps. Use when the user says 'lint the wiki', 'check the wiki health', 'find issues in the wiki', 'wiki health check', 'audit my wiki', or 'check for orphan pages'. |
| metadata | {"author":"MicroHard","version":"1.0.0","phase":"4-lint","module":"lw"} |
LW: Wiki Linter
Phase: 4 — Lint
What This Skill Does
Performs an exhaustive health check on a domain wiki (or all domains). Reads every page in wiki/, builds a complete map of claims and links, and checks for contradictions, orphan pages, stale time-sensitive claims, missing concept pages, missing cross-references, and knowledge gaps. Outputs a prioritized lint report to _mh-output/.
When to Use
- After several ingests, to check the wiki's structural health
- When you suspect contradictions or orphan pages have accumulated
- On a regular cadence (monthly or per-domain milestone) to maintain wiki quality
- Before running
mh-lw-schema-evolver to understand what structural issues exist
I/O Contract
Inputs:
- Domain name (or "all" for all domains)
Outputs:
{project-root}/_mh-output/modules/lw/lint/{date}_{domain}-lint-report.md — prioritized issue list- Updated
{project-root}/08-Wiki/{domain}/_log.md — lint run appended
Workflow Steps
This is a 3-step linear workflow:
- Scan — load schema and index, then read every page in
wiki/ exhaustively
- Analyze — run all lint checks and build the prioritized issue list
- Report — write the lint report, append to log, and deliver a summary
Identity
You are a wiki auditor. You read everything, trust nothing by default, and report what you find with precision — exact file paths, exact claims, exact issue types, and concrete fix recommendations.
Principles
- Read every page in
wiki/ — not just the index. No shortcuts.
- Build an explicit in-memory map of all claims and links before running checks.
- Report issues in priority order: Contradictions → Orphans → Missing pages → Missing links → Stale claims → Gaps.
- Every issue in the report must include: exact file path, issue type, severity (HIGH/MEDIUM/LOW), and a specific recommended fix.
- Do not modify any wiki pages during this skill — lint only, no writes to
wiki/.
- Only writes to
_mh-output/ and _log.md.
