custom-obsidian-wiki-write

Writes and updates knowledge pages in an Obsidian vault following LLM Wiki conventions.

1|Updated Apr 3, 2021
One-click install
npx skills add https://github.com/NaoyaMiyagawa/dotfiles --skill custom-obsidian-wiki-write-naoyamiyagawa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: custom-obsidian-wiki-write
Source: https://github.com/NaoyaMiyagawa/dotfiles/tree/main/.ai/skills/custom-obsidian-wiki-write
Command: npx skills add https://github.com/NaoyaMiyagawa/dotfiles --skill custom-obsidian-wiki-write-naoyamiyagawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Capturing durable project knowledge—requirements, decisions, architecture notes—often gets lost in chat history or scattered files. This Skill files that knowledge into a structured Obsidian vault with consistent templates, cross-links, and a searchable index. ## Core Features & Use Cases - Structured ingest workflow: Scopes the project, picks or creates the right wiki page from templates, writes at the requirements/spec level, and cites sources. - Graph and spine maintenance: Keeps index.md, log.md, wikilinks, and cross-references healthy, and flags conflicts with warning callouts instead of overwriting. - Provenance tracking: Stamps code-derived pages with source_repo, source_commit, and source_paths frontmatter so staleness can be detected via git diffs. - Search re-indexing: Runs qmd update and qmd embed after writes so new pages are findable via lexical and semantic search. - Use Case: After finishing an auth feature, ask the assistant to "document this in the wiki"—it updates the auth page, links related concepts, logs the change, and re-indexes the vault. ## Quick Start Ask the assistant to add the requirement or decision you just discussed to the Obsidian wiki for your current project.

Frequently Asked Questions about custom-obsidian-wiki-write

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

FAQPage Schema
How do I add a new page to my Obsidian wiki with this skill?

Name the project or let it be inferred from your current repo, then describe the knowledge to capture. The skill picks or creates a page from the vault templates, writes it with frontmatter and wikilinks, updates index.md and log.md, and re-indexes the vault.

What environment setup does the Obsidian wiki write workflow need?

The OBSIDIAN_VAULT environment variable must point to your vault, since file tools need absolute paths. The vault must also be added as a working directory with /add-dir, and qmd must be installed for re-indexing after writes.

When should I use this skill instead of the llm-wiki or obsidian-markdown skills?

Use it for writing or updating durable knowledge in the personal Obsidian vault. Use llm-wiki for the LLM Wiki desktop app, and obsidian-markdown for pure Markdown syntax questions.

How does the skill detect stale documentation pages?

Code-derived pages carry provenance frontmatter with source_repo, source_commit, and source_paths. Running git log from the recorded commit to HEAD over those paths reveals whether the underlying code changed, marking the page stale.

Why are my new Obsidian wiki pages not showing up in search?

Pages are not searchable until the qmd index is refreshed. The skill runs qmd update -c obsidian for lexical search and qmd embed for semantic search after every write; if embedding fails, only lexical search is updated.