second-brain-lint skillA
second-brain-lint is agent-read markdown (skill) from undefined-ui/second-brain-os: 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 rewritin.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 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. …
Read the whole file at its exact version.
How to install
mdr add undefined-ui/second-brain-os/second-brain-lint@git:20260907.8c47c65mdr add undefined-ui/second-brain-os/second-brain-lint@sha256:74b5eaae1c765cd7Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_nes72n7boh6xqjry)
1 badge views in 30 days
Versions
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2710 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
undefined-ui/second-brain-os · 296 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_nes72n7boh6xqjry GET https://markdownregistry.com/api/v1/resolve?ref=undefined-ui/second-brain-os/second-brain-lint GET https://markdownregistry.com/api/v1/blob/74b5eaae1c765cd75d564e8d853a08b945ebf6ecdbdf58e0456ff82befad1cac
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.