llm-wiki

Files (2)

• SKILL.md
• agents-template.md · references/

SKILL.md (first lines)

# LLM Wiki

A pattern for building a personal knowledge wiki that the LLM maintains incrementally, instead of re-deriving knowledge from raw sources on every query.

## Core idea

Three layers:

- **Raw sources** (`raw/`) - immutable, user-curated. Articles, papers, transcripts, journal entries. The LLM reads but never modifies.
- **Wiki** (`wiki/`) - LLM-owned markdown pages. Summaries, entity pages, concept pages, analyses, an index, a log.
- **Schema** (`AGENTS.md` at the wiki root) - per-wiki conventions and workflows. Co-evolved with the user. Tells any LLM working in the wiki how to behave.

The wiki is a **compounding artifact**. Every ingest enriches it. Every query can be filed back into it. Cross-references, contradictions, and synthesis already live there - the LLM doesn't rebuild them on each turn.

The user curates sources, asks questions, and directs analysis. The LLM does the bookkeeping: summarizing, cross-referencing, filing, updating. Humans abandon wikis because maintenance grows faster than value. LLMs don't.

## Routing

Match the user's invocation to one of four operations:

| Trigger phrases | Operation | Section |
| --- | --- | --- |
| `/wiki-init`, "set up a wiki for X", "form a wiki", "bootstrap a wiki" | Bootstrap | [Operation: Bootstrap](#operation-bootstrap) |
| `/wiki-ingest`, "ingest this source", "add this to my wiki", "process this article into the wiki" | Ingest | [Operation: Ingest](#operation-ingest) |
| `/wiki-query`, "query my wiki", "ask my wiki", "what does my wiki say about X" | Query | [Operation: Query](#operation-query) |
| `/wiki-lint`, "lint my wiki", "health-check my wiki", "audit my wiki" | Lint | [Operation: Lint](#operation-lint) |

For Ingest/Query/Lint: if the current directory has no wiki (no `AGENTS.md` + `wiki/` + `raw/`), ask the user for the wiki path or offer to bootstrap one.

---

## Conventions (shared core)

Every operation follows these rules. They are intentionally portable: plain markdown, no editor- or plugin-specific syntax.

### Directory layout

```
<wiki-root>/
  AGENTS.md          # schema/conventions for THIS wiki, co-evolved with user
  raw/               # immutable user-curated sources
    assets/          # downloaded images and binary assets (optional)
  wiki/              # LLM-owned markdown pages
    index.md         # content-oriented catalog
    log.md           # chronological append-only record
    <pages>.md
```

### Linking

- **Standard markdown only.** `[Gandalf](gandalf.md)`. Never `[[Gandalf]]`.
- Links between wiki pages are **relative paths** within `wiki/`.
- Citations to raw sources use relative paths to `raw/` from the wiki page (e.g. `[Article](../raw/some-article.md)`).
- This is the single biggest portability rule: it works in VS Code, Cursor, Obsidian, GitHub web, and plain text editors.

### Filenames

- Kebab-case: `gandalf.md`, `the-shire.md`, `meeting-2026-04-15.md`.
- No spaces, no capital letters, no `[[brackets]]`.

### Frontmatter

Optional. If a wiki uses YAML frontmatter (e.g. `tags`, `source_count`, `updated`), the wiki's `AGENTS.md` defines the schema. The skill never requires it.

### `index.md` format

Content-oriented catalog. Flat lists grouped by category. Categories typical for most wikis:

```markdown
# Index

## Entities
- [Gandalf](gandalf.md) - Maiar wizard, member of the Istari.
- [The Shire](the-shire.md) - Hobbit homeland in Eriador.

## Concepts
- [The One Ring](one-ring.md) - Sauron's master ring of power.

## Sources
- [The Fellowship of the Ring](fellowship-summary.md) - 2026-04-15.

## Analyses
- [Comparative power of the Maiar](analysis-maiar-power.md) - 2026-04-20.
```

Each entry: `- [Title](path.md) - one-line summary`. Update on every ingest and every filed-back query.

### `log.md` format

Append-only, chronological. Every entry starts with a parseable prefix:

```markdown
## [2026-04-15] ingest | The Fellowship of the Ring (chapters 1-3)
- New: [fellowship-summary.md](fellowship-summary.md), [bilbo.md](bilbo.md)
- Updated: [gandalf.md](gandalf.md), [the-shire.md](the-shire.md), [index.md](index.md)

## [2026-04-20] query | How does the Ring corrupt its bearers?
- Filed: [analysis-ring-corruption.md](analysis-ring-corruption.md)
- Read: [one-ring.md](one-ring.md), [bilbo.md](bilbo.md), [frodo.md](frodo.md), [gollum.md](gollum.md)

## [2026-04-25] lint | health check
- 2 orphan pages, 1 broken link, 3 missing cross-references suggested
```

The `## [YYYY-MM-DD] {op} | {title}` prefix lets the user run `grep '^## \[' wiki/log.md | tail -10` to skim recent activity.

### Page types

Most wikis settle on four page types. The `AGENTS.md` template encodes them but they are not strict.

- **Entity** - a person, place, organization, character, etc. Has properties, relationships, references.
- **Concept** - an idea, theme, mechanism, framework. Has definition, examples, contrasts.
- **Source summary** - the LLM's summary of a single raw source, with citations back into `raw/`.
- **Analysis** - a synthesis or comparison generated from a query, filed back into the wiki.

---

## Operation: Bootstrap

From kyzooghost/skills, MIT.

More from kyzooghost/skills