second-brain-lint

Solid

Audit a second-brain vault for structural problems and repair them: broken wikilinks, orphan pages, empty stubs, frontmatter that violates the schema, near-duplicate pages, and stale index entries. Use this skill whenever the user asks to lint, clean, audit or check the health of their vault, says pages feel messy or links are broken, after a large bulk import, or when a scheduled maintenance run fires. Do NOT use for ingesting new sources, for answering questions from the vault, or for rewriting page content that is structurally fine but reads badly.

AI & Automation 46 stars 7 forks Updated today MIT

Install

View on GitHub

Quality Score: 83/100

Stars 20%
56
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Lint the vault Structural rot is silent. Nothing errors, nothing crashes, the vault just slowly stops answering questions well because a third of its pages are unreachable. Linting is the only thing that catches it before the owner does. ## Core rule Report before repairing. Fix the mechanical problems automatically, but never delete or merge a page without listing it first and getting a yes, because the owner may have written it by hand. ## Workflow 1. **Inventory.** Count pages by type. Build the link graph by parsing every `[[wikilink]]`. 2. **Broken links.** Links pointing at pages that do not exist. Distinguish two cases: a typo or rename, which you fix, and a genuine gap, which goes into `index.md` under Gaps. 3. **Orphans.** Pages with no inbound links. For each, either find where it should be linked from and add the link, or flag it as a candidate for deletion. 4. **Stubs.** Pages under roughly 40 words with no links. Usually a failed ingest. Flag for re-ingest from the original source in `raw/`. 5. **Schema.** Missing or malformed frontmatter, wrong `type`, missing dates, tags outside the existing vocabulary. 6. **Near-duplicates.** Pages with very similar titles or aliases. Propose merges; do not perform them unsolicited. 7. **Index drift.** Pages missing from `index.md`, index entries pointing nowhere. 8. **Repair**, then append the run to `log.md`. ## Output format ``` Vault: <n> pages (<n> sources, <n> concepts, <n> entities, <...

Details

Author
undefined-ui
Repository
undefined-ui/second-brain-os
Created
3 days ago
Last Updated
today
Language
HTML
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category