Agent skill

Second Brain Lint

by NicholasSpisak in NicholasSpisak/second-brain

Health-check the wiki for contradictions, orphan pages, stale claims, and missing cross-references.

No licenceAuto-check: notesKnowledge Management

Install Second Brain Lint

skills CLI
$ npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install NicholasSpisak/second-brain second-brain-lint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/NicholasSpisak/second-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/second-brain-lint .claude/skills/second-brain-lint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
second-brain-lint
GitHub stars
737
Token cost
~1k tokens
SKILL.md length
520 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
None found

At a glance

Health-check the wiki for contradictions, orphan pages, stale claims, and missing cross-references.

  • Works in 8 steps: Broken wikilinks → Orphan pages → Contradictions → …
  • The user says audit
  • SKILL.md covers Audit Steps, Report Format, After the Report and Log the lint pass, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Second Brain Lint is an agent skill from NicholasSpisak/second-brain. Health-check the wiki for contradictions, orphan pages, stale claims, and missing cross-references. Use when the user says "audit", "health check", "lint", "find problems", or wants to improve wiki quality.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management, covering Second brain and Linting and formatting. The repository describes itself as: LLM-maintained personal knowledge base for Obsidian. Based on Andrej Karpathy's LLM Wiki pattern.

When your agent uses it

  • The user says audit
  • Wants to improve wiki quality

Example prompts

  • “health check”
  • “find problems”
  • “/second-brain-lint”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob, Grep

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Broken wikilinks
  2. Orphan pages
  3. Contradictions
  4. Stale claims
  5. Missing pages
  6. Missing cross-references
  7. Index consistency
  8. Data gaps

What it can do on your machine

Read from SKILL.md and the folder at commit 3e429c7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Second Brain Lint loads about 1k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 520 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 520 words (~1,002 tokens).

“Health-check the wiki and report issues with actionable fixes.”

— opening of SKILL.md by NicholasSpisak
name
second-brain-lint
allowed-tools
Bash, Read, Write, Edit, Glob, Grep

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/second-brain-lint of NicholasSpisak/second-brain.

Open the folder on GitHubat commit 3e429c7

Compare with similar skills

Second Brain Lint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Second Brain Lint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Second Brain Lint this skillNicholasSpisak/second-brain737—~1kAutomated safety check: NotesNone
Second Brain DelintPieroSierra/SecondBrain153—~1kAutomated safety check: PassNone
Second Brain Ingestundefined-ui/second-brain-os1k—~873Automated safety check: PassMIT
Second Brain Lintundefined-ui/second-brain-os1k—~678Automated safety check: PassMIT
Second Brain Reviewundefined-ui/second-brain-os1k—~550Automated safety check: PassMIT
Second Braincoreyhaines31/makerskills851—~3kAutomated safety check: PassMIT

Similar skills

  • Second Brain Delint

    PieroSierra/SecondBrain

    Work through open findings in the latest lint report one at a time — propose a fix, apply on approval, skip on rejection.

    153 GitHub stars~1k tokensUpdated 5 days ago
    Knowledge ManagementAuto-check passed
  • Second Brain Ingest

    undefined-ui/second-brain-os

    Turn raw source material in a second-brain vault into linked wiki pages: read the source, split it into concepts and entities, write or update pages, connect them to existing pages, and record the…

    1k GitHub stars~873 tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Second Brain Lint

    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.

    1k GitHub stars~678 tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Second Brain Review

    undefined-ui/second-brain-os

    Produce a periodic review of a second-brain vault: what was added, which topics are growing, what contradicts what, which questions are still open, and what is worth reading next.

    1k GitHub stars~550 tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Second Brain

    coreyhaines31/makerskills

    When you want to capture into, compile, query, lint, or connect your personal Second Brain.

    851 GitHub stars~3k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • Second Brain Lint

    PieroSierra/SecondBrain

    Scan wiki/ for quality issues — contradictions, unsupported claims, and content gaps — and save a structured report to outputs/.

    153 GitHub stars~2.1k tokensUpdated 5 days ago
    Knowledge ManagementAuto-check passed

More from NicholasSpisak/second-brain

  • Second Brain

    NicholasSpisak/second-brain

    Set up a new Obsidian knowledge base with the LLM Wiki pattern.

    737 GitHub stars~1.5k tokensUpdated 6 mo ago
    Auto-check: notes
  • Second Brain Query

    NicholasSpisak/second-brain

    Answer questions against the knowledge base wiki. An agent skill from NicholasSpisak/second-brain.

    737 GitHub stars~712 tokensUpdated 6 mo ago
    Auto-check: notes
  • Second Brain Ingest

    NicholasSpisak/second-brain

    Process raw source documents into wiki pages. An agent skill from NicholasSpisak/second-brain.

    737 GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check: notes

Questions about Second Brain Lint

What does Second Brain Lint do?

Health-check the wiki for contradictions, orphan pages, stale claims, and missing cross-references. Second Brain Lint is an agent skill from NicholasSpisak/second-brain. Health-check the wiki for contradictions, orphan pages, stale claims, and missing cross-references.

When should I use Second Brain Lint?

Second Brain Lint fits situations like: the user says audit; wants to improve wiki quality.

How do I install Second Brain Lint in Claude Code?

Run `npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a claude-code`. Or copy the skill folder (skills/second-brain-lint in NicholasSpisak/second-brain) into .claude/skills/second-brain-lint in your project. Claude Code loads it when a task matches its description.

How do I install Second Brain Lint in Codex?

Run `npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a codex`. Or copy the skill folder (skills/second-brain-lint in NicholasSpisak/second-brain) into .agents/skills/second-brain-lint in your project. Codex loads it when a task matches its description.

Can I use Second Brain Lint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NicholasSpisak/second-brain --skill second-brain-lint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/second-brain-lint, .gemini/skills/second-brain-lint, .github/skills/second-brain-lint and .opencode/skills/second-brain-lint in your project.

What does Second Brain Lint need to run?

SKILL.md names no scripts, command-line tools or credentials: Second Brain Lint is instructions for the agent only. Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob, Grep.

Does Second Brain Lint access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Second Brain Lint safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Second Brain Lint use?

No licence was found for Second Brain Lint or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Second Brain Lint use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Second Brain Lint?

Skills that share tags, products or a category with Second Brain Lint: Second Brain Delint (PieroSierra/SecondBrain, 153 stars), Second Brain Ingest (undefined-ui/second-brain-os, 1k stars), Second Brain Lint (undefined-ui/second-brain-os, 1k stars) and Second Brain Review (undefined-ui/second-brain-os, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Second Brain Lint?

NicholasSpisak (a GitHub user) maintains it in NicholasSpisak/second-brain, which has 737 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on April 7, 2026.

Source: NicholasSpisak/second-brain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.