Build and maintain a persistent markdown wiki that an LLM updates on the user's behalf, usually inside an Obsidian vault or git-tracked notes repo. Use when raw sources such as web articles, papers, meeting notes, transcripts, screenshots, or past analyses need to be turned into an interlinked knowledge base with immutable source files, LLM-written wiki pages, `index.md`, `log.md`, schema rules in `AGENTS.md` or `CLAUDE.md`, source summaries, query notes, and recurring lint passes. Triggers on: llm-wiki, personal wiki, obsidian wiki, research vault, knowledge base, source ingest, persistent notes, wiki maintenance, source summaries, query filing.
Build and maintain a persistent markdown wiki that an LLM updates on the user's behalf, usually inside an Obsidian vault or git-tracked notes repo. Use when raw sources such as web articles, papers, meeting notes, transcripts, screenshots, or past analyses need to be turned into an interlinked knowledge base with immutable source files, LLM-written wiki pages, `index.md`, `log.md`, schema rules in `AGENTS.md` or `CLAUDE.md`, source summaries, query notes, and recurring lint passes. Triggers on: llm-wiki, personal wiki, obsidian wiki, research vault, knowledge base, source ingest, persistent notes, wiki maintenance, source summaries, query filing.
llm-wiki - Persistent LLM-Maintained Markdown Wiki
Keyword: llm-wiki · obsidian wiki · research vault · knowledge base
Use this skill when the user wants knowledge to accumulate as a maintained markdown artifact, not be rediscovered from raw files on every query.
llm-wiki turns Andrej Karpathy's gist into an operational workflow. The core pattern is simple: keep raw sources immutable, let the LLM own the wiki layer, and encode the maintenance contract in AGENTS.md or CLAUDE.md.
When to use this skill
Bootstrap a new Obsidian or markdown vault for long-lived knowledge work
Convert raw articles, papers, transcripts, or notes into source summaries plus cross-linked wiki pages
Maintain index.md and log.md as navigational primitives before adding heavier search infrastructure
File good answers back into the wiki instead of losing them in chat history
Run periodic lint passes for broken links, orphan pages, stale claims, and missing synthesis pages
Add optional helpers such as Scrapling for URL ingestion, qmd for search, or Obsidian CLI for vault automation
Instructions
Step 1: Bootstrap the vault
Create the wiki skeleton first:
bash scripts/bootstrap-vault.sh /path/to/vault
The bootstrap creates:
raw/sources/ for immutable source markdown or copied files
raw/assets/ for downloaded images and attachments
wiki/sources/ for per-source summaries
wiki/entities/ and wiki/concepts/ for durable synthesis pages
wiki/queries/ and wiki/reports/ for filed answers and higher-value outputs
Step 2: Treat AGENTS.md or CLAUDE.md as the operating contract
The schema should encode the rules that stay true across sessions:
raw/ is source of truth and must stay immutable
wiki/ plus index.md and log.md are LLM-owned working artifacts
Every ingest updates the source summary, relevant synthesis pages, index.md, and log.md
Every durable query answer gets filed back into wiki/queries/ or wiki/reports/
Lint passes must look for broken links, orphan pages, stale claims, contradictions, and missing page candidates
Keep the schema short and enforceable. A small contract that the agent actually follows is better than a giant policy file nobody will reread. The starter schema from bootstrap-vault.sh is intentionally minimal; refine it with references/schema-playbook.md.
Step 3: Ingest one source at a time until the workflow is stable
If the source is already local, place it in raw/sources/ and ask the agent to process it. If the source is a URL, use the Scrapling-powered helper:
Create or refresh a source page under wiki/sources/
Update relevant entity or concept pages
Update index.md
Append a chronological entry to log.md
Prefer one-source-at-a-time ingest when starting. It forces the human to inspect what the wiki changed, surface missing conventions, and refine the schema. Once the workflow is reliable, batching is fine. Use references/ingest-playbook.md for the operating checklist.
Step 4: Query against the wiki, not the raw pile
When answering questions:
Read index.md first
Open the most relevant wiki pages
Drill into raw sources only when the wiki needs grounding or conflict resolution
Cite page paths and raw source paths explicitly
File durable outputs back into the vault
Create a reusable note stub for high-value answers:
bash scripts/new-query-note.sh /path/to/vault "How does Company A differ from Company B?" --question "How does Company A differ from Company B?"
bash scripts/new-query-note.sh /path/to/vault "Q2 product thesis" --section reports --citation "[[wiki/concepts/product-thesis]]"
Use wiki/queries/ for question-shaped outputs and wiki/reports/ for more durable synthesized artifacts such as memos, comparisons, or presentation backbones. More detail lives in references/query-and-filing.md.
This script focuses on structure, not truth. It checks required files and directories, broken wiki links, and orphan pages. Use the lint output as the starting point for a human-guided cleanup pass:
merge duplicate concepts
promote heavily referenced ideas into their own page
retire stale claims superseded by newer sources
add backlinks or summary pages where the graph is too sparse
Step 6: Add search and automation only when scale justifies it
index.md plus log.md is enough for small-to-medium vaults. Add heavier tools later:
Scrapling when URL ingestion becomes common
qmd when the index is no longer sufficient for wiki search
Obsidian CLI when you want shell-driven vault automation against a running desktop app
Dataview when you start relying on frontmatter-driven tables and lists
Git from day one for version history, branching, and reviewable diffs
Do not force embeddings, MCP, or browser automation on day one. The point of this workflow is that a simple markdown repo already compounds knowledge surprisingly well.
bash scripts/new-query-note.sh ~/vaults/company-research "Why this market is consolidating" \
--question "Why is this market consolidating?" \
--citation "[[wiki/concepts/market-structure]]"
Example 5: Create a report stub instead of a query note
