wiki-narrate

Generates cited Markdown briefings and lectures from Obsidian vault evidence.

3.3k|328|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Ar9av/obsidian-wiki --skill wiki-narrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-narrate
Source: https://github.com/Ar9av/obsidian-wiki/tree/main/.skills/wiki-narrate
Command: npx skills add https://github.com/Ar9av/obsidian-wiki --skill wiki-narrate

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 explanation usually means re-reading dozens of pages and manually tracking which claim came from where. This Skill compiles a topic-based readout where every factual sentence carries an adjacent citation to the vault page that supports it.

Core Features & Use Cases

  • Three voice modes: Produce an executive briefing, a plain-language explanation, or a progressive lecture, each with a fixed section structure defined in references/voices.md.
  • Claim ledger and citation audit: Drafts a ledger of claims marked as supported fact, inferred connection, or ambiguous conflict before writing prose, and never fills gaps with outside knowledge.
  • Filtered retrieval and safe persistence: Honors visibility filters like "public only", excludes internal pages, optionally saves readouts to _readouts/, and logs every attempt to log.md.
  • Use Case: Ask for a briefing on "authentication redesign" and receive a Markdown document where each statement links to the exact vault notes it came from, with a Coverage footer listing sources and evidence gaps.

Quick Start

Ask your agent to run /wiki-narrate on a topic from your vault, for example: narrate the topic "deployment pipeline" as a briefing and save it.

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 "deployment pipeline". The skill reads hot.md and index.md, selects candidate pages, and returns a Markdown briefing where every factual sentence has an adjacent citation to the supporting vault page.

What output formats does wiki-narrate support?

It supports three voices: briefing for fast decisions, plain-language for unfamiliar readers, and lecturer for progressive teaching. Each voice has a fixed section order defined in references/voices.md, and output is always Markdown.

Can wiki-narrate exclude internal or private notes?

Yes. Filtered-mode phrases like "public only" or "exclude internal" cause the skill to skip pages tagged visibility/internal or visibility/pii. Those pages are never read, cited, or exposed in the readout.

Does wiki-narrate use outside knowledge to fill gaps?

No. It never uses web knowledge or model memory to close evidence gaps. Unsupported claims are omitted, conflicts are marked ^[ambiguous], and remaining gaps are listed in the Coverage footer.

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

Add the --save flag to the command. The skill writes the completed readout to _readouts/<slug>.md with frontmatter, appends a WIKI_NARRATE event to log.md, and refreshes hot.md only after a successful save.