wiki-synthesize

Detect co-occurring wiki concepts and create cross-cutting synthesis pages connecting them.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-synthesize-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wiki-synthesize
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/wiki-synthesize
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-synthesize-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? As a personal wiki grows, related concepts accumulate across many pages without any page explaining how they connect, 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 capture the relationship neither source page states alone. ## Core Features & Use Cases - Co-occurrence Mapping: Builds a matrix of wikilink co-occurrence scores across all non-special pages using grep-based backlink searches. - Gap Filtering and Scoring: Excludes pairs already covered by existing synthesis pages and ranks candidates by co-occurrence count, cross-domain status, and contradiction resolution. - Structured Synthesis Pages: Creates pages in synthesis/ with a fixed template covering the connection, co-occurrence contexts, cross-cutting insight, tensions, and open questions, then back-links from source pages and updates index.md, log.md, and hot.md. - Use Case: After ingesting a large batch of notes into an Obsidian vault, run the Skill to discover that "Caching" and "Consistency" appear together on six pages with no connecting page, and generate a Caching × Consistency synthesis capturing the trade-offs. ## Quick Start Ask the assistant to synthesize your wiki and find concepts that 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, which scans every non-special page for outgoing wikilinks and builds a co-occurrence matrix counting how many pages link to each concept pair. It then ranks the top pairs and drafts synthesis pages connecting them.

How does the skill decide which concept pairs are worth synthesizing?▼

It scores each candidate pair using a point system: co-occurrence count (1-3 points), cross-domain category membership (+2), shared tags across folders (+1), hub status in _insights.md (+1), and whether a synthesis would resolve a flagged contradiction (+2). The top 5 candidates get pages.

Does it create duplicate synthesis pages for pairs already covered?▼

No. Before scoring, it reads every existing page in the synthesis/ directory, extracts the wikilinks from their sources frontmatter and bodies, and removes those concept pairs from the candidate list.

What files does wiki-synthesize modify in the vault?▼

It creates new pages in synthesis/, adds back-links in the Related sections of source concept pages, appends entries to index.md and log.md, and updates Recent Activity and Active Threads in hot.md. It can also trigger a qmd index refresh if QMD_WIKI_COLLECTION is set.

When should I not run wiki synthesis on my vault?▼

Skip it when concept pairs merely co-occur without a genuine conceptual link, since the skill explicitly avoids synthesis for its own sake. It is most valuable after significant vault growth, not on small or freshly organized collections.