Wiki lint

My agent skills

Install

npx -y skills add jehrhardt/agents --skill wiki-lint

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Health-check the LLM wiki. Find orphan pages, check index completeness, flag stale claims, identify missing cross-references, and detect contradictions. Use when the user asks to check wiki health or wants periodic maintenance.

SKILL.md

2.1 KB, 532 tokens by cl100k_base, as published. Nobody here has run it

Wiki Lint

Health-check the personal wiki.

Vault

Path: ~/Notes
Wiki: Wiki/
Index: Wiki/index.md
Log: Wiki/log.md

Checks

1. Orphan Pages

Find pages with no inbound links:

# List all wiki pages
find "$HOME/Notes/Wiki" -name "*.md" | sed "s|$HOME/Notes/Wiki/||; s|\.md$||" | sort -u > /tmp/all_pages.txt

# Extract all wiki links
rg -o '\[\[([^\]]+)\]\]' "$HOME/Notes/Wiki" --type md | sed 's/.*\[\[\([^\]]*\)\]\].*/\1/' | sort -u > /tmp/linked_pages.txt

# Find orphans
comm -23 /tmp/all_pages.txt /tmp/linked_pages.txt

Exclude index.md and log.md from orphan checks.

2. Index Completeness

Read Wiki/index.md. List all wiki pages with find "$HOME/Notes/Wiki" -name "*.md" and verify every page appears in the index tables.

3. Stale Claims

Find pages where date: in frontmatter is more than 30 days old but sources: is > 2:

rg '^date: ' "$HOME/Notes/Wiki" --type md -A 0
rg '^sources: ' "$HOME/Notes/Wiki" --type md -A 0

These are well-sourced pages that haven't been updated recently — candidates for refresh.

4. Missing Cross-References

Scan pages for proper names, project names, or concept terms that appear as plain text but could be wiki links. Look for mentions of things that have their own wiki pages.

5. Contradictions (Heuristic)

Read pairs of related pages (pages that link to each other) and check for conflicting claims or outdated information.

Report

Summarize findings:

Orphan pages and suggested inbound links
Missing index entries
Stale pages needing refresh
Missing cross-references
Any contradictions detected

Append a summary to Wiki/log.md:

## [YYYY-MM-DD] lint | Wiki health check
- Orphans: N (list them)
- Missing index entries: N
- Stale pages: N
- Missing cross-references: N
- Contradictions: N