second-brain-lint SKILL.md skillA

second-brain-lint from undefined-ui/second-brain-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add undefined-ui/second-brain-os/second-brain-lint@git:20260907.8c47c65

Pins git:20260907.8c47c65 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
undefined-ui/second-brain-os
Path
skills/second-brain-lint/SKILL.md
Versions recorded
1
Latest version
git:20260907.8c47c65, committed Sep 7, 2026
Size
2,710 bytes
Repository stars
1,499
License
MIT

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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

The exact contents, by fingerprint
mdr add undefined-ui/second-brain-os/second-brain-lint@sha256:74b5eaae1c765cd7

The line at the top of this page pins the label git:20260907.8c47c65, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nes72n7boh6xqjry.svg)](https://markdownregistry.com/a/art_nes72n7boh6xqjry)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 7, 2026.

versioncommittedcommitsizeaudit
git:20260907.8c47c65 latest2026-09-07 8c47c65 2,710 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • 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

GitHub

undefined-ui/second-brain-os · 1,499 stars · license MIT · pushed 2026-11-03 · 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 AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from undefined-ui/second-brain-os

context-audit SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/context-audit/SKILL.md · Audit an agent's context layout against the four places: system prompt, tools, history, tail. Use when the user asks to…
git:20261007.c7fa35b · audit A · 1,499 stars
evals-bootstrap SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/evals-bootstrap/SKILL.md · Scaffold a first eval suite for an agent: mine real failures into cases, write behavioural checks over traces, and…
git:20261007.c7fa35b · audit A · 1,499 stars
gate-check SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/gate-check/SKILL.md · Find the decisions in a pipeline that do not need the expensive model and propose the gate for each: a rule, a classic…
git:20261007.c7fa35b · audit A · 1,499 stars
goal-test SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/goal-test/SKILL.md · Turn a vague task into a testable definition of done and generate an executable goal-test script for it, optionally…
git:20261007.c7fa35b · audit A · 1,499 stars
harness-audit SKILL.md skill
undefined-ui/second-brain-os · plugins/agents-course/skills/harness-audit/SKILL.md · Audit an agent's harness against the four rings: containment, guides, sensors, permissions. Use when the user asks…
git:20261007.c7fa35b · audit A · 1,499 stars
second-brain-backfill SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-backfill/SKILL.md · Import a large archive into the vault in controlled batches: triage what is worth ingesting, process oldest first…
git:20260908.1615b29 · audit A · 1,499 stars
second-brain-changed-my-mind SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-changed-my-mind/SKILL.md · Trace where the user's recorded position on something has shifted: superseded claims, contradictions between sources of…
git:20260908.1615b29 · audit A · 1,499 stars
second-brain-chat-import SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-chat-import/SKILL.md · Triage an exported chat history into what to ingest, what to archive and what to delete, with a privacy pass first. Use…
git:20260908.1615b29 · audit A · 1,499 stars
second-brain-graph SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-graph/SKILL.md · Analyse the vault's link graph and report on its shape: orphan rate, average degree, components, hubs, bridges and…
git:20260908.1615b29 · audit A · 1,499 stars
second-brain-ingest SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-ingest/SKILL.md · Turn raw source material in a second-brain vault into linked wiki pages: read the source, split it into concepts and…
git:20260907.8c47c65 · audit A · 1,499 stars
second-brain-merge SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-merge/SKILL.md · Merge two pages that describe the same thing, preserving every distinct claim, redirecting inbound links, and recording…
git:20260908.1615b29 · audit A · 1,499 stars
second-brain-metrics SKILL.md skill
undefined-ui/second-brain-os · skills/second-brain-metrics/SKILL.md · Record a dated snapshot of the vault's health numbers and compare against previous snapshots so trends are visible. Use…
git:20260908.1615b29 · audit A · 1,499 stars

Every file in undefined-ui/second-brain-os

Browse by kind, by grade A, or by owner.