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.
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.
Use this skill when the user wants to:
pip install llmwikify
Verify installation:
llmwikify --help
llmwikify init --agent opencode
This creates:
raw/ — source documents directorywiki/ — LLM-maintained pageswiki.md — single source of truth for conventions, page types, and workflowsopencode.json — MCP config (optional)Copy files to raw/ or ingest directly:
llmwikify ingest raw/article.md
llmwikify search "your query"
# 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:
wiki/# 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"
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...
# Full health check
llmwikify lint
# Quick suggestions
llmwikify lint --format brief
# Missing pages and orphans
llmwikify lint --format recommendations
# Status overview
llmwikify status
# 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
# 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
llmwikify community-detect --algorithm leiden --resolution 1.0
# 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
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 |
[[wikilink]] syntax for cross-references between wiki pageswiki/; humans own raw/See resources/cli-reference.md for complete documentation of all 19 commands, their arguments, output formats, and examples.
| 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 |