karpathy-llm-wiki
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 247 GitHub stars
Code Warn
- Code scan incomplete — No supported source files were scanned during light audit
Permissions Pass
- Permissions — No dangerous permissions requested
This agent skill provides a workflow to build and maintain a personal, "Karpathy-style" knowledge wiki. It automatically ingests source materials, organizes them into articles, allows you to query the stored knowledge, and runs diagnostics to fix broken links or inconsistencies.
Security Assessment
Overall Risk: Medium. While a light code scan was incomplete, the tool's documented behaviors require handling external inputs. Because its core function involves the "Ingest" operation, it inherently makes outbound network requests to fetch URLs and external files. Additionally, as an interactive agent skill, it executes file system write operations to manage the wiki database and maintain logs. It does not appear to request dangerous system permissions or contain hardcoded secrets. Users should be aware that fetched external content could contain malicious text, though the risk is limited to the local wiki directory.
Quality Assessment
Overall quality appears to be very high. The project is actively maintained, with repository activity noted as recently as today. It has generated strong community trust, backed by nearly 250 GitHub stars. Furthermore, it is fully open-source under the standard MIT license, meaning the underlying code can be freely inspected, modified, and used.
Verdict
Use with caution—while it is a popular and active project, the lack of a completed automated code scan means you should manually review its fetch and file execution logic before deploying.
One skill to build your own Karpathy-style LLM wiki.
karpathy-llm-wiki
One skill to build your own Karpathy-style LLM wiki.
Battle-Tested
This skill powers a real knowledge base that's been in daily use since April 2026:
| Metric | Count | Growth |
|---|---|---|
| Wiki articles | 94 | 48 → 94 (nearly doubled) |
| Source materials | 99 | From zero |
| Topic directories | 13 | 8 → 13 |
| Operation log entries | 87 | Every day |
| Recent 7 days activity | 87 entries | Active maintenance |
Top topics: ai-coding-tools (29 articles), ai-research (24), product-design-frameworks (8).
See examples/ for real articles, raw sources, and the operation log.
Install
npx add-skill Astro-Han/karpathy-llm-wiki
Works with Claude Code, Cursor, Codex, and other tools that support the Agent Skills standard.
Quick Start
1. Ingest your first source
Give the skill a URL, a file, or paste text directly:
"Ingest this article: https://example.com/attention-is-all-you-need"
The skill fetches the content into raw/, then compiles it into a wiki article under wiki/.
2. Ask your wiki a question
"What do I know about attention mechanisms?"
The skill searches your wiki and answers with citations linking back to your articles.
3. Keep it healthy
"Lint my wiki"
The skill checks for broken links, missing index entries, stale cross-references, and reports potential issues.
How It Works
Inspired by Karpathy's LLM Wiki idea:
"The LLM writes and maintains the wiki; the human reads and asks questions."
The skill manages two directories in your project:
your-project/
├── raw/ ← Immutable source material (you or the LLM add, never modify)
│ └── topic/
│ └── 2026-04-03-source-article.md
├── wiki/ ← Compiled knowledge (LLM maintains)
│ ├── topic/
│ │ └── concept-name.md
│ ├── index.md ← One-page table of contents
│ └── log.md ← Append-only operation log
Three operations:
| Operation | What it does |
|---|---|
| Ingest | Fetch a source into raw/, compile into wiki/, update index and cross-references |
| Query | Search the wiki and answer with citations. Optionally archive answers as wiki pages |
| Lint | Auto-fix broken links and index gaps. Report contradictions, orphan pages, stale content |
The wiki compounds over time. Each new source enriches existing articles, adds cross-references, and flags conflicts.
Compatibility
This skill follows the agentskills.io open standard. It works with any LLM coding tool that supports SKILL.md:
| Tool | Install method |
|---|---|
| Claude Code | npx add-skill Astro-Han/karpathy-llm-wiki |
| Cursor | npx add-skill Astro-Han/karpathy-llm-wiki (auto-converts) |
| Codex CLI | Copy to .agents/skills/karpathy-llm-wiki/ |
| Others | Copy SKILL.md + references/ to your tool's skill directory |
Inspired By
This is an unofficial community implementation of the LLM Wiki workflow described in Karpathy's idea file (April 2026). The core value is a battle-tested set of compilation principles and workflow templates, not the code itself.
License
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found