wiki-lint

What it does

The wiki-lint skill performs a health audit on an Obsidian wiki to find structural issues that degrade long-term value, including orphaned pages, broken wikilinks, missing frontmatter, stale content, contradictions, index mismatches, provenance drift, fragmented tag clusters, visibility tag consistency, and miscellaneous promotion candidates. It can operate in a report-only mode or in an act-and-report mode when invoked with --consolidate, performing fixes such as repairing links, adding cross-references, correcting lifecycle states, demoting stale pages, normalizing tag aliases, and adding contradiction callouts, all with a dry-run preview and explicit user confirmation before any writes.

How it works

• It instructs the agent to follow a Retrieval Primitives approach, preferring frontmatter-scoped greps and section-anchored reads over full-page reads.
• It requires resolving configuration to obtain OBSIDIAN_VAULT_PATH and reading index.md and log.md for inventory and recent activity context.
• It runs a sequence of lint checks in order: skip certain folders, identify orphaned pages, find broken wikilinks, verify required frontmatter fields, check for missing summary, detect stale content, locate contradictions, verify index consistency, assess provenance drift, evaluate tag clusters, ensure visibility tag consistency, identify promotion candidates, and validate confidence + lifecycle schema.
• Each check defines how to detect issues (grepping, linking, timestamp comparisons, provenance blocks, etc.) and how to fix them if in consolidate mode.
• The toolset includes calls to cross-linking and trust-checking workflows and uses the provided repository conventions for pages, frontmatter, and lifecycle fields.

When to use it

• Triggered when the user wants to audit the wiki health, find orphans, fix broken links, or perform maintenance tasks. It also activates on phrases like "clean up the wiki", "what needs fixing", "audit my notes", or "wiki health check". Adding --consolidate switches from report-only to act-and-report mode.

What it can touch

• In consolidate mode, it can fix broken links, add missing cross-references for orphans, correct lifecycle states, demote stale peripheral pages, normalize tag aliases, and add contradiction callouts. It provides a dry-run preview and requires explicit user confirmation before any writes.

Caveats

• The skill enforces a strict frontmatter-based workflow and relies on trusted vault paths and governance via explicit confirmations. It distinguishes between report-only and act-and-report modes and advises manual review for several complex checks (e.g., contradictions, provenance drift). The approach emphasizes non-destructive previews unless the user explicitly enables consolidation.