AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

wiki-lint

Run a health check on the LLM Wiki vault — mechanical checks (orphans, broken links, stale pages, missing frontmatter, log gap, duplicates) plus semantic checks (contradictions, cross-reference gaps, concepts missing their own page). Outputs a markdown report with suggested actions. Usage /wiki-lint [--stale-days N] [--log-gap-days N]

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--wiki-lint at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 1

SKILL.md

/wiki-lint

Health-check the wiki. Surfaces orphan pages, broken wikilinks, stale claims, missing frontmatter, contradictions, and structural drift. Reports, doesn't silently fix — you decide what to change.

Run this weekly, after batch ingests, and always before sharing the wiki.

Usage

/wiki-lint
/wiki-lint --stale-days 60
/wiki-lint --log-gap-days 7

What happens

Pass 1 — Mechanical (scripts)

  • engineering/llm-wiki/skills/llm-wiki/scripts/lint_wiki.py — orphans, broken links, stale pages, missing frontmatter, duplicate titles, log gap
  • engineering/llm-wiki/skills/llm-wiki/scripts/graph_analyzer.py — hubs, sinks, connected components, graph stats

Pass 2 — Semantic (LLM reads and thinks)

  • Contradictions between recently-updated pages
  • Stale claims superseded by newer sources
  • Concepts mentioned in plain text across 3+ pages without their own page
  • Cross-reference gaps (entities mentioned but not wikilinked)
  • Index drift (index.md out of sync with wiki/)

Pass 3 — Report

A markdown report grouped by severity:

# Wiki lint — <date>

**Total pages:** N  **Components:** N  **Last log:** <date>

## Found
- ⚠️ <N> contradictions (list)
- <N> orphans
- <N> broken links
- <N> stale pages
- ...

## Suggested actions
1. Investigate contradiction between [[sources/a]] and [[sources/b]]
2. Create concept page for "<name>"
3. Fix broken link in [[concepts/x]]
4. Re-ingest [[sources/c]] — stale + contradicted
5. ...

Then appends a lint entry to log.md.

Sub-agent

Dispatches the wiki-linter sub-agent. See agents/wiki-linter.md.

Scripts

  • engineering/llm-wiki/skills/llm-wiki/scripts/lint_wiki.py
  • engineering/llm-wiki/skills/llm-wiki/scripts/graph_analyzer.py
  • engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py

Frequency

| Trigger | Pass | |---|---| | Weekly | Mechanical only — fast | | After batch ingest | Full (mechanical + semantic) | | Monthly | Full + structural review | | Before sharing | Full + extra review |

Skill Reference

→ engineering/llm-wiki/skills/llm-wiki/SKILL.md → engineering/llm-wiki/skills/llm-wiki/references/lint-workflow.md