wiki-synthesize

Discovers co-occurring concepts in an Obsidian wiki and creates cross-cutting synthesis pages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? As an Obsidian wiki grows, related concepts accumulate across many pages without any page connecting them, leaving cross-cutting insights invisible. This Skill scans the vault for concept pairs that co-occur frequently but lack a synthesis page, then drafts pages that draw explicit conclusions neither source page states alone. ## Core Features & Use Cases - Co-occurrence Mapping: Builds a matrix of wikilink co-occurrence across all non-special pages using ripgrep backlink searches, ranking the top 20-30 concept pairs. - Scored Candidate Ranking: Filters out already-synthesized pairs and scores candidates by co-occurrence count, cross-domain status, hub tags, and contradiction resolution. - Structured Synthesis Pages: Creates pages in synthesis/ using a template with provenance frontmatter, cross-cutting insight, tensions, strongest objection with a testable query, and open questions. - Vault Maintenance: Back-links synthesis pages from source concept pages and updates index.md, log.md, and hot.md, with an optional QMD search index refresh. - Use Case: After ingesting a large batch of notes, run the skill to discover that Caching and Consistency co-occur in five pages, then generate a Caching × Consistency synthesis page capturing the trade-offs neither page covers. ## Quick Start Ask the assistant to synthesize your wiki and find which concepts keep appearing together without a connecting page.

Frequently Asked Questions about wiki-synthesize

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

FAQPage Schema
How do I find connections between notes in my Obsidian vault?

Run the wiki-synthesize skill to scan all non-special pages and build a co-occurrence matrix of wikilinks. It ranks concept pairs that appear together frequently but have no synthesis page, then drafts connecting pages for the top candidates.

How does the skill decide which concept pairs to synthesize?

It scores pairs by co-occurrence count, cross-domain status, shared tags across folders, hub flags in _insights.md, and whether a synthesis would resolve a flagged contradiction. The top five scoring candidates get synthesis pages.

What does a synthesis page in Obsidian contain?

Each page uses a template with provenance frontmatter, sections for the connection, co-occurrence contexts, cross-cutting insight, tensions, a strongest objection with a testable query, and open questions. Titles follow the 'Concept A × Concept B' format.

Does wiki-synthesize avoid duplicating existing synthesis pages?

Yes. It reads the synthesis/ directory first, extracts the source concepts from existing pages, and removes those pairs from the candidate list before scoring. Only uncovered pairs proceed to ranking.

What are the limitations of automated wiki synthesis?

Synthesis pages are mostly inferred content, so conclusions depend on the quality of source pages. The skill skips pairs that merely co-occur without a genuine conceptual link, and three-way syntheses are only created for true triangles of mutual influence.