karpathy-llm-wiki

A reusable skill for building Karpathy-style LLM wikis with Claude Code, Cursor, Codex, and other Agent Skills tools.

karpathy-llm-wiki packages Karpathy's LLM Wiki idea into one installable Agent Skills skill. Your coding agent ingests sources into raw/, compiles durable knowledge pages into wiki/, answers questions with citations, and lints the wiki for consistency.

What Is an LLM Wiki?

An LLM wiki is a knowledge system where the LLM maintains structured wiki pages instead of re-searching raw documents on every question. New sources are compiled into durable markdown pages, cross-references are updated over time, and answers cite the wiki pages that already contain the synthesized knowledge.

This skill gives you three operations:

Operation	What it does	Output
Ingest	Collects a source into raw/, triages it, then creates or updates wiki articles — or just logs it when nothing is new	New or updated wiki pages
Query	Searches the wiki and answers with citations	Grounded answers linking to markdown pages
Lint	Checks index integrity, links, and wiki health	Auto-fixes plus reported issues

See SKILL.md for the full skill specification.

LLM Wiki vs RAG

Approach	Knowledge lives in	When synthesis happens	Good for
RAG	Raw chunks and embeddings	At query time	Broad retrieval across large corpora
LLM Wiki	Curated markdown pages	During ingest and maintenance	Compounding knowledge, summaries, and durable cross-links

This skill is optimized for the wiki model: knowledge that improves over time instead of re-deriving relationships on every query.

Usage Stats

Based on a production knowledge base maintained daily since April 2026:

• 94 wiki articles across 13 topic directories
• 99 source materials ingested
• 87 operation log entries in the last 7 days

See examples/ for sample wiki pages, source files, and operation logs.

Install

npx add-skill Astro-Han/karpathy-llm-wiki

Works with any tool that supports the Agent Skills standard.

Quick Start

1. Ingest your first source

Give the skill a URL, a file, or pasted text:

"Ingest this article: https://example.com/attention-is-all-you-need"

The skill stores the source in raw/, then compiles or updates the right knowledge pages in wiki/.

2. Ask your wiki a question

"What do I know about attention mechanisms?"

The skill searches the wiki and answers with citations linking back to your markdown pages.

3. Keep the wiki healthy

"Lint my wiki"

Checks for broken links, missing index entries, stale cross-references, and related issues.

How the Workflow Works

The core idea from Karpathy: the LLM maintains the wiki while the human focuses on choosing sources and asking good questions.

your-project/
├── raw/            ← Immutable source material
│   └── topic/
│       └── 2026-04-03-source-article.md
├── wiki/           ← Compiled knowledge pages maintained by the LLM
│   ├── topic/
│   │   └── concept-name.md
│   ├── index.md    ← Global table of contents
│   └── log.md      ← Append-only operation log