wiki-narrate

Generates cited Markdown briefings and lectures from Obsidian vault evidence.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning scattered notes in an Obsidian vault into a coherent, trustworthy narrative is slow and error-prone. This Skill compiles vault evidence on a topic into a structured Markdown readout where every factual sentence carries an adjacent citation, so nothing relies on model memory or outside knowledge. ## Core Features & Use Cases - Three voice modes: Produce an executive briefing, a plain-language explanation, or a progressive lecture, each with a fixed section skeleton defined in references/voices.md. - Claim ledger and citation audit: Drafts a ledger of claims marked as supported, inferred, or ambiguous before writing prose, and renders citations as wikilinks or Markdown links per the vault's OBSIDIAN_LINK_FORMAT. - Filtered retrieval and safe failure: Honors visibility filters like "public only", excludes internal/PII-tagged pages, falls back from QMD to ripgrep search, and never invents content to fill evidence gaps. - Optional persistence and logging: With --save, writes the readout to _readouts/ with frontmatter, appends a WIKI_NARRATE event to log.md, and refreshes hot.md only after a successful save. - Use Case: Ask for a briefing on a project topic and receive a Markdown document where each claim links back to the exact vault pages that support it, with a Coverage footer listing sources and known gaps. ## Quick Start Ask the assistant to run /wiki-narrate on a topic from your Obsidian vault, optionally choosing a voice such as briefing, plain-language, or lecturer and adding --save to persist the readout.

Frequently Asked Questions about wiki-narrate

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

FAQPage Schema
How do I generate a cited briefing from my Obsidian vault?

Run /wiki-narrate with a topic, for example /wiki-narrate "project alpha". The skill searches the vault's index and pages, drafts a claim ledger, and returns a Markdown briefing where every factual sentence has adjacent citations to vault pages.

What output formats does wiki-narrate support?

It produces Markdown only, in one of three voices: briefing, plain-language, or lecturer. Each voice has a fixed section skeleton defined in references/voices.md, and it does not produce HTML, PDF, or slides.

Can I exclude internal or private notes from the readout?

Yes. Phrases like "public only", "user-facing", or "exclude internal" activate filtered mode, which skips pages tagged visibility/internal or visibility/pii entirely. Those pages are never read, cited, or exposed in the output.

What happens when the vault has no evidence for my topic?

The skill reports that the vault lacks material for the topic and creates no readout file, even if --save was requested. It records a no_match event in log.md when writable and never fills gaps with outside knowledge.

How do I save a wiki-narrate readout to my vault?

Add the --save flag to the command. After a successful result, the skill writes the readout to _readouts/<slug>.md with title, topic, voice, sources, and date frontmatter, then logs the event and refreshes hot.md.