mcpField
W
wiki-builder

wiki-builder

github.com/rohitg00Productivity2.9k140 installsUpdated 4w ago
Repository

About wiki-builder

wiki-builder creates persistent topic wikis using Markdown files and a SQLite FTS5 index. It is for users and agents organizing research, project, codebase, and other reference material, with configurable wiki types and tracked sources.

Key features

  1. 01Create and register wikis
  2. 02Markdown pages with SQLite FTS5 indexing
  3. 03Multiple wiki flavors
  4. 04Global or project scope
  5. 05Source citations and maintenance logs

Use cases

  1. 01Build a research wiki around a topic
  2. 02Organize notes and source documents
  3. 03Maintain a project or codebase reference wiki

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rohitg00/pro-workflow --skill wiki-builder

After installing, type/wiki-builderin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
wiki-flavors.md
scripts/
init_wiki.sh
wiki-cli.js
templates/
index.md
maintenance-log.md
sources.md
wiki.config.md
templates/prompts/
compile-concept-page.md
compile-index.md
compile-source-page.md
lint-wiki.md
query-and-file.md

Details

From the project README

Wiki Builder

Persistent knowledge base for any topic. Markdown on disk + SQLite FTS5 shadow index.

When to use

  • "Start a wiki on "
  • "Add this paper / link / note to the wiki"
  • "Compile a concept page on X in "
  • "What does the wiki say about Y?" (delegates to wiki-query)
  • "List my wikis"

Locations

  • Global: ~/.pro-workflow/wikis/<slug>/ — default, never committed
  • Project: <project>/.claude/wikis/<slug>/ — pass --scope project, committable

Both register in the same ~/.pro-workflow/data.db.

Flavors

FlavorUse for
researchongoing topic exploration
paperone-paper deep dive
domainbroad subject area
productproduct/tool KB
personresearcher/founder dossier
organizationcompany/lab profile
projectinternal project KB
codebasesymbol/file-aware KB tied to a repo
incidentpost-mortem KB

Layout

<slug>/
├── wiki.config.md         # purpose, audience, page types, style, auto_research block
├── raw/                   # untouched source material (PDFs, scrapes, transcripts)
├── wiki/
│   └── index.md           # entry point, hand-curated TOC
├── derived/               # generated artifacts (surveys, charts, summaries)
├── prompts/               # per-task prompts (compile-page, lint, query)
├── logs/maintenance-log.md
└── sources.md             # one row per source: id | url | title | hash | fetched_at

Flavor adds folders: wiki/papers, wiki/concepts, wiki/people, wiki/products, wiki/timelines, wiki/questions.

CLI surface

node $SKILL_ROOT/scripts/wiki-cli.js init <slug> --title "X" --flavor research [--scope project] [--root <path>]
node $SKILL_ROOT/scripts/wiki-cli.js list
node $SKILL_ROOT/scripts/wiki-cli.js page <slug> <rel-path> --title "X" [--type concept|paper|person|...] [--from-file path]
node $SKILL_ROOT/scripts/wiki-cli.js reindex <slug>
node $SKILL_ROOT/scripts/wiki-cli.js info <slug>

init runs init_wiki.sh (mirrors dair layout) AND registers the wiki in SQLite. page writes markdown + upserts FTS row.

Workflow when invoked

  1. Resolve action (init / ingest / compile / list / reindex / info).
  2. Read wiki.config.md of the target wiki before any compile.
  3. Every claim that lands in wiki/ must cite a row in sources.md (one citation = one source row).
  4. After page write, call wiki-cli.js page so FTS index stays in sync.
  5. Append a one-line entry to logs/maintenance-log.md per change.
  6. Update wiki/index.md if new top-level page.

Quality bar

  • First page useful immediately, not stub.
  • Stable slug filenames (tool-use-benchmarks.md, not 2026-05-08-notes.md).
  • Separate raw source from compiled interpretation.
  • Cross-link related pages in same wiki via relative links.
  • Mark speculation with > SPECULATION: block.
  • No duplicate summaries — link existing page instead.
  • Generated pages stay navigable for future agents.

Privacy

Wikis with private: true in config never get fetched from web sources by wiki-research-loop. Local raw/ only.

Auto-research opt-in

Phase 3.3.0 ships builder + query only. Loop arrives in 3.3.1. To prep, wiki.config.md may include:

auto_research:
  enabled: false        # flip in 3.3.1
  max_pages_per_run: 5
  max_depth: 3
  budget_usd: 0.50
  fetchers: [web, arxiv, github]

Templates

See templates/ for wiki.config.md, index.md, prompt files. init_wiki.sh copies these into the new wiki root.

Comments

Markdown supported