KB Lint
Use this skill to inspect knowledge-base health without making risky rewrites.
Workflow
- Read the vault root
AGENTS.md. - Confirm the expected folders and control files exist.
- Check human-owned
personal-notes/for schema drift only; do not edit them during lint. - Check raw-source records for required frontmatter, required body sections, preserved links, and source locators.
- Check wiki pages for citations back to raw-source records or human notes.
- Search for duplicate concepts, orphan synthesis pages, broken wikilinks, and missing backlinks.
- Identify contradictions or stale claims and route them to
knowledge-base/wiki/review.md. - Produce a prioritized report with concrete file paths and suggested fixes.
Checks
Use lint-checks.md for the full checklist.
Fix Policy
- Apply low-risk mechanical fixes in the knowledge base only when the user asks for direct cleanup.
- Apply
personal-notes/link/frontmatter formatting fixes directly when they are low-risk. - For substantive
personal-notes/fixes, list exact proposed changes and ask for permission before editing. - Do not rewrite personal notes by default.
- Do not resolve contradictory claims automatically.
- Prefer review items over silent changes when evidence is ambiguous.
Output
Group findings by severity:
Critical: broken schema, missing raw-source records, or ownership violations.High: contradictions, missing citations, or important dead links.Medium: duplicate concepts, orphan wiki pages, weak summaries.Low: naming drift, minor frontmatter gaps, index freshness.