second-brain-graph skillA
second-brain-graph is agent-read markdown (skill) from undefined-ui/second-brain-os: Analyse the vault's link graph and report on its shape: orphan rate, average degree, components, hubs, bridges and clusters, with what each number means for retrieval. Use this skill when the user asks about the health or structure of their graph, wants metrics, asks which pages are most connected or most isolated, or asks whether the vault is fragmented. Do NOT use for fixing what it finds, which is second-brain-lint, or for answering a content question..
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
# Analyse the graph The graph is the search space every answer is drawn from. Its shape decides whether retrieval reaches the relevant material in a few hops or reaches nothing. ## Core rule Report shape and what it means, never fix anything. This skill is read-only. ## Workflow 1. **Run the scripts** rather than reading files: `scripts/vault_stats.py` for counts and degree, `scripts/link_check.py` for orphans and breaks, `scripts/graph_export.py` when deeper analysis is wanted. 2. **Compute the four metrics:** orphan rate, average degree, component count, stale-page rate. 3. **Identify hubs** (pages that have swallowed the graph) and **bridges** (pages connecting otherwise separate clusters). 4. **Name the clusters.** These are what the vault is actually about, which is reliably different from what the user would say it is about. 5. **Say what each number means** for answering questions, not just the value. ## Output format ``` Pages <n> | links <n> | avg degree <n> Orphan rate <n>% (healthy under 5) Components <n> (main holds <n>%) Stale concepts <n>% (untouched 90+ days) Hubs: <pages with outsized degree, and whether to split them> …
Read the whole file at its exact version.
How to install
mdr add undefined-ui/second-brain-os/second-brain-graph@git:20260908.1615b29mdr add undefined-ui/second-brain-os/second-brain-graph@sha256:f38bee1de3933e63Pin 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_y6me3erc2hsq22hv)
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 (2129 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_y6me3erc2hsq22hv GET https://markdownregistry.com/api/v1/resolve?ref=undefined-ui/second-brain-os/second-brain-graph GET https://markdownregistry.com/api/v1/blob/f38bee1de3933e638dc3422ebde8bfce6117a6a4035a6f36a11bb891d3843a5d
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.