Ai brain wiki

Install

npx -y skills add bmaltais/skills --skill ai-brain-wiki

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Maintain and operate the AI-Brain wiki — run lint, search, ingest, and fix common issues. Covers path facts, tool commands, and known pitfalls discovered during use.

SKILL.md

3.3 KB, as published. Nobody here has run it

AI-Brain Wiki Maintenance

Key Facts

Wiki root: ${AI_BRAIN_ROOT:-$HOME/AI-Brain} (NOT ~/OneDrive/AI-Brain)
Tools: tools/lint.py, tools/search.py, tools/fix-media.py, tools/tl.py
Wiki pages: wiki/
Raw sources (immutable): raw/
Search index: .qmd/ (auto-generated)
Run all tools with: uv run python tools/<tool>.py

Search

# Build/rebuild index (required first time each session or after ingest)
cd ${AI_BRAIN_ROOT:-$HOME/AI-Brain}
uv run python tools/search.py index wiki/

# Search
uv run python tools/search.py search "your query"

Index is cached in .qmd/ — only rebuild if stale (after new ingests).

Lint

cd ${AI_BRAIN_ROOT:-$HOME/AI-Brain}
uv run python tools/lint.py

Run after every ingest. Fix all issues before ending session — they compound.

Common lint issues and fixes

Missing Counter-arguments section in concept page
- Add "## Counter-arguments and data gaps" (exact casing — all lowercase after first word)
- Minimum 4-6 bullet points; include strongest external critique even if all sources agree
Broken link [[some-slug]]
- Check if the target file actually exists: search_files for the slug in wiki/
- If it's a false positive from a code block: the lint.py bug was fixed (strips backtick spans before scanning links) — but re-check if lint.py was reverted
- If genuinely broken: create the missing page or fix the wikilink
Heading casing mismatch
- Lint checks for EXACT string "## Counter-arguments and data gaps"
- Pages that wrote "## Counter-arguments and Data Gaps" (capital D/G) will fail
- Fix: lowercase the heading
Orphan pages
- Every page needs ≥1 inbound link from another wiki page AND entry in index.md
- Add wikilink from a related page and add row to index.md

Known lint.py fix (applied 2026-04-11)

lint.py was patched to strip fenced code blocks ( ) and inline code spans ( ) before scanning for wikilinks. This prevents false-positive broken link reports when wikilinks appear as examples inside code spans.

If you see a broken link that looks like it lives inside backticks in the source file, check if lint.py has this fix:

# 4. Broken links — strip code blocks and inline code first
content_no_code = re.sub(r'```.*?```', '', content, flags=re.DOTALL)
content_no_code = re.sub(r'`[^`\n]+`', '', content_no_code)
links = re.findall(r'\[\[(.*?)\]\]', content_no_code)

If missing, patch tools/lint.py to add it.

Ingest workflow (summary)

Check ingest-manifest.md for dedup
Read + classify source
Write wiki/sources/<slug>.md
Update entities/, concepts/, overview.md as needed
Update index.md
Append log.md
Run: uv run python tools/fix-media.py --apply
Run: uv run python tools/search.py index wiki/
Every 5th ingest: PYTHONIOENCODING=utf-8 mempalace mine wiki/
Run lint: uv run python tools/lint.py — fix all issues
Append to ingest-manifest.md