An OpenClaw / Codex Agent Skill for building Karpathy-style LLM knowledge bases.
Experimental skill — will iterate over time. Please send your feedbacks in github issues.
Inspired by Andrej Karpathy's llm-wiki Gist and the community's work building on it.
Instead of RAG (re-retrieving raw docs on every query), this pattern has the LLM compile raw sources into a persistent, cross-linked Markdown wiki. Every compile, ingest, query, lint, and audit pass makes the wiki richer. Knowledge compounds over time.
- You own: sourcing raw material, asking good questions, steering direction, filing feedback on things the AI got wrong.
- LLM owns: all writing, cross-referencing, filing, bookkeeping, and acting on your feedback.
The skill comes with two companion tools in this repo:
plugins/obsidian-audit/— an Obsidian plugin: select text in any page, leave a comment with severity, the comment is written intoaudit/as an anchored markdown file.web/— a local Node.js preview server: renders the wiki with mermaid, KaTeX, and wikilinks, lets you select + file feedback from the browser, and shows open audits per page.
Both tools share a single TypeScript library (audit-shared/) so audit files written from Obsidian and the web viewer are byte-identical in shape.
# Copy the skill into your agent's skills directory
cp -r llm-wiki/ ~/.claude/skills/llm-wiki/
# or for Codex
cp -r llm-wiki/ ~/.codex/skills/llm-wiki/Then reference it in your agent config, or simply paste llm-wiki/SKILL.md into your agent context.
# 1. Scaffold a new wiki
python3 llm-wiki/scripts/scaffold.py ~/my-wiki "My Research Topic"
# 2. Add a source
cp my-article.md ~/my-wiki/raw/articles/
# 3. Tell your agent: "ingest raw/articles/my-article.md"
# 4. Ask questions: "what does the wiki say about X?"
# 5. Run lint periodically
python3 llm-wiki/scripts/lint_wiki.py ~/my-wiki
# 6. File a comment from the web viewer or Obsidian plugin, then process it
python3 llm-wiki/scripts/audit_review.py ~/my-wiki --open
# then tell the agent: "audit: process the open comments"llm-wiki-skill/
├── llm-wiki/ ← The skill
│ ├── SKILL.md ← Main skill file (read by agent)
│ ├── references/
│ │ ├── schema-guide.md ← CLAUDE.md schema template
│ │ ├── article-guide.md ← Article writing (divide & conquer, mermaid, KaTeX)
│ │ ├── log-guide.md ← log/ folder convention
│ │ ├── audit-guide.md ← audit file format + processing workflow
│ │ └── tooling-tips.md ← Obsidian, qmd, plugin + web
│ └── scripts/
│ ├── scaffold.py ← Bootstrap new wiki directory
│ ├── lint_wiki.py ← 7-pass health check (links, audit, log shape)
│ └── audit_review.py ← Group open/resolved audits by target
├── audit-shared/ ← Shared TypeScript library
│ └── src/{schema,anchor,id,serialize,index}.ts
├── plugins/obsidian-audit/ ← Obsidian plugin — file audit from vault
└── web/ ← Local Node.js preview + feedback server
├── server/ ← Express + markdown-it + KaTeX + wikilinks
└── client/ ← Vanilla-TS SPA with mermaid + selection popover
# one-time setup (builds audit-shared, installs deps, bundles client)
cd audit-shared && npm install && npm run build && cd ..
cd web && npm install && npm run build && cd ..
# start the server against a wiki
cd web
npm start -- --wiki "/path/to/your/wiki-root" --port 4175
# open http://127.0.0.1:4175cd audit-shared && npm install && npm run build && cd ..
cd plugins/obsidian-audit
npm install
npm run build
npm run link -- "/path/to/your/Obsidian vault"
# Enable 'LLM Wiki Audit' in Obsidian → Settings → Community plugins.- Research deep-dive — reading papers/articles on a topic over weeks
- Personal wiki — Farzapedia-style: journal entries compiled into personal encyclopedia
- Team knowledge base — fed by Slack threads, meeting notes, docs
- Reading companion — building a rich companion wiki as you read a book
- Karpathy's original Gist
- pedronauck/skills karpathy-kb — full Obsidian vault integration
- Astro-Han/karpathy-llm-wiki — example implementation
- qmd — semantic search for Markdown wikis
MIT