Skip to content
SkillModel-led1,994 tokens in use

wiki-narrate

Turns a wiki topic into a cited Markdown briefing, a beginner-friendly explanation or a lecture, using only claims the vault's own pages support.

3,792 stars on the repository MIT LicenseAr9av/obsidian-wiki · skills/wiki-narrate
pip install obsidian-wiki
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing wiki-narrate costs

49tokens idle
1,994tokens in use
2,150tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure19/25
  • Examples12/15
  • Output15/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 122
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 122

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community60
  • Maturity28
  • Momentum40

wiki-narrate writes a readout on one topic from an Obsidian vault. You pick a voice (briefing, plain-language or lecturer), and the skill builds a ledger of claims with supporting page links before it writes any prose.

Every factual sentence carries an adjacent citation, inferred connections and conflicts are marked, and a Coverage footer lists cited pages and gaps. Output is shown in chat and saved to a readouts folder only when you pass the save flag.

What You Get

  • A readout titled with the topic and voice, in that voice’s fixed section order
  • Adjacent citations on each factual sentence, as wikilinks or Markdown links
  • Inference and ambiguity markers where evidence is indirect or conflicting
  • A Coverage footer with cited pages, count of inferred statements and gaps
  • An optional saved file under the readouts folder

Common Use Cases

  • Getting a one-page briefing on a topic before a meeting
  • Explaining a technical subject to a newcomer using only your own notes
  • Producing a progressive lecture outline from a cluster of related pages

What Makes It Unique

It keeps a claim ledger and audits citations before writing, so it never closes a gap with outside knowledge. An approved-facts gate checks statements about the owner or their company against a facts file and drops retired claims, and an owner voice file can shape prose without adding claims. Saved readouts are derived output, excluded from later retrieval and kept out of the index and manifest.

Under The Hood

The skill is instructions plus one reference file of voice outlines. It reads vault pages and, when a QMD collection is configured, uses it to find candidates. It runs the obsidian-wiki command line tool to check facts, show and check the owner voice, log the run and refresh the hot cache. The only file write besides the log is the saved readout. It does not fetch web pages or call remote APIs.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers