# Brain Lint

> Health-check ontology-brain. Use before shipping any brain change, when asked to lint or audit the brain, or when pages may have broken links, stale index entries, duplicated facts, relationship drift, or ontology anti-patterns.

- Skill: `rudironsoni/brain-lint` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add rudironsoni/brain-lint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rudironsoni/brain-lint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: rudironsoni (https://skillmd.com/u/rudironsoni)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rudironsoni/brain-lint

---


# Brain Lint

Use this skill as the gate for every `ontology-brain/` change.

## Mechanical Gate

Run from anywhere inside `ontology-brain/`:

```bash
python3 .claude/skills/brain-lint/scripts/wiki_link_check.py
```

The script locates the brain root by walking upward to `ontology.md` plus `objects/`. It accepts an explicit root path when needed.

It checks:

- relative links resolve and stay inside the brain;
- no absolute local links or `file:` URIs;
- no Obsidian wikilinks inside the brain;
- heading anchors exist;
- non-meta pages have inbound links;
- frontmatter keys are known shared properties or typed link properties;
- `supersedes` and `superseded_by` are mirrored;
- `index.md` matches regeneration from `build_index.py`.

Fix the brain first. Change the checker only when the checker is demonstrably wrong, and keep schema documentation aligned.

## Generated Index

`index.md` is derived. Do not hand-edit it. Regenerate with:

```bash
python3 .claude/skills/brain-lint/scripts/build_index.py
```

Use `summary:` in page frontmatter for the optional one-line hook on index rows.

## Semantic Audit

When asked for a full health check, also inspect:

- duplicated facts that should have one canonical home;
- stale copied values;
- vague object types or premature folders;
- links that answer no domain question;
- missing source provenance;
- `[UNVERIFIED]` claims that can now be verified;
- relationships with their own dates, status, or evidence that should be promoted to pages.

Record meaningful audit work in `log.md` with a `lint` entry.