Health check over the compiled wiki in 4-Knowledge/, written up as a ranked report.

MITAuto-check passedDevelopment

Install Lint

skills CLI
$ npx skills add superhero-tech/super-brain --skill lint -a claude-code

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

GitHub CLI
$ gh skill install superhero-tech/super-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/superhero-tech/super-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/7-Skills/lint .claude/skills/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
lint
GitHub stars
155
Token cost
~1.2k tokens
SKILL.md length
629 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Health check over the compiled wiki in 4-Knowledge/, written up as a ranked report.

  • Works in 6 steps: Decide whether there is anything to check → Read everything → Classify what you find → …
  • The human asks to check
  • SKILL.md covers How to invoke, What this catches, and what it…, How it works and Self-check, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Lint is an agent skill from superhero-tech/super-brain. Health check over the compiled wiki in 4-Knowledge/, written up as a ranked report. Use when the human asks to check or lint the wiki, on the monthly maintenance pass, or before the vault gets trusted on a decision that matters.

Its SKILL.md is about 1.2k 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 Development, covering Linting and formatting. The repository describes itself as: Product Builder Second Brain - AI Product Heroes Edition 3. The licence is MIT.

When your agent uses it

  • The human asks to check
  • On the monthly maintenance pass
  • Before the vault gets trusted on a decision that matters

Example prompts

  • “/lint”

Workflow steps

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

  1. Decide whether there is anything to check
  2. Read everything
  3. Classify what you find
  4. Write the report
  5. Log it
  6. Hand it over

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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 markdown).

    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

Lint loads about 1.2k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 629 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from superhero-tech/super-brain at commit 0922a1a, republished under its MIT licence (© superhero-tech). 629 words, ~1,245 tokens.

