beeweave: Skill for Claude Code

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 beeweave-core/SKILL.md (inline @name override → walk up CWD for .env → ~/.beeweave/config → prompt setup). This gives BEEWEAVE_VAULT_PATH and BEEWEAVE_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 beeweave-core/SKILL.md (Link Format section) using the BEEWEAVE_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/*, _staging/*, _archives/*, legacy _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:

grep -rl "\[\[ConceptA\]\]" "$BEEWEAVE_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.