How do I install the Wiki Lint skill?

Run npx skillmds@latest add pivoshenko/wiki-lint in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Wiki Lint safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wiki Lint?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Wiki Lint free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Wiki Lint?

pivoshenko (@pivoshenko) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wiki Lint by pivoshenko — Agent Skill

Name: Wiki Lint
Author: pivoshenko

Wiki Lint

Maintenance sweep of the Obsidian vault — orphan notes, missing/invalid frontmatter, dead wikilinks, stale project statuses, INDEX.md drift, unprocessed inbox. Use when the user says "lint my wiki", "vault health check", "clean up my vault", "is my wiki up to date", or on a periodic review.

pivoshenko 51c14b0 2.8 KB Updated Sep 17, 2026

File contents

Wiki lint

Vault: /Users/volodymyr.pivoshenko/Library/Mobile Documents/iCloud~md~obsidian/Documents/Vault

Karpathy lint loop: scan -> report -> fix with approval. Read-only until user approves fixes.

Preflight — before ANY fix

iCloud eviction: find <vault> -name '*.icloud' → any hit = partially-synced vault. Report findings, abort all fixes (evicted notes look deleted; "fixing" corrupts the catalog).
Conflicted copies: filenames matching * 2.md / *conflict* → flag for manual merge, never auto-pick a side.

Checks

Read vault CLAUDE.md + INDEX.md first.
Sweep all *.md (skip 01 DAILY NOTES, 97 MEMORY, 98 ATTACHMENTS, 99 TEMPLATES, .obsidian):
- frontmatter — missing block, missing required keys per type contract, invalid status/source_type values, non-kebab tags
- dead links — [[target]] with no matching note (rg -o '\[\[[^\]|#]+' | sort -u vs file list)
- orphans — notes nothing links to and INDEX.md doesn't list
- index drift — notes missing from INDEX.md; INDEX.md entries whose note is gone
- stale projects — status: active + updated > 60 days ago
- stale drafts — status: drafting|review + updated > 30 days ago
- inbox — items sitting in 00 INBOX/
- secrets — rg -i 'api[_-]?key|secret|token|password|_pat_' across ALL notes incl. daily notes → flag to user, never quote values
- layout — every top-level dir in 03 PROJECTS/ contains <dirname>.md index
- no symlinks — nothing under ~/.claude is a symlink (memory dirs and CLAUDE.md are real files; a symlink = legacy arrangement to convert)
- memory mirrors — each ~/.claude/projects/<slug>/memory diffs clean against its canonical 97 MEMORY/<project>/
- daily-note harvest — daily notes newer than the last lint: LOG entry: list durable items worth extracting (propose, don't auto-file)
Report findings grouped by check, one line each, fix proposed per line. Clean -> say so, done.
User approves -> fix. Mechanical fixes (index drift, frontmatter gaps, dead-link stubs) batch fine; content judgment calls (orphan deletion, stale status changes) -> ask per item.
Duties: LOG.md line (lint: N findings, M fixed), bump updated on touched notes.

Rules

Never delete notes as a "fix" without explicit per-note approval.
Dead link to a worthwhile concept -> stub it, don't unlink it.
INDEX.md is regenerable: heavy drift -> rebuild whole file from vault state.

---name: wiki-lintdescription: Maintenance sweep of the Obsidian vault — orphan notes, missing/invalid frontmatter, dead wikilinks, stale project statuses, INDEX.md drift, unprocessed inbox. Use when the user says "lint my wiki", "vault health check", "clean up my vault", "is my wiki up to date", or on a periodic review.---# Wiki lintVault: `/Users/volodymyr.pivoshenko/Library/Mobile Documents/iCloud~md~obsidian/Documents/Vault`Karpathy lint loop: scan -> report -> fix with approval. Read-only until user approves fixes.## Preflight — before ANY fix- iCloud eviction: `find <vault> -name '*.icloud'` → any hit = partially-synced vault. Report findings, **abort all fixes** (evicted notes look deleted; "fixing" corrupts the catalog).- Conflicted copies: filenames matching `* 2.md` / `*conflict*` → flag for manual merge, never auto-pick a side.## Checks1. Read vault `CLAUDE.md` + `INDEX.md` first.2. Sweep all `*.md` (skip `01 DAILY NOTES`, `97 MEMORY`, `98 ATTACHMENTS`, `99 TEMPLATES`, `.obsidian`): - **frontmatter** — missing block, missing required keys per type contract, invalid `status`/`source_type` values, non-kebab tags - **dead links** — `[[target]]` with no matching note (`rg -o '\[\[[^\]|#]+' | sort -u` vs file list) - **orphans** — notes nothing links to and INDEX.md doesn't list - **index drift** — notes missing from INDEX.md; INDEX.md entries whose note is gone - **stale projects** — `status: active` + `updated` > 60 days ago - **stale drafts** — `status: drafting|review` + `updated` > 30 days ago - **inbox** — items sitting in `00 INBOX/` - **secrets** — `rg -i 'api[_-]?key|secret|token|password|_pat_'` across ALL notes incl. daily notes → flag to user, never quote values - **layout** — every top-level dir in `03 PROJECTS/` contains `<dirname>.md` index - **no symlinks** — nothing under `~/.claude` is a symlink (memory dirs and `CLAUDE.md` are real files; a symlink = legacy arrangement to convert) - **memory mirrors** — each `~/.claude/projects/<slug>/memory` diffs clean against its canonical `97 MEMORY/<project>/` - **daily-note harvest** — daily notes newer than the last `lint:` LOG entry: list durable items worth extracting (propose, don't auto-file)3. Report findings grouped by check, one line each, fix proposed per line. Clean -> say so, done.4. User approves -> fix. Mechanical fixes (index drift, frontmatter gaps, dead-link stubs) batch fine; content judgment calls (orphan deletion, stale status changes) -> ask per item.5. Duties: LOG.md line (`lint: N findings, M fixed`), bump `updated` on touched notes.## Rules- Never delete notes as a "fix" without explicit per-note approval.- Dead link to a worthwhile concept -> stub it, don't unlink it.- INDEX.md is regenerable: heavy drift -> rebuild whole file from vault state.

Frequently asked questions