Download SKILL.mdSave it as .claude/skills/lint/SKILL.md (or your agent's skills folder).
name
lint
description
Health check over the compiled wiki in 4-Knowledge/, written up as a ranked report. Use when the human asks to check or lint the wiki, on the monthly maintenance pass, or before the vault gets trusted on a decision that matters.

Lint

Find what has rotted in the wiki, rank it, and hand the list to the human. Fixing is a separate decision.

Write the report in the language the wiki is written in.

How to invoke

  • "Check the wiki", "run a lint", "health check"
  • The monthly maintenance pass
  • Before the human leans on the vault for something expensive

What this catches, and what it does not

Structural problems - missing citations, orphans, index drift, stale pages - it finds reliably, because they are mechanical.

Reasoning errors it finds badly. The model running this check shares its blind spots with the model that wrote the pages, so a clean report means the wiki is tidy, not that it is right. Say this out loud when you hand over a report with no errors. 8-System/limits.md has the longer version.

How it works

1. Decide whether there is anything to check

Count the pages in 4-Knowledge/. Under ten, say there is not enough wiki to lint yet and stop. An empty report trains the human to ignore the next one.

2. Read everything

Read 4-Knowledge/index.md, then every wiki page. This is the one workflow that does not get to work from the index alone.

3. Classify what you find
SeverityWhat to look for
ERRORTwo pages that contradict each other
ERRORClaims with no [source: ...] citation
ERRORIndex entries pointing at pages that do not exist, or pages missing from the index
ERRORA sources: entry or [source: ...] citation naming a file that is not in 5-Raw/
WARNOrphan pages - nothing links to them
WARNPages marked status: needs_update, or with last_updated older than six months
WARNPages with source_count: 1 that assert more than one source can carry
INFOConcepts mentioned across several pages with no page of their own
INFOPeople, companies or tools named on three or more pages with no entity page
INFOEntity pages longer than the concept pages they point at - the argument is in the wrong place
INFOConnections worth making between existing pages

Every finding names the page and says what to do about it. "Page X has issues" is not a finding.

On the source check: a citation is only checkable if the file it names sits in 5-Raw/. Match on the file name without its extension and compare character for character - a curly apostrophe in the archived file and a straight one in the citation are two different files, and neither looks wrong when you read it on its own. When a source really is absent, say which fix applies: archive the file, or correct the citation. Those are opposite moves and guessing wrong makes it worse.

Show full SKILL.md (186 more words)Show less
4. Write the report

Save it to 4-Knowledge/lint-[YYYY-MM-DD].md:

markdown
---
title: Lint report
created: [YYYY-MM-DD]
pages_checked: [n]
---

# Lint report - [YYYY-MM-DD]

Checked [n] pages. Found [x] errors, [y] warnings, [z] notes.

## ERROR

- **[[Page Name]]** - contradicts [[Other Page]] on [claim]. `[source-a.md]` says X,
  `[source-b.md]` says Y. Neither is flagged.
- **[[Page Name]]** - cites `some-source.md`, not present in `5-Raw/`. The claim reads as
  documented and cannot be checked.

## WARN

- **[[Page Name]]** - orphan, nothing links here. Closest candidates: [[A]], [[B]]

## INFO

- "[concept]" appears on 4 pages and has none of its own. Worth writing.
- "[person or company]" is cited on 5 pages with no entity page. It has become a hub
  without one.

## Suggested next

1. [The single most valuable fix]
2. [Then this]
3. [Then this]

Rank the suggestions by what they unblock, not by severity order. An unranked report gets read once and never again.

5. Log it

Append a lint entry to 4-Knowledge/log.md. That file carries the format.

6. Hand it over

Report the counts and the top suggestion in the conversation, then stop. The human decides what gets fixed.

If they say go ahead, the fixes are a separate pass: make them, append an update entry to 4-Knowledge/log.md saying which pages changed and why, and refresh 4-Knowledge/index.md if any page description moved.

Self-check

  • Every finding names a page and a next action
  • Every cited source was checked against 5-Raw/, character for character
  • The report is on disk at 4-Knowledge/lint-[YYYY-MM-DD].md
  • 4-Knowledge/log.md has a lint entry with the counts
  • The suggestions are ranked
  • A clean report came with the caveat about what this check cannot see

Hard constraints

  • Lint reports, it does not repair. Pages change after the human agrees, never during the check.
  • Sources in 5-Raw/ are read-only. A contradiction between a page and its source is a finding about the page.

© superhero-tech, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in 7-Skills/lint of superhero-tech/super-brain.

Open the folder on GitHubat commit 0922a1a

Compare with similar skills

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.

Lint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lint this skillsuperhero-tech/super-brain155—~1.2kAutomated safety check: PassMIT
Research Lintiusztinpaul/ai-research-os-workshop179—~2.3kAutomated safety check: PassMIT
Obsidian Plugin QualityRafaelGB/Obsidian-ZettelFlow174—~1.6kAutomated safety check: PassMIT
Lint SliceHurricaHjz/second-yourself113—~3.5kAutomated safety check: PassMIT
Knowledge Lintflonat/flonat-research145—~1.7kAutomated safety check: PassMIT
Install Anti-Slop Oxlint Rulesdmmulroy/anti-slop5.2k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Research Lint

    iusztinpaul/ai-research-os-workshop

    Health-check a research directory produced by /research. An agent skill from iusztinpaul/ai-research-os-workshop.

    179 GitHub stars~2.3k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Obsidian Plugin Quality

    RafaelGB/Obsidian-ZettelFlow

    Audit ZettelFlow against the official Obsidian plugin guidelines and the Community-hub automated review / quality score.

    174 GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Lint Slice

    HurricaHjz/second-yourself

    The read-only half of the lint skill for a headless lane: index consistency, link and orphan health, the pending-flag count, the attic, qmd-registry, injection, customisation-pairing and…

    113 GitHub stars~3.5k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Knowledge Lint

    flonat/flonat-research

    Lint an existing project knowledge base for contradictions, uncited claims, missing connections, stale articles, and orphaned concepts.

    145 GitHub stars~1.7k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Installs, updates or migrates the vendored anti-slop Oxlint plugin in a repository, keeping local rule changes and the plugin's license and provenance files.

    5.2k GitHub stars~2.2k tokensUpdated 27 days ago
    DevelopmentAuto-check passed
  • Babysit PR To Pass CI

    sgl-project/sglang

    Start and persistently pursue a goal to babysit an SGLang pull request until selected GitHub Actions workflows pass on the latest PR head.

    37k GitHub starsUsed in 2 repos~3k tokens
    DevelopmentAuto-check passed

More from superhero-tech/super-brain

All 8 skills in this repo
  • Ingest

    superhero-tech/super-brain

    Compiles a source from 2-Inbox/ into the wiki, across every page it touches, then archives it.

    155 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Second Brain Setup

    superhero-tech/super-brain

    A skill your agent uses when creating or refreshing a product builder's personal profile in 8-System/about.md - supports both assessment-based (Gallup, DISC, MBTI) and interview-based onboarding

    155 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check passed
  • Feynman

    superhero-tech/super-brain

    Explains a concept from the wiki the way you would explain it to a twelve-year-old, then names where the explanation went thin.

    155 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Query

    superhero-tech/super-brain

    Answers from the compiled wiki in 4-Knowledge/, with citations and a saved output file.

    155 GitHub stars~909 tokensUpdated 1 mo ago
    Auto-check passed
  • Youtube

    superhero-tech/super-brain

    Captures a YouTube video as a source note and a wiki page. An agent skill from superhero-tech/super-brain.

    155 GitHub stars~985 tokensUpdated 1 mo ago
    Auto-check passed
  • Project Start

    superhero-tech/super-brain

    Sets up a new project folder and runs the interview that fills its brief.

    155 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Lint

What does Lint do?

Health check over the compiled wiki in 4-Knowledge/, written up as a ranked report. Lint is an agent skill from superhero-tech/super-brain. Health check over the compiled wiki in 4-Knowledge/, written up as a ranked report.

When should I use Lint?

Lint fits situations like: the human asks to check; on the monthly maintenance pass; before the vault gets trusted on a decision that matters.

How do I install Lint in Claude Code?

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

How do I install Lint in Codex?

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

Can I use 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 superhero-tech/super-brain --skill 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/lint, .gemini/skills/lint, .github/skills/lint and .opencode/skills/lint in your project.

What does Lint need to run?

SKILL.md names no scripts, command-line tools or credentials: Lint is instructions for the agent only.

Does 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 Lint safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lint use?

Lint is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lint use?

About 1.2k tokens (SKILL.md is roughly 5k 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 Lint?

Skills that share tags, products or a category with Lint: Research Lint (iusztinpaul/ai-research-os-workshop, 179 stars), Obsidian Plugin Quality (RafaelGB/Obsidian-ZettelFlow, 174 stars), Lint Slice (HurricaHjz/second-yourself, 113 stars) and Knowledge Lint (flonat/flonat-research, 145 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lint?

superhero-tech (a GitHub organization) maintains it in superhero-tech/super-brain, which has 155 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 25, 2026.

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