llm-wiki — Skillopedia

LLM Wiki Skill (proposal) Purpose: Keep a compounding markdown wiki of external knowledge (articles, papers, transcripts, clipped web content) maintained by an LLM so the bookkeeping is free and the knowledge accumulates. Based on Andrej Karpathy's "LLM Wiki" pattern published April 2026. See references/architecture.md for the full design rationale and how it interoperates with existing AgentOps skills. Status: PROPOSAL — not yet merged. Opened 2026-04-11 for council review. See for the research that motivated this skill. The core idea in one paragraph RAG has a critical flaw: there is no acc…

\"\ncheck \"SKILL.md has name: llm-wiki\" \"grep -q '^name: llm-wiki' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions ingest/query/lint verbs\" \"grep -qE 'ingest|query|lint' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions raw/ or wiki/ surfaces\" \"grep -qE 'raw/|wiki/' '$SKILL_DIR/SKILL.md'\"\n\necho \"\"; echo \"Results: $PASS passed, $FAIL failed\"\n[ $FAIL -eq 0 ] && exit 0 || exit 1\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":734,"content_sha256":"a54c6ecc41f978a5c29b77624b0a61062724adb15067fb863afceb5337055ec7"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"LLM Wiki Skill (proposal)","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Purpose:","type":"text","marks":[{"type":"strong"}]},{"text":" Keep a compounding markdown wiki of ","type":"text"},{"text":"external knowledge","type":"text","marks":[{"type":"strong"}]},{"text":" (articles, papers, transcripts, clipped web content) maintained by an LLM so the bookkeeping is free and the knowledge accumulates. Based on Andrej Karpathy's \"LLM Wiki\" pattern published April 2026. See ","type":"text"},{"text":"references/architecture.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/architecture.md","title":null}}]},{"text":" for the full design rationale and how it interoperates with existing AgentOps skills.","type":"text"}]},{"type":"paragraph","content":[{"text":"Status:","type":"text","marks":[{"type":"strong"}]},{"text":" PROPOSAL — not yet merged. Opened 2026-04-11 for council review. See ","type":"text"},{"text":".agents/research/2026-04-11-karpathy-llm-wiki-integration.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" for the research that motivated this skill.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"The core idea in one paragraph","type":"text"}]},{"type":"paragraph","content":[{"text":"RAG has a critical flaw: ","type":"text"},{"text":"there is no accumulation","type":"text","marks":[{"type":"strong"}]},{"text":". Each query re-discovers fragments from the raw source corpus. The LLM Wiki pattern replaces per-query RAG with a persistent LLM-maintained markdown wiki that sits between raw sources and the user. The LLM reads each raw doc once, extracts concepts, writes summaries, cross-links related ideas, and keeps the whole thing current. On query time, the LLM reads the already-compiled wiki — much faster, much richer, and it compounds.","type":"text"}]},{"type":"paragraph","content":[{"text":"Karpathy's metaphor: ","type":"text"},{"text":"\"Obsidian is the IDE. The LLM is the programmer. The wiki is the codebase.\"","type":"text","marks":[{"type":"em"}]},{"text":" Same as AgentOps's internal-flywheel pattern, applied to external knowledge.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What this skill IS","type":"text"}]},{"type":"paragraph","content":[{"text":"A specification for four operations against a wiki-structured vault:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"ingest","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — process new raw source → write wiki pages + update index + log","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"query","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — answer a question from wiki pages → file synthesis results back as new pages","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"lint","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — periodic health-check for contradictions, stale claims, orphans, missing concepts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"promote","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — move a mature wiki page from draft to reviewed, or from wiki to authored content","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What this skill is NOT","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Not a replacement for ","type":"text","marks":[{"type":"strong"}]},{"text":"compile","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — ","type":"text"},{"text":"skills/compile","type":"text","marks":[{"type":"code_inline"}]},{"text":" handles internal AgentOps artifacts (","type":"text"},{"text":".agents/learnings/","type":"text","marks":[{"type":"code_inline"}]},{"text":" → ","type":"text"},{"text":".agents/compiled/","type":"text","marks":[{"type":"code_inline"}]},{"text":"). ","type":"text"},{"text":"llm-wiki","type":"text","marks":[{"type":"code_inline"}]},{"text":" handles ","type":"text"},{"text":"external","type":"text","marks":[{"type":"strong"}]},{"text":" source material (","type":"text"},{"text":"raw/","type":"text","marks":[{"type":"code_inline"}]},{"text":" → ","type":"text"},{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":"). They complement; they don't overlap. See ","type":"text"},{"text":"references/architecture.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" for the distinction.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Not a replacement for ","type":"text","marks":[{"type":"strong"}]},{"text":"research","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — ","type":"text"},{"text":"research","type":"text","marks":[{"type":"code_inline"}]},{"text":" writes net-new research artifacts from investigation; ","type":"text"},{"text":"llm-wiki","type":"text","marks":[{"type":"code_inline"}]},{"text":" organizes pre-existing external material. A research artifact can ","type":"text"},{"text":"cite","type":"text","marks":[{"type":"em"}]},{"text":" wiki pages; a wiki page can inform a research artifact.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Not a RAG system","type":"text","marks":[{"type":"strong"}]},{"text":" — it's the opposite. RAG retrieves fragments per query; LLM Wiki pre-compiles them into durable pages.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Not auto-scheduled","type":"text","marks":[{"type":"strong"}]},{"text":" — the skill defines the operations; scheduling (cron / systemd / launchd / Claude Code hooks) is the host's problem. References doc explains the 3-tier model (always-on Tier 1 local LLM, on-demand Tier 2 Claude, human Tier 3) but doesn't force a specific scheduler.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Start","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Initialize the wiki layout in the current project\n/llm-wiki init\n\n# Drop a raw file into raw/articles/ then ingest it\n/llm-wiki ingest raw/articles/karpathy-llm-wiki-gist.md\n\n# Query the wiki for what we know about a topic\n/llm-wiki query \"what's the Karpathy LLM Wiki pattern?\"\n\n# Lint the wiki for orphans, contradictions, stale pages\n/llm-wiki lint\n\n# Promote a mature wiki page out to authored content\n/llm-wiki promote wiki/concepts/llm-wiki.md --to platform-lab/patterns/llm-wiki-architecture.md","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Flags","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Flag","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--tier 1|2|3","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Operator tier. Tier 1 writes ","type":"text"},{"text":"status: draft","type":"text","marks":[{"type":"code_inline"}]},{"text":" only and never touches authored dirs. Tier 2 writes ","type":"text"},{"text":"status: reviewed","type":"text","marks":[{"type":"code_inline"}]},{"text":" and can promote. Tier 3 (human) does the final promotion to ","type":"text"},{"text":"MEMORY.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" / authored paths.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--raw PATH","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"raw/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Override the default raw inbox location","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--wiki PATH","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Override the default wiki output location","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--dry-run","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Show what would be ingested/written without making changes","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--force","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"lint","type":"text","marks":[{"type":"code_inline"}]},{"text":", apply auto-fixes (orphan linking, stale flagging) instead of just reporting","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--since DATE","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"30 days","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"lint","type":"text","marks":[{"type":"code_inline"}]},{"text":", only consider pages touched since this date","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--index PATH","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"INDEX.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Override the index location","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--log PATH","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"LOG.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Override the log location","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Execution phases","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 1 — ","type":"text"},{"text":"init","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"Create the wiki layout in the current project if not already present:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"\u003cproject>/\n├── INDEX.md ← content catalog\n├── LOG.md ← append-only operation log\n├── SOUL.md ← (optional) user identity for always-load\n├── CRITICAL_FACTS.md ← (optional) ~150-token always-load context\n├── raw/ ← Karpathy raw layer\n│ ├── articles/\n│ ├── papers/\n│ ├── transcripts/\n│ ├── screenshots/\n│ └── assets/\n└── wiki/ ← Karpathy compiled layer\n ├── sources/ ← per-raw-doc summaries\n ├── entities/ ← people, orgs, products, tools\n ├── concepts/ ← ideas, frameworks, theories\n └── synthesis/ ← cross-cutting analyses","type":"text"}]},{"type":"paragraph","content":[{"text":"Seeds ","type":"text"},{"text":"INDEX.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"LOG.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" with headers; leaves ","type":"text"},{"text":"SOUL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"CRITICAL_FACTS.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" as optional stubs. Writes a ","type":"text"},{"text":"_CLAUDE.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" (or updates existing) with the workflow sections. ","type":"text"},{"text":"Idempotent","type":"text","marks":[{"type":"strong"}]},{"text":" — re-running on an existing layout is a no-op.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 2 — ","type":"text"},{"text":"ingest \u003craw-path>","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"For each raw source:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Read it fully (don't skim).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write a summary page at ","type":"text"},{"text":"wiki/sources/\u003cslug>.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" with frontmatter:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"yaml"},"content":[{"text":"type: source\nraw: \u003cpath to raw file>\ningested: \u003cISO datetime>\nstatus: draft|reviewed # draft if Tier 1, reviewed if Tier 2","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Extract candidate ","type":"text"},{"text":"entities","type":"text","marks":[{"type":"strong"}]},{"text":" (people, organizations, products, tools) → stub pages in ","type":"text"},{"text":"wiki/entities/","type":"text","marks":[{"type":"code_inline"}]},{"text":" or update existing ones. Add a backlink from the source page.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Extract candidate ","type":"text"},{"text":"concepts","type":"text","marks":[{"type":"strong"}]},{"text":" (ideas, frameworks) → stub pages in ","type":"text"},{"text":"wiki/concepts/","type":"text","marks":[{"type":"code_inline"}]},{"text":" or update existing ones.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Update ","type":"text"},{"text":"INDEX.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" with every new page. ","type":"text"},{"text":"Failure to update index = lint failure later.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Append to ","type":"text"},{"text":"LOG.md","type":"text","marks":[{"type":"code_inline"}]},{"text":": ","type":"text"},{"text":"YYYY-MM-DD HH:MM | \u003cactor> | INGEST | \u003csource slug> | \u003cpages created> | \u003cwikilink>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If any existing ","type":"text"},{"text":"wiki/synthesis/*","type":"text","marks":[{"type":"code_inline"}]},{"text":" page covers this topic, revise it to incorporate the new source; don't leave stale versions.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Tier 1 constraint:","type":"text","marks":[{"type":"strong"}]},{"text":" If running as ","type":"text"},{"text":"--tier 1","type":"text","marks":[{"type":"code_inline"}]},{"text":", all writes get ","type":"text"},{"text":"status: draft","type":"text","marks":[{"type":"code_inline"}]},{"text":". Tier 1 never touches ","type":"text"},{"text":"wiki/synthesis/","type":"text","marks":[{"type":"code_inline"}]},{"text":" (synthesis requires review). Tier 1 never modifies existing ","type":"text"},{"text":"status: reviewed","type":"text","marks":[{"type":"code_inline"}]},{"text":" pages.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 3 — ","type":"text"},{"text":"query \u003cquestion>","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"Answer a question from the wiki:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Search ","type":"text"},{"text":"wiki/**","type":"text","marks":[{"type":"code_inline"}]},{"text":" for relevant pages. Also check ","type":"text"},{"text":".agents/learnings/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":".agents/findings/","type":"text","marks":[{"type":"code_inline"}]},{"text":", authored content dirs if present.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Synthesize an answer with citations — every non-trivial claim must cite a specific page via wikilink.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the answer is non-trivial and likely to be asked again, file it as a new ","type":"text"},{"text":"wiki/synthesis/\u003cslug>.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" with the question, answer, and citations.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Append to ","type":"text"},{"text":"LOG.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" with op ","type":"text"},{"text":"QUERY","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Authored content takes precedence over wiki drafts.","type":"text","marks":[{"type":"strong"}]},{"text":" If a concept is already covered in ","type":"text"},{"text":".agents/findings/","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":".agents/learnings/","type":"text","marks":[{"type":"code_inline"}]},{"text":", cite that first and treat the wiki as supplementary.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 4 — ","type":"text"},{"text":"lint","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"Walk ","type":"text"},{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":" and flag:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Orphan pages","type":"text","marks":[{"type":"strong"}]},{"text":" — no backlinks from any other wiki page and no entry in ","type":"text"},{"text":"INDEX.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Broken wikilinks","type":"text","marks":[{"type":"strong"}]},{"text":" — links pointing at pages that don't exist","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Stale pages","type":"text","marks":[{"type":"strong"}]},{"text":" — ","type":"text"},{"text":"ingested","type":"text","marks":[{"type":"code_inline"}]},{"text":" date > ","type":"text"},{"text":"--since","type":"text","marks":[{"type":"code_inline"}]},{"text":" cutoff AND the domain is evolving (user-configured stale-domain list)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Contradictions","type":"text","marks":[{"type":"strong"}]},{"text":" — two pages making incompatible claims without a reconciliation note. Simple keyword heuristic + LLM re-read for candidates.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Missing concepts","type":"text","marks":[{"type":"strong"}]},{"text":" — entities or concepts referenced in ","type":"text"},{"text":"wiki/sources/","type":"text","marks":[{"type":"code_inline"}]},{"text":" that don't have a dedicated page","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Index drift","type":"text","marks":[{"type":"strong"}]},{"text":" — files in ","type":"text"},{"text":"wiki/**","type":"text","marks":[{"type":"code_inline"}]},{"text":" that aren't listed in ","type":"text"},{"text":"INDEX.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", OR index entries that point at non-existent files","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Write findings to ","type":"text"},{"text":"wiki/synthesis/lint-YYYY-MM-DD.md","type":"text","marks":[{"type":"code_inline"}]},{"text":". ","type":"text"},{"text":"Don't auto-fix by default","type":"text","marks":[{"type":"strong"}]},{"text":" — lint reports, human or Tier 2 decides.","type":"text"}]},{"type":"paragraph","content":[{"text":"With ","type":"text"},{"text":"--force","type":"text","marks":[{"type":"code_inline"}]},{"text":", auto-fix:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Add missing index entries","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Flag stale pages with ","type":"text"},{"text":"status: stale","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Write orphan warning comments to orphan pages","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Append to ","type":"text"},{"text":"LOG.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" with op ","type":"text"},{"text":"LINT","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 5 — ","type":"text"},{"text":"promote \u003cwiki-path> --to \u003cdestination>","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"Move a mature wiki page to authored content:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Verify the destination is a valid target (","type":"text"},{"text":"platform-lab/patterns/*","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"career/*","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"learning/*","type":"text","marks":[{"type":"code_inline"}]},{"text":", or similar project-specific authored dirs).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"git mv","type":"text","marks":[{"type":"code_inline"}]},{"text":" to preserve history if possible; otherwise rewrite.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Update ","type":"text"},{"text":"INDEX.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" — remove from wiki section, add to authored section.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Find and update all backlinks to the old path.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Append to ","type":"text"},{"text":"LOG.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" with op ","type":"text"},{"text":"PROMOTE","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Tier 1 cannot promote.","type":"text","marks":[{"type":"strong"}]},{"text":" Tier 2 can promote within the wiki (","type":"text"},{"text":"status: draft","type":"text","marks":[{"type":"code_inline"}]},{"text":" → ","type":"text"},{"text":"reviewed","type":"text","marks":[{"type":"code_inline"}]},{"text":"). Tier 3 (human) promotes out of the wiki to authored dirs.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Integration with existing AgentOps skills","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Skill","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Interaction","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"skills/compile","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Operates on internal ","type":"text"},{"text":".agents/","type":"text","marks":[{"type":"code_inline"}]},{"text":" artifacts → ","type":"text"},{"text":".agents/compiled/","type":"text","marks":[{"type":"code_inline"}]},{"text":". Structurally identical to ","type":"text"},{"text":"llm-wiki","type":"text","marks":[{"type":"code_inline"}]},{"text":" but for internal sources. The two wikis (","type":"text"},{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":".agents/compiled/","type":"text","marks":[{"type":"code_inline"}]},{"text":") can cross-link but don't merge.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"skills/research","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Can cite wiki pages in research artifacts. Can optionally run ","type":"text"},{"text":"llm-wiki ingest","type":"text","marks":[{"type":"code_inline"}]},{"text":" on material as a pre-step to writing a research artifact.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"skills/forge","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Can promote wiki-page concepts that have crystallized into reusable patterns into ","type":"text"},{"text":".agents/findings/","type":"text","marks":[{"type":"code_inline"}]},{"text":" via its normal finding-registry flow.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"skills/inject","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Should learn to inject relevant ","type":"text"},{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":" pages alongside ","type":"text"},{"text":".agents/*","type":"text","marks":[{"type":"code_inline"}]},{"text":" content when a session starts.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"skills/post-mortem","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Phase 2 (Extract Learnings) can be informed by recent ","type":"text"},{"text":"wiki/synthesis/","type":"text","marks":[{"type":"code_inline"}]},{"text":" pages as supporting context.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"skills/pre-mortem","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Can query ","type":"text"},{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":" for past context on the domain being pre-mortem'd.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"skills/knowledge-activation","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Can activate high-value wiki pages into MEMORY.md alongside ","type":"text"},{"text":".agents/learnings/","type":"text","marks":[{"type":"code_inline"}]},{"text":" promotions.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Relationship to the AgentOps flywheel","type":"text"}]},{"type":"paragraph","content":[{"text":"The AgentOps flywheel compounds ","type":"text"},{"text":"internal work knowledge","type":"text","marks":[{"type":"strong"}]},{"text":" (what we did, what we learned, what went wrong). The LLM Wiki compounds ","type":"text"},{"text":"external reading knowledge","type":"text","marks":[{"type":"strong"}]},{"text":" (what we read, what others figured out, what the state of the art is).","type":"text"}]},{"type":"paragraph","content":[{"text":"Both flywheels feed each other:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Wiki pages can be cited by research artifacts that feed the internal flywheel","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Internal learnings can reference wiki pages when explaining \"why we adopted approach X\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Findings can be enriched with wiki-sourced context","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Design principle:","type":"text","marks":[{"type":"strong"}]},{"text":" external and internal knowledge live in separate trees (","type":"text"},{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":" vs ","type":"text"},{"text":".agents/","type":"text","marks":[{"type":"code_inline"}]},{"text":") so the provenance is always clear. The two trees cross-link; they don't merge.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Scheduling (not part of this skill, but referenced)","type":"text"}]},{"type":"paragraph","content":[{"text":"The Karpathy pattern works best when the skill runs ","type":"text"},{"text":"on a schedule","type":"text","marks":[{"type":"strong"}]},{"text":", not just on-demand. The proposed 3-tier model (from the community implementations):","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tier 1 — always on, cheap local LLM","type":"text","marks":[{"type":"strong"}]},{"text":" (e.g., Gemma 4 26B A4B on a consumer GPU). Nightly ingest of ","type":"text"},{"text":"raw/","type":"text","marks":[{"type":"code_inline"}]},{"text":", draft generation, orphan detection, lint.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tier 2 — on-demand expensive expert","type":"text","marks":[{"type":"strong"}]},{"text":" (Claude / Codex / equivalent). Weekly review of drafts, synthesis, promotion to authored content.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tier 3 — human","type":"text","marks":[{"type":"strong"}]},{"text":". Weekly approval of promotions to long-term memory / authored content.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"references/architecture.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" for the full tier model and scheduling recommendations. The skill is tier-agnostic; the host project wires up the scheduler.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Open questions for council review","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Should the wiki layout (","type":"text"},{"text":"raw/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":") live at project root, or under ","type":"text"},{"text":".agents/wiki/","type":"text","marks":[{"type":"code_inline"}]},{"text":"? ","type":"text"},{"text":"Proposal recommendation: project root","type":"text","marks":[{"type":"strong"}]},{"text":", to keep external knowledge visibly distinct from internal work.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Does this overlap with ","type":"text"},{"text":"skills/compile","type":"text","marks":[{"type":"code_inline"}]},{"text":" enough that the two should merge? ","type":"text"},{"text":"Proposal recommendation: no","type":"text","marks":[{"type":"strong"}]},{"text":" — keep them separate and document the split.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Should the 3-tier model be baked into the skill via a ","type":"text"},{"text":"--tier","type":"text","marks":[{"type":"code_inline"}]},{"text":" flag, or left as convention? ","type":"text"},{"text":"Proposal recommendation: ","type":"text","marks":[{"type":"strong"}]},{"text":"--tier","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" flag","type":"text","marks":[{"type":"strong"}]},{"text":" with Tier 2 as default.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Should ","type":"text"},{"text":"init","type":"text","marks":[{"type":"code_inline"}]},{"text":" also seed ","type":"text"},{"text":"SOUL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"CRITICAL_FACTS.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", or leave them optional? ","type":"text"},{"text":"Proposal recommendation: seed as stubs","type":"text","marks":[{"type":"strong"}]},{"text":" with instructions.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What's the right output contract? Post-mortem uses ","type":"text"},{"text":"council/schemas/verdict.json","type":"text","marks":[{"type":"code_inline"}]},{"text":"; should ","type":"text"},{"text":"llm-wiki","type":"text","marks":[{"type":"code_inline"}]},{"text":" have its own output schema for ingest/query/lint results? ","type":"text"},{"text":"Proposal recommendation: yes","type":"text","marks":[{"type":"strong"}]},{"text":", shape TBD by council.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"References","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".agents/research/2026-04-11-karpathy-llm-wiki-integration.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" — the research artifact that motivated this skill","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/architecture.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/architecture.md","title":null}}]},{"text":" — full design rationale, tier model, interop details, anti-patterns","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/research.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/research.md","title":null}}]},{"text":" — external-source research summary and synthesis","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Karpathy's original LLM Wiki gist (April 2026)","type":"text","marks":[{"type":"link","attrs":{"href":"https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Community implementations: ","type":"text"},{"text":"NicholasSpisak/second-brain","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/NicholasSpisak/second-brain","title":null}}]},{"text":", ","type":"text"},{"text":"eugeniughelbur/obsidian-second-brain","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/eugeniughelbur/obsidian-second-brain","title":null}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"See Also","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"skills/compile/SKILL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" — the internal-artifact compiler (structurally identical pattern, different source)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"skills/research/SKILL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" — research artifact authoring","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"skills/forge/SKILL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" — mining knowledge from transcripts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"skills/inject/SKILL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" — context injection at session start","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"skills/post-mortem/SKILL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" — the six-phase knowledge flywheel this skill extends externally","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Proposal status: OPEN","type":"text","marks":[{"type":"strong"}]},{"text":". This SKILL.md describes the intended behavior but ","type":"text"},{"text":"there is no implementation yet","type":"text","marks":[{"type":"strong"}]},{"text":". Council review (via ","type":"text"},{"text":"/pre-mortem --preset=product","type":"text","marks":[{"type":"code_inline"}]},{"text":") should validate the design before any code is written. If accepted, the next step is to implement the ","type":"text"},{"text":"ingest","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"query","type":"text","marks":[{"type":"code_inline"}]},{"text":" phases first (ship them as experimental), then ","type":"text"},{"text":"lint","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"promote","type":"text","marks":[{"type":"code_inline"}]},{"text":" once the first two are validated.","type":"text"}]}]},"metadata":{"date":"2026-06-05","name":"llm-wiki","author":"@skillopedia","source":{"stars":375,"repo_name":"agentops","origin_url":"https://github.com/boshu2/agentops/blob/HEAD/skills/llm-wiki/SKILL.md","repo_owner":"boshu2","body_sha256":"7bc845aa61b0fb32bb62b88fa00b2f84e6b105da76352fdc9233708dcae8cd60","cluster_key":"7ac68bb7c472ea20cc84f3b66cdf181f771a015d8900dddc1e0d3a0ea7fa3c05","clean_bundle":{"format":"clean-skill-bundle-v1","source":"boshu2/agentops/skills/llm-wiki/SKILL.md","attachments":[{"id":"641097aa-ea9d-558b-8166-dd7de67b38cd","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/641097aa-ea9d-558b-8166-dd7de67b38cd/attachment.md","path":"references/architecture.md","size":14808,"sha256":"ce51edcc7e383dc9dbf8ae4dbcc6025c3516635649780b7b6745a5dd0accd596","contentType":"text/markdown; charset=utf-8"},{"id":"ffd7501a-255a-5261-abdf-3bc82f455372","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/ffd7501a-255a-5261-abdf-3bc82f455372/attachment.md","path":"references/research.md","size":15289,"sha256":"254b77c75d09cb234098d19a328b10fe2bed68cbc064b557930b771345ef9bb4","contentType":"text/markdown; charset=utf-8"},{"id":"67069d1a-3db2-5133-8faf-144ac7faa0c8","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/67069d1a-3db2-5133-8faf-144ac7faa0c8/attachment.sh","path":"scripts/validate.sh","size":734,"sha256":"a54c6ecc41f978a5c29b77624b0a61062724adb15067fb863afceb5337055ec7","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"e78644acbf174d67ffd71920c33c09cf3bccf82cd316619ba2501b1af2f06043","attachment_count":3,"text_attachments":3,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills/llm-wiki/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"web-development","category_label":"Web"},"exact_dupes_collapsed_into_this":0},"context":{"intent":{"mode":"task"},"window":"fork","sections":{"exclude":["HISTORY"]},"intel_scope":"full"},"version":"v1","category":"web-development","consumes":[],"metadata":{"tier":"knowledge","status":"proposal","dependencies":["compile","research","forge","inject"]},"produces":["documentation"],"practices":["wiki-knowledge-surface","ddd-bounded-context","prompt-as-spec"],"import_tag":"clean-skills-v1","context_rel":[],"description":"Build external-knowledge wikis.","hexagonal_role":"supporting","skill_api_version":1}},"renderedAt":1782981556641}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.