Skip to content
SkillModel-led2,265 tokens in use

wiki-synthesize

Find concept pairs that co-occur across an Obsidian wiki without a synthesis page, rank them and write cross-cutting synthesis pages with back-links.

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

Install command as written in the repository's README

Skill label

measured from its files

What installing wiki-synthesize costs

39tokens idle
2,265tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. 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

shelldetected

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
  • Structure25/25
  • Examples12/15
  • Output15/15
  • Size13/15
  • Resources10/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 37

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

This skill scans an Obsidian wiki for concepts that appear together on many pages but have no page connecting them. It builds a co-occurrence map from wikilinks, drops pairs that a synthesis page already covers, and scores the rest by co-occurrence count, cross-domain spread, shared tags, hub status and contradictions they would resolve.

For the top five candidates the agent drafts a page titled A x B with sections for the connection, where the concepts co-occur, the cross-cutting insight, tensions, the strongest objection and open questions. It adds back-links on the source pages and lists the next ten candidates it skipped.

What You Get

  • A ranked candidate list from a scoring table covering co-occurrence, cross-domain pairs, shared tags, hub status and contradictions
  • Up to five synthesis pages in synthesis/ with frontmatter, provenance fractions, a draft lifecycle and a summary
  • Each page’s sections: the connection, co-occurrence, cross-cutting insight, tensions, strongest objection with a testable search query, open questions and related links
  • Back-links added to the Related section of every source concept page
  • A list of the next ten candidates, and open questions recorded as todo threads

Common Use Cases

  • Turning a grown vault’s recurring concept pairs into synthesis pages
  • Synthesizing everything about one topic such as observability
  • Starting from candidates flagged in _insights.md
  • Surfacing cross-domain connections a single concept page does not show

What Makes It Unique

Every synthesis page must name its strongest objection with a testable search query and never an invented citation. The skill also takes the minimum base confidence of its input pages, marks most conclusions as inferred, and tells the agent to skip pairs that only appear together by chance.

Under The Hood

The agent loads the SKILL.md and the shared llm-wiki skill for config and the writing profile. It reads index.md, hot.md, the taxonomy and the vault pages, uses ripgrep over the vault to find backlinks, writes new markdown pages in synthesis/ and edits Related sections of existing pages. It runs obsidian-wiki memory sync and todo add to update the index, log and hot cache under a lock. If a QMD collection is configured it runs the qmd update and embed commands. It does not fetch web pages or call remote services.

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