llm-wiki

LLM Wiki

A pattern for building and maintaining a structured, interlinked collection of markdown files — a personal or team knowledge base — using LLM agents. The wiki is maintained incrementally alongside code work.

When to Use

Invoke this skill when you want to:

• Capture research, decisions, or references from web searches or documents into a persistent knowledge base
• Query accumulated knowledge to answer questions that require synthesizing multiple sources
• Maintain a log of what the wiki has grown to contain
• Onboard a new agent or human to a topic by pointing them at the wiki

The wiki is opt-in. Projects that don't need it are unaffected. Projects that do can build it up over time.

Setup

When activating this skill on a fresh project, create the wiki directory structure and seed files:

mkdir -p wiki raw
touch wiki/index.md wiki/log.md

wiki/index.md Template

# Wiki Index

> Content catalog for the LLM Wiki. Maintained by agents after each ingest operation.

## Topics

<!-- Add entries as you create pages:

- [[topic-name]] — Brief description

-->

## Recent Additions

<!-- Chronological list of new pages:

- [[YYYY-MM-DD]] [[page-name]] — Why it was added

-->

wiki/log.md Template

# Wiki Log

> Append-only chronological record of wiki operations. Never edit past entries.

## Usage

Each entry follows this format:

YYYY-MM-DD

ingest

• Sources:
• Pages created:
• Pages updated:
• Summary:

query

• Question:
• Answered by:
• Summary:

lint

• Issues found:
• Issues fixed:
• Summary:

---

## Architecture

The wiki operates in three layers:

┌─────────────────────────────────────────────────────────────┐ │ Raw Sources (immutable, timestamped inputs) │ │ raw/ │ │ PDFs, web captures, transcript files, etc. │ └─────────────────────────────────────────────────────────────┘ │ Ingest ▼ ┌─────────────────────────────────────────────────────────────┐ │ Wiki (LLM-maintained markdown pages) │ │ wiki/ │ │ Topic pages, concept notes, decision records, etc. │ │ Linked via [[wiki-links]] │ └─────────────────────────────────────────────────────────────┘ │ Synthesize ▼ ┌─────────────────────────────────────────────────────────────┐ │ Schema (instructions for AGENTS.md) │ │ Key facts, conventions, decisions that agents must follow │ └─────────────────────────────────────────────────────────────┘

### Raw Sources (`raw/`)

Immutable source material. Never edit after creation — this preserves provenance.

**Naming convention:**

YYYY-MM-DD-.

Example: `2024-01-15-attention-mechanism-paper.pdf`

### Wiki Pages (`wiki/`)

Markdown files maintained by agents. Organized by topic, linked via `[[double-bracket]]` links (standard in Obsidian, supported by most markdown link tools).

**Naming convention:**

-.md

Example: `attention-mechanism.md`, `transformers-vanishing-gradients.md`

**Frontmatter (required):**
```yaml
---
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [tag1, tag2]
---