# Second Brain Lint

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-undefined-ui-second-brain-os-second-brain-lint`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [undefined-ui](https://agentstack.voostack.com/s/undefined-ui)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [undefined-ui](https://github.com/undefined-ui)
- **Source:** https://github.com/undefined-ui/second-brain-os/tree/main/skills/second-brain-lint
- **Website:** https://x.com/undefinedKi/status/2068306794116501544

## Install

```sh
agentstack add skill-undefined-ui-second-brain-os-second-brain-lint
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:  pages ( sources,  concepts,  entities,  synthesis)
Link graph:  links, average  per page,  orphans

Fixed automatically:
- 

Needs a decision:
- 

Health: orphan rate %, broken link rate %, stub rate %
```

## Calibration

An aggressive linter that merges pages on its own judgement destroys work. A
timid one that only reports produces a list nobody acts on. The split above is
the useful line: mechanical fixes happen, semantic decisions get proposed.

Do not run a full lint after every ingest. Weekly, or after an import of more
than about twenty sources.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [undefined-ui](https://github.com/undefined-ui)
- **Source:** [undefined-ui/second-brain-os](https://github.com/undefined-ui/second-brain-os)
- **License:** MIT
- **Homepage:** https://x.com/undefinedKi/status/2068306794116501544

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-undefined-ui-second-brain-os-second-brain-lint
- Seller: https://agentstack.voostack.com/s/undefined-ui
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.