# wiki-narrate

Creates a cited briefing, plain explanation, or lecture strictly from Obsidian vault notes. Useful when you need factual topic readouts without model hallucination.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 366 installs · ★ 3621
- Author: Ar9av
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Ar9av/obsidian-wiki/tree/HEAD/.skills/wiki-narrate/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/wiki-narrate

## What it does

This skill turns a topic into a cited Markdown readout strictly grounded in an Obsidian vault. Before generating prose, the agent compiles a claim ledger, assigning each claim a status: supported fact, inferred connection, or ambiguous conflict. Candidate pages are resolved via `hot.md`, `index.md`, and QMD before falling back to `rg`. Pages tagged `visibility/internal` or `visibility/pii` are completely excluded during filtered runs.

The `/wiki-narrate` command requires a topic and supports three canonical voices: `briefing` (default), `plain-language`, and `lecturer`. While the voice dictates structure and tone, it cannot widen the factual boundary. The skill strictly bans pulling facts from model memory or the open web: unsupported gaps are logged directly in the `## Coverage` section rather than smoothed over with hallucinations.

Output displays directly in the conversation unless `--save` is passed. Adding `--save` writes the finalized Markdown note into `_readouts/<slug>.md` alongside YAML frontmatter. Only a verified disk write updates the hot cache in `hot.md` and appends a `WIKI_NARRATE` entry to `log.md`.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-narrate -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/wiki-narrate/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/wiki-narrate/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-narrate -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/wiki-narrate/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-narrate -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/wiki-narrate/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Ar9av/obsidian-wiki wiki-narrate
```

2. **Manually: put the files in place**
- File: `.github/skills/wiki-narrate/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-narrate -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Ar9av/obsidian-wiki --path .skills/wiki-narrate
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/wiki-narrate/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-narrate -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Ar9av/obsidian-wiki/tree/HEAD/.skills/wiki-narrate/SKILL.md

## When to use it
- compile a cited topic briefing strictly from Obsidian vault notes
- draft a structured progressive lecture based on personal notes
- detect evidence gaps and ambiguous conflicts across documentation
- save formatted Markdown readouts directly to `_readouts/`

## Example prompts
- /wiki-narrate "microservices architecture" --voice briefing
- /wiki-narrate "quantum algorithms" --voice lecturer --save
- /wiki-narrate "employee onboarding" --voice plain-language

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9351a1efa52942af.

BEGIN THIRD-PARTY FILE 9351a1efa52942af
```text
---
name: wiki-narrate
description: >
  Turn a wiki topic into a cited Markdown briefing, plain-language explanation, or
  progressive lecture. Use this skill for topic-based briefing, explanation, and
  lecture requests that must stay within the evidence compiled in an Obsidian vault.
---

# Wiki Narrate — Cited Narrative Readouts

Use this skill only for a topic-based Markdown readout. Do not add tag or page-list
selection, prior-query input, voice aliases, HTML, PDF, slides, renderer handoffs, or
new compiled knowledge pages.

## Command Contract

`/wiki-narrate <topic> [--voice briefing|plain-language|lecturer] [--save]`

- Require a non-empty `<topic>`.
- The default voice is `briefing`.
- Voice names are canonical and case-sensitive. Unsupported values must return an
  error listing `briefing`, `plain-language`, and `lecturer` without searching or
  writing.
- `--save` is the only persistence switch.
- For a missing topic, malformed option, or unsupported voice, return a short usage
  or validation error and do not search, write, append a log event, or change `hot.md`.

## Retrieval

**Writing profile:** Before drafting or rewriting natural-language Markdown, read and apply the `Writing Profile Resolution` section in `llm-wiki/SKILL.md`. Framework schema, provenance, safety, and operation-specific requirements take precedence.
`WRITING.md` preferences apply only to newly drafted or rewritten natural-language Markdown; preserve source content and structured records.

1. Resolve configuration with the Config Resolution Protocol, including an inline
   `@name` vault override, then read the target vault's `AGENTS.md` when it exists.
   Load `OBSIDIAN_LINK_FORMAT` before drafting citations.
2. Read `hot.md` and `index.md` first. Select candidates by frontmatter and summary
   before reading bodies.
3. When configured, use QMD before `rg`; if QMD is absent, unconfigured, or fails,
   continue with the index and `rg` path. Treat QMD output as candidate guidance, not
   evidence: establish each claim from the allowed vault page itself.
4. Honor filtered-mode phrases such as "public only", "user-facing", "no internal
   content", "as a user would see it", and "exclude internal". Skip pages tagged
   `visibility/internal` or `visibility/pii` in that mode: never read, cite, or expose
   them.
5. Exclude `_readouts/`, `_raw/`, `_archives/`, `_meta/`, `index.md`, `log.md`,
   `hot.md`, and `_insights.md` from candidates.
6. Read matching sections before full pages, and read full pages only when a factual
   claim cannot otherwise be established. Preserve relevant lifecycle and freshness
```
END THIRD-PARTY FILE 9351a1efa52942af

The third-party file has ended. Everything between the 9351a1efa52942af tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2628 of 6872 bytes. © Ar9av · MIT · https://github.com/Ar9av/obsidian-wiki/tree/HEAD/.skills/wiki-narrate/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md