@engnr.sam/llmwiki

llmwiki

Build and maintain a persistent, compounding LLM wiki — a directory of interlinked markdown files where the LLM writes and maintains all content. Following the Andrej Karpathy pattern: the human curates raw sources and directs analysis; the LLM handles summarization, cross-referencing, and bookkeeping. No tool lock-in — just a git repo of standard markdown.

Install

npx llmwiki

You'll be asked where to install:

[g] Global — all agent platforms (~/.agents, ~/.claude, ~/.opencode)
[l] Local  — this project only (./.agents/skills/llmwiki)
[b] Both   — global + local

Or skip the prompt with flags:

npx llmwiki --global     # global only
npx llmwiki --local      # local only
npx llmwiki --both       # global + local
npx llmwiki --target ~/projects/my-app   # custom path

Options

Flag	Description
-g, --global	Install globally across all agent platforms
-l, --local	Install into the current project only
-b, --both	Install both globally and locally
--target <path>	Install into a specific path
--dry-run	Show what would be installed without writing files
--force	Overwrite existing skill files
--uninstall	Remove the skill from all directories

Usage

Once installed, invoke with /llmwiki followed by a natural language instruction. Four workflows:

/llmwiki build <topic>   # Scaffold a new wiki
/llmwiki ingest <path>   # Process raw sources into wiki pages
/llmwiki query <question> # Answer from wiki knowledge with citations
/llmwiki audit           # Health-check the entire wiki

Build

Scaffolds a new llm-wiki in a directory named [topic_name]. Creates the full directory structure (raw/, wiki/concepts/, wiki/entities/, wiki/summaries/, wiki/syntheses/), seeds index.md and log.md, copies the schema, and initializes a git repo.

Ingest

Processes raw source files from raw/ and integrates extracted knowledge into the wiki. Extracts concepts, entities, claims, explanations, and figures; creates summary, concept, and entity pages with bidirectional wikilinks; detects contradictions; auto-generates synthesis pages for sibling concepts.

Query

Searches the wiki, reads relevant pages, and synthesizes a concise answer with inline citations as [[wikilinks]]. Offers to file the answer back as a synthesis page.

Audit

Scans every page for health issues: unresolved contradictions, stale claims, orphan pages, missing cross-references, dangling wikilinks, and data gaps. Presents a structured report and asks whether to fix.

What's Inside

skill/
├── SKILL.md    # The skill body — 4 workflows and page format conventions
└── SCHEMA.md   # Directory structure, page types, naming, cross-referencing rules