https://github.com/Astro-Han/karpathy-llm-wiki
Agent Skills-compatible LLM wiki for Claude Code, Cursor, and Codex. Build a Karpathy-style knowledge base from raw sources, citations, and linting.
https://github.com/Astro-Han/karpathy-llm-wiki
agent-skill claude-code codex cursor karpathy knowledge-base knowledge-management llm llm-wiki markdown personal-knowledge-base productivity rag-alternative
Last synced: about 5 hours ago
JSON representation
Agent Skills-compatible LLM wiki for Claude Code, Cursor, and Codex. Build a Karpathy-style knowledge base from raw sources, citations, and linting.
- Host: GitHub
- URL: https://github.com/Astro-Han/karpathy-llm-wiki
- Owner: Astro-Han
- License: mit
- Created: 2026-04-05T06:17:20.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-13T01:39:31.000Z (2 months ago)
- Last Synced: 2026-04-21T18:16:48.433Z (2 months ago)
- Topics: agent-skill, claude-code, codex, cursor, karpathy, knowledge-base, knowledge-management, llm, llm-wiki, markdown, personal-knowledge-base, productivity, rag-alternative
- Size: 298 KB
- Stars: 563
- Watchers: 6
- Forks: 70
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-claude-skills - karpathy-llm-wiki - Markdown-first skill for building and maintaining a personal LLM wiki from raw sources, compiled knowledge pages, query workflows, and linting. (📘 Learning & Knowledge)
README
# karpathy-llm-wiki
**A reusable skill for building Karpathy-style LLM wikis with Claude Code, Cursor, Codex, and other Agent Skills tools.**
[](LICENSE)
[](https://github.com/Astro-Han/karpathy-llm-wiki)
[](https://github.com/Astro-Han/karpathy-llm-wiki)
[](https://agentskills.io)
[](https://github.com/Astro-Han/karpathy-llm-wiki#install)
`karpathy-llm-wiki` packages [Karpathy's LLM Wiki idea](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) into one installable [Agent Skills](https://agentskills.io) 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/` and compiles it into the wiki | 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](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/](examples/) for sample wiki pages, source files, and operation logs.
## Install
```bash
npx add-skill Astro-Han/karpathy-llm-wiki
```
Works with any tool that supports the [Agent Skills](https://agentskills.io) 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.
```text
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
```
Each new source can update multiple pages, strengthen cross-references, and record contradictions. That is what makes the wiki compound over time.
## Tool Compatibility
This skill follows the [agentskills.io](https://agentskills.io) open standard:
| Tool | Install method |
|------|----------------|
| Claude Code | `npx add-skill Astro-Han/karpathy-llm-wiki` |
| Cursor | `npx add-skill Astro-Han/karpathy-llm-wiki` |
| Codex CLI | Copy to `.agents/skills/karpathy-llm-wiki/` |
| OpenCode | `npx add-skill Astro-Han/karpathy-llm-wiki` |
| Other tools | Copy `SKILL.md` and `references/` into the tool's skill directory |
## FAQ
### What is the difference between an LLM wiki and a personal wiki?
An LLM wiki is maintained by the model. It updates summaries, cross-links, index entries, and contradictions as new material arrives. A normal personal wiki depends on manual editing.
### What sources can I ingest?
Web pages, papers, blog posts, PDFs, markdown files, text files, and pasted text. The skill converts everything into markdown under `raw/` and compiles it into `wiki/`.
### Is this production-ready?
The workflow is based on a real knowledge base with 94 articles and 99 sources maintained daily since April 2026. The repo includes examples, templates, and a design spec.
## Inspired By
Unofficial community implementation of the workflow from [Karpathy's LLM Wiki idea](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). The value here is the reusable workflow, prompt structure, and battle-tested knowledge-compilation rules.
See also: [lucasastorian/llmwiki](https://github.com/lucasastorian/llmwiki), [atomicmemory/llm-wiki-compiler](https://github.com/atomicmemory/llm-wiki-compiler).
## License
[MIT](LICENSE)