wiki-setup

Initializes an Obsidian wiki vault with directory structure, configuration files, and environment settings.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-setup-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-setup
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/wiki-setup
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-setup-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new Obsidian wiki vault from scratch involves many manual steps: creating the right folder structure, writing index and log files, configuring environment variables, and wiring up optional integrations like semantic search and git sync. This Skill automates the entire initialization and can also repair a broken or partially configured vault. ## Core Features & Use Cases - Guided .env Configuration: Prompts for vault path, source directories, Claude history location, QMD semantic search collections, token budget thresholds, and staged-write mode. - Vault Scaffolding: Creates the full directory tree (concepts, entities, skills, references, synthesis, journal, projects, _raw, _staging) plus index.md, log.md, hot.md, .manifest.json, and minimal .obsidian config files. - Optional Integrations: Installs a Claude Code Stop hook for automatic session capture, configures GitHub sync for vault backup, and refreshes QMD indexes with correct _raw/ exclusions. - Use Case: A user says "set up my wiki" and the Skill walks them through every decision, creates the vault, verifies the setup with a checklist, and leaves them ready to run wiki-ingest on their first sources. ## Quick Start Ask the assistant to set up a new Obsidian wiki vault and answer the prompts for vault location and source directories.

Frequently Asked Questions about wiki-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a new Obsidian wiki vault?

Run the wiki-setup skill, which prompts for your vault path, source directories, and optional integrations, then creates the full directory structure, index.md, log.md, hot.md, .manifest.json, and .obsidian configuration files automatically.

How do I configure QMD semantic search for an Obsidian vault?

Set QMD_WIKI_COLLECTION in your .env and ensure the collection's index.yml ignore list excludes _raw/** so staging drafts stay out of the wiki index. The setup skill verifies this and runs qmd update after editing.

Can I sync my Obsidian vault to GitHub?

Yes, the setup optionally runs obsidian-wiki sync-setup with your repo URL, which handles git init, a default .gitignore, and the origin remote. Afterward, obsidian-wiki sync commits and pushes pending vault changes.

What is the _staging directory used for in the wiki vault?

The _staging directory holds LLM-written pages for review when WIKI_STAGED_WRITES=true. Pages stay invisible to Obsidian's graph until promoted via /wiki-stage-commit, which suits team wikis or high-stakes domains.

Why does my QMD wiki collection index _raw drafts?

A plain qmd collection add on the vault path has no ignore rules, so _raw/ staging content gets indexed. Add an ignore block with _raw/** to index.yml manually and run qmd update, since qmd has no --ignore flag.