This skill reports the state of an Obsidian wiki that agents maintain. In its default mode it compares your sources and agent history against the ingest manifest, lists new, modified and deleted sources, estimates the token footprint of the vault and ends with a ranked What to Do Next list.
Three further modes cover structure and upkeep. Insights mode runs a graph analyser to find anchor pages, bridges, clusters and surprising links and writes _insights.md. Equilibrium mode checks whether lint, dedup, cross-linking and tag audits would still change anything. Costs mode reads the per-job cost report.
What You Get
- A status report with page and source counts, visibility tally, new, modified and deleted sources, and an append or rebuild recommendation
- A token footprint table by tier with index-only and typical query estimates and a warning threshold
- A ranked What to Do Next list of up to six items: staged pages, _raw files, stale core pages, orphans, synthesis opportunities, source delta and lint
- An _insights.md file with anchor pages, bridge pages, cluster cohesion, surprising connections, tier suggestions and questions worth asking
- An equilibrium report that names deviating and converged maintenance skills and flags ones that keep undoing each other
- A cost table per job with verdicts for jobs that spend without output or fail
Common Use Cases
- Deciding whether to append the new sources or rebuild the wiki
- Finding the hub and bridge pages that hold a vault together
- Checking whether lint, dedup and cross-linking have all gone quiet
- Seeing which scheduled wiki jobs cost more than they produce
What Makes It Unique
The skill covers the whole life of a vault in one place: ingest delta, graph shape, maintenance convergence and spend. The equilibrium mode treats maintenance skills as players sharing a vault and reports when one keeps reintroducing the work another clears. It also marks LLM-based counts as estimates and recommends changes without applying them.
Under The Hood
The agent loads the SKILL.md and the shared llm-wiki skill for config. It reads the vault’s manifest and pages, and scans your document folders and your Claude and Codex history folders under your home directory for the source inventory. It runs the obsidian-wiki command line for graph analysis, lint and cost reports, and the qmd command when a QMD collection is set. It writes _insights.md and log lines in the vault, and otherwise only reads. It does not fetch web pages or call remote services.