A skill-based framework for building and maintaining an Obsidian knowledge base. No scripts or dependencies — everything is markdown instructions that you execute directly.
Resolve config using the Config Resolution Protocol in llm-wiki/SKILL.md:
- Walk up from CWD — look for a
.envfile in the current directory, then each parent, up to$HOME. Stop at the first.envthat containsOBSIDIAN_VAULT_PATH. - Global config — if no local
.envis found, read~/.obsidian-wiki/config. - Prompt setup — if neither exists, tell the user to run
wiki-setup.
The resolved config sets OBSIDIAN_VAULT_PATH (where the wiki lives). It may also set OBSIDIAN_WIKI_REPO (where this repo is cloned) and other optional variables.
After reading config, always read $OBSIDIAN_VAULT_PATH/AGENTS.md if it exists. It contains owner-specific conventions (domain vocabulary, ingest preferences, writing style, project scoping) that override framework defaults for all skills. Apply it for the duration of the session.
$OBSIDIAN_VAULT_PATH/
├── index.md # Master index — every page listed, always kept current
├── log.md # Chronological activity log (ingests, updates, lints)
├── hot.md # Session hot cache — ~500-word semantic snapshot of recent activity
├── .manifest.json # Tracks every ingested source: path, timestamps, pages produced
├── _meta/
│ ├── taxonomy.md # Controlled tag vocabulary
│ └── *.base # Obsidian Bases dashboard definitions (wiki-dashboard skill)
├── _insights.md # Graph analysis output (hubs, bridges, dead ends)
├── _raw/ # Staging area — drop rough notes here, next ingest promotes them
├── concepts/ # Abstract ideas, patterns, mental models
├── entities/ # Concrete things — people, tools, libraries, companies
├── skills/ # How-to knowledge, techniques, procedures
├── references/ # Factual lookups — specs, APIs, configs
├── synthesis/ # Cross-cutting analysis connecting multiple concepts
├── journal/ # Time-bound entries — daily logs, session notes
└── projects/
└── <project-name>.md # One page per project synced via wiki-update
Every wiki page has required frontmatter: title, category, tags, sources, created, updated. Pages connect via internal links — [[wikilinks]] by default, or standard Markdown links when OBSIDIAN_LINK_FORMAT=markdown is set in config.
Skills live in .skills/<name>/SKILL.md. Match the user's intent to the right skill:
| User says something like… | Skill |
|---|---|
| "set up my wiki" / "initialize" | wiki-setup |
| "/wiki-history-ingest claude" / "/wiki-history-ingest codex" / "/wiki-history-ingest hermes" / "/wiki-history-ingest pi" | wiki-history-ingest |
| "/ingest-url " / "add this URL" / "ingest this link" / "save this page" | ingest-url |
| "ingest" / "add this to the wiki" / "process these docs" | wiki-ingest |
| "import my Claude history" / "mine my conversations" | claude-history-ingest |
| "import my Codex history" / "mine my Codex sessions" | codex-history-ingest |
| "import my Hermes history" / "mine my Hermes memories" / "ingest ~/.hermes" | hermes-history-ingest |
| "import my OpenClaw history" / "mine my OpenClaw sessions" / "ingest ~/.openclaw" | openclaw-history-ingest |
| "import my Copilot history" / "mine my Copilot sessions" / "ingest ~/.copilot" | copilot-history-ingest |
| "import my Pi history" / "mine my Pi sessions" / "ingest ~/.pi" | pi-history-ingest |
| "process this export" / "ingest this data" / logs, transcripts | data-ingest |
| "ingest this obsidian wiki" / "ingest the obsidian-wiki project" | obsidian-wiki-ingest |
| "what's the status" / "what's been ingested" / "show the delta" | wiki-status |
| "wiki insights" / "hubs" / "wiki structure" | wiki-status (insights mode) |
| "what do I know about X" / "find info on Y" / any question | wiki-query |
| "audit" / "lint" / "find broken links" / "wiki health" | wiki-lint |
| "dedup my wiki" / "find duplicate pages" / "merge duplicates" / "identity resolution" / "consolidate my wiki" | wiki-dedup |
| "rebuild" / "start over" / "archive" / "restore" | wiki-rebuild |
| "link my pages" / "cross-reference" / "connect my wiki" | cross-linker |
| "fix my tags" / "normalize tags" / "tag audit" | tag-taxonomy |
| "update wiki" / "sync to wiki" / "save this to my wiki" | wiki-update |
| "export wiki" / "export graph" / "graphml" / "neo4j" | wiki-export |
| "import wiki" / "import from export" / "load graph.json" / "import vault" / "/wiki-import" | wiki-import |
| "color my graph" / "color code obsidian" / "color by tag/category/visibility" | graph-colorize |
| "save this" / "/wiki-capture" / "capture this" / "file this conversation" | wiki-capture |
| "/wiki-quick-chat-capture" / "quick capture" / "capture this finding" / "save this gotcha" / "drop to raw" | wiki-quick-chat-capture |
| "/wiki-research [topic]" / "research X" / "find everything about Y" | wiki-research |
| "create a dashboard" / "vault dashboard" / "show all X as a table" / "dynamic view" | wiki-dashboard |
| "synthesize my wiki" / "find connections" / "what concepts keep coming up together" / "/wiki-synthesize" | wiki-synthesize |
| "create a new skill" | skill-creator |
| "/wiki-claude [topic]" / "/wiki-codex [topic]" / "/wiki-hermes [topic]" / "/wiki-openclaw [topic]" / "/wiki-copilot [topic]" / "/wiki-pi [topic]" | wiki-agent |
| "/memory-bridge" / "browse codex memory" / "what did codex know about X" / "compare tool memories" / "cross-tool memory" | memory-bridge |
| "/daily-update" / "morning sync" / "refresh the wiki index" / "set up the daily cron" / "install terminal notification" | daily-update |
| "/impl-validator" / "check this implementation" / "validate what you did" / "is this correct?" | impl-validator |
| "/wiki-switch NAME" / "switch to my work wiki" / "switch vault" / "change wiki" / "list my wikis" / "show my vaults" / "create a new vault config" | wiki-switch |
| "/wiki-digest" / "what did I learn this week" / "weekly digest" / "knowledge summary" / "what's new in my wiki" / "summarize my recent learning" / "monthly review" | wiki-digest |
The main use case: you're working in some other project and want to sync knowledge into your wiki or query it. Two global skills handle this — wiki-update and wiki-query. They work from any directory.
- Resolve config using the Config Resolution Protocol to get
OBSIDIAN_VAULT_PATH - Scan the current project: README, source structure, git log, package metadata
- Distill what's worth remembering (architecture decisions, patterns, trade-offs — not code listings)
- Write to
$VAULT/projects/<project-name>.md, cross-linking to concept/entity pages as needed - Update
.manifest.json,index.md, andlog.md
On repeat runs, it checks last_commit_synced in .manifest.json and only processes the delta via git log <last_commit>..HEAD.
- Resolve config using the Config Resolution Protocol to get
OBSIDIAN_VAULT_PATH - Scan titles, tags, and
summary:frontmatter fields first (cheap pass) - Only open page bodies when the index pass can't answer
- Return a synthesized answer with
[[wikilink]]citations
Pages can carry a visibility/ tag to mark their intended reach. This is entirely optional — untagged pages behave exactly as they always have (visible everywhere). The system stays single-vault, single source of truth.
| Tag | Meaning |
|---|---|
| (no tag) | Same as visibility/public — visible in all modes |
visibility/public |
Explicitly public — visible in all modes |
visibility/internal |
Team-only — excluded when querying in filtered mode |
visibility/pii |
Sensitive data — excluded when querying in filtered mode |
Filtered mode is opt-in, triggered by phrases like "public only", "user-facing answer", "no internal content", or "as a user would see it" in a query. Default mode shows everything.
visibility/ tags are system tags — they don't count toward the 5-tag limit and are listed separately from domain/type tags in the taxonomy.
See wiki-query and wiki-export skills for how the filter is applied.
- Compile, don't retrieve. The wiki is pre-compiled knowledge. Update existing pages — don't append or duplicate.
- Track everything. Update
.manifest.jsonafter ingesting,index.md,log.md, andhot.mdafter any write operation. - Connect with
[[wikilinks]]. Every page should link to related pages. This is what makes it a knowledge graph, not a folder of files. - Frontmatter is required. Every wiki page needs:
title,category,tags,sources,created,updated. - Single source of truth. Visibility tags shape how content is surfaced — they don't duplicate or separate it.
- Keep context warm.
hot.mdis a ~500-word semantic snapshot of recent activity. Every write skill updates it so the next session can pick up where the last one left off without crawling the full vault.
For the full pattern (three-layer architecture, page templates, project org), read .skills/llm-wiki/SKILL.md.