
Wiki Synthesize
Discover co-occurring wiki concepts that lack a synthesis page and add cross-cutting synthesis/ pages to an Obsidian knowledge base after growth or ingest.
Overview
Wiki-synthesize is an agent skill most often used in Build (also Idea discover, Grow content) that discovers co-occurring wiki concepts without synthesis pages and creates cross-cutting synthesis/ pages in your Obsidian
Install
npx skills add https://github.com/ar9av/obsidian-wiki --skill wiki-synthesizeWhat is this skill?
- Builds a co-occurrence map across all wiki pages using wikilinks, tags, and headings, then ranks candidate concept pairs
- Applies tiered thresholds (8+, 5–7, 3–4 co-occurrences) plus hub candidates (10+ links, no synthesis page) for prioritiz
- Writes synthesis/ pages with cross-cutting conclusions, reverse links, index.md updates, and optional meta/synthesis-map
- Updates hot.md with a synthesis batch entry when new pages are created
- Respects OBSIDIAN_LINK_FORMAT from the llm-wiki config resolution protocol before linking
- Co-occurrence tiers: 8+ (high), 5–7 (medium), 3–4 (low) for candidate pairs
- Hub rule: pages with 10+ incoming wikilinks and no synthesis/ page qualify as hub candidates
- Workflow steps: co-occurrence map, rank opportunities, create synthesis pages, update index and optional meta/synthesis-
Adoption & trust: 1.6k installs on skills.sh; 1.8k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your wiki keeps mentioning the same concept pairs on many pages, but you have no synthesis pages that state what those overlaps actually imply together.
Who is it for?
Solo builders with an Obsidian wiki layout (index.md, tags, many interlinked pages) who want systematic connection discovery after ingest or steady vault growth.
Skip if: Flat note dumps without index.md, wikilinks, or taxonomy discipline, or vaults where you only want one-off summaries instead of durable synthesis artifacts.
When should I use this skill?
User says synthesize my wiki, find connections, what concepts keep coming up together, /wiki-synthesize, or after a large ingest when the vault has grown significantly.
What do I get? / Deliverables
You get prioritized synthesis opportunities filled with linked synthesis/ pages, updated index navigation, and optional meta/synthesis-map.md so recurring themes become explicit conclusions instead of scattered mentions.
- New or updated synthesis/*.md pages with cross-cutting conclusions and bidirectional links
- Updated index.md entries, optional meta/synthesis-map.md, and hot.md batch note when pages are created
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Build → docs because deliverables are structured wiki pages (synthesis/, meta/, index updates), not shipping code. Subphase docs fits maintaining and extending a linked wiki corpus with explicit synthesis artifacts and navigation hubs.
Where it fits
After competitor and audience research ingests, surface recurring theme pairs (e.g. positioning + pricing) that need one synthesis conclusion before you commit
Following a batch of technical docs ingest, rank co-occurring API and auth concepts and add synthesis/ pages so agents and future-you navigate implications with
When marketing and product notes overlap on distribution and lifecycle topics, create hub-style synthesis pages that anchor content strategy threads linked from
Periodically rescan hot.md and the full inventory to close synthesis gaps opened by ongoing incident and monitoring notes that reference the same failure modes.
How it compares
Use instead of manually rereading pages to guess themes—this is a structured co-occurrence workflow, not a generic chat summarizer.
Common Questions / FAQ
Who is wiki-synthesize for?
It is for solo and indie builders who maintain a structured Obsidian wiki and want automated discovery of concept pairs and clusters that deserve dedicated synthesis pages.
When should I use wiki-synthesize?
Use it when you say synthesize my wiki, find connections, run /wiki-synthesize, or right after a large ingest when co-occurring ideas outnumber explicit synthesis coverage—common in Build docs upkeep, Idea discover passes, and Grow content consolidation.
Is wiki-synthesize safe to install?
It reads and writes files inside your configured Obsidian vault; review the Security Audits panel on this skill’s catalog page and confirm vault backups before letting an agent create or edit synthesis pages.
SKILL.md
READMESKILL.md - Wiki Synthesize
# Wiki Synthesize — First-Class Synthesis Discovery You are scanning the wiki for concepts that co-occur across many pages but have no dedicated synthesis page connecting them. Your job is to surface these gaps and fill the most valuable ones with cross-cutting synthesis pages. ## Before You Start 1. **Resolve config** — follow the Config Resolution Protocol in `llm-wiki/SKILL.md` (walk up CWD for `.env` → `~/.obsidian-wiki/config` → prompt setup). This gives `OBSIDIAN_VAULT_PATH` and `OBSIDIAN_LINK_FORMAT` (default: `wikilink`). 2. Read `index.md` to get the full page inventory. 3. Read `hot.md` if it exists — it surfaces recent activity and active threads that may already point to synthesis opportunities. 4. Read `_meta/taxonomy.md` to understand the tag vocabulary. When writing internal links in synthesis pages, apply the link format from `llm-wiki/SKILL.md` (Link Format section) using the `OBSIDIAN_LINK_FORMAT` value. ## Step 1: Build the Co-occurrence Map Scan every non-special page in the vault (skip `index.md`, `log.md`, `hot.md`, `_insights.md`, `_meta/*`, `_archives/*`, `_raw/*`). For each page, collect: - All `[[wikilinks]]` it contains (outgoing links) - Its `tags` frontmatter - Its `category` frontmatter Build a co-occurrence matrix: for every pair of concept/entity pages (A, B), count how many other pages link to **both** A and B. This is their co-occurrence score. You don't need to be exhaustive — aim for the top 20-30 pairs by co-occurrence score. Use Grep to find backlinks efficiently: ```bash grep -rl "\[\[ConceptA\]\]" "$OBSIDIAN_VAULT_PATH" --include="*.md" ``` Run this for your top candidate concepts and intersect the result sets. ## Step 2: Filter Out Already-Synthesized Pairs Check the `synthesis/` directory for existing pages. For each existing synthesis page: - Read its `sources` frontmatter or its body for `[[wikilinks]]` - Mark those concept pairs as already covered Remove covered pairs from your candidate list. ## Step 3: Score and Rank Candidates For each remaining candidate pair (or cluster of 3+), assign a synthesis value score: | Signal | Points | |---|---| | Co-occurrence count ≥ 5 | +3 | | Co-occurrence count 3-4 | +2 | | Co-occurrence count 1-2 | +1 | | Concepts are in different categories (cross-domain) | +2 | | Concepts share tags but live in different folders | +1 | | One or both concepts are tagged as hubs in `_insights.md` | +1 | | A synthesis would resolve a flagged contradiction | +2 | Pick the top 5 candidates. If the user asked for a specific topic ("synthesize everything about observability"), filter candidates to that domain first. ## Step 4: Draft Synthesis Pages For each top candidate, create a page in `synthesis/` using this template: ```markdown --- title: <Concept A> × <Concept B> category: synthesis tags: [<shared tags>, <domain tags>] sources: [<all pages that link to both>] created: TIMESTAMP updated: TIMESTAMP summary: "Cross-cutting synthesis of how <A> and <B> interact, with implications for <domain>." provenance: extracted: 0.2 inferred: 0.7 ambiguous: 0.1 base_confidence: <min(base_confidence of all input pages)> lifecycle: draft lifecycle_changed: TIMESTAMP_DATE --- # <Concept A> × <Concept B> ## The Connection *What makes these two concepts worth synthesizing together — the non-obvious relationship that pages about each individually don't capture.* ## Where They Co-occur *The pages and contexts where both appear. What situations bring the