name	llmwikify
description	Use when the user wants to ingest documents, search the wiki, create/edit wiki pages, check wiki health, query knowledge graph, or manage a llmwikify knowledge base. Commands: ingest, search, write_page, read_page, lint, status, batch, graph-query.

llmwikify — CLI Skill

Manage a persistent, interlinked wiki knowledge base through structured CLI commands. The wiki is a git-tracked markdown directory that the LLM incrementally builds from raw sources.

When to Use This Skill

Use this skill when the user wants to:

Set up a new knowledge base from documents (PDFs, URLs, articles)
Search or query an existing wiki
Ingest new source files into a knowledge base
Check wiki health (broken links, orphans, stale claims)
Explore relationships between concepts (knowledge graph)
Track factual claims with supporting/contradicting evidence

Prerequisites

pip install llmwikify

Verify installation:

llmwikify --help

Quick Start

1. Initialize a wiki

llmwikify init --agent opencode

This creates:

raw/ — source documents directory
wiki/ — LLM-maintained pages
wiki.md — single source of truth for conventions, page types, and workflows
opencode.json — MCP config (optional)

2. Ingest sources

Copy files to raw/ or ingest directly:

llmwikify ingest raw/article.md

3. Search the wiki

llmwikify search "your query"

Core Workflows

Ingest a Source

# Basic ingest (extracts text, saves to raw/)
llmwikify ingest raw/article.md

# Smart ingest (requires LLM configured)
llmwikify ingest raw/article.md --self-create

# Preview without creating pages
llmwikify ingest raw/article.md --dry-run

Smart ingest workflow:

Extract text from source
LLM analyzes content, detects entities, concepts, claims
LLM plans wiki page operations
Creates/updates pages in wiki/
Writes graph relations between concepts

Create/Read Pages

# Write a page
llmwikify write_page "Page Name" --content "# Title\n\nContent here"

# Write from file
llmwikify write_page "Page Name" --file content.md

# Read a page
llmwikify read_page "Page Name"

Search

llmwikify search "gold mining" --limit 10

Output format:

Search results for: gold mining

1. Gold Industry
   Score: 0.95
   Ghana is a leading **gold mining** country in Africa...

2. Mining Regulations
   Score: 0.72
   New **mining** permits take 2+ years to process...

Maintain Wiki Health

# Full health check
llmwikify lint

# Quick suggestions
llmwikify lint --format brief

# Missing pages and orphans
llmwikify lint --format recommendations

# Status overview
llmwikify status

Query the Knowledge Graph

# Find neighbors of a concept
llmwikify graph-query neighbors "Ghana"

# Shortest path between concepts
llmwikify graph-query path "Ghana" "Gold Royalty"

# Graph statistics
llmwikify graph-query stats

Export Graph Visualization

# Interactive HTML (pyvis)
llmwikify export-graph --format html --output graph.html

# Static SVG
llmwikify export-graph --format svg

# Gephi-compatible GraphML
llmwikify export-graph --format graphml

Community Detection

llmwikify community-detect --algorithm leiden --resolution 1.0

Batch Ingest

# Ingest all files in a directory
llmwikify batch raw/gold/

# With smart processing
llmwikify batch raw/ --self-create

# Limit to first N files
llmwikify batch raw/ --limit 10

Page Types

The wiki organizes pages into categories:

Type	Location	Purpose
Source	`wiki/sources/`	Summary of an ingested source
Entity	`wiki/entities/`	People, orgs, locations, products
Concept	`wiki/concepts/`	Theories, frameworks, methods
Comparison	`wiki/comparisons/`	Side-by-side analyses
Synthesis	`wiki/synthesis/`	Cross-source analysis
Claim	`wiki/claims/`	Factual claims with evidence
Overview	`wiki/overview.md`	Top-level synthesis

Conventions

Use [[wikilink]] syntax for cross-references between wiki pages
Cite raw sources using standard markdown links, NOT wikilinks
Keep pages focused on one topic
Update existing pages instead of creating duplicates
The LLM owns wiki/; humans own raw/

Full CLI Reference

See resources/cli-reference.md for complete documentation of all 19 commands, their arguments, output formats, and examples.

Error Handling

Error	Cause	Solution
`Wiki not initialized`	No wiki.md found	Run `llmwikify init` first
`LLM not configured`	Smart mode without LLM config	Add `llm.enabled: true` to `.wiki-config.yaml`
`No results found`	Search query returned nothing	Try different keywords, check spelling
`Error: File not found`	Source file doesn't exist	Verify path relative to wiki root

name	llmwikify
description	Use when the user wants to ingest documents, search the wiki, create/edit wiki pages, check wiki health, query knowledge graph, or manage a llmwikify knowledge base. Commands: ingest, search, write_page, read_page, lint, status, batch, graph-query.