Second Brain Merge Agent Skill

Merge duplicate pages

A merge is irreversible in the way that matters: afterwards you cannot tell

which claim came from which page. Two ideas that look identical from their

summaries are often a general case and a specific one.

Core rule

Never merge unprompted. Propose, wait for approval, then follow the procedure

exactly.

Workflow

• Pick the survivor by canonical name, not by which page is longer.
• Merge content. Every distinct claim survives with its source. Overlapping

claims collapse; differing ones both stay, following the contradiction rules.

• Merge aliases, including the dead page's title as an alias on the

survivor. This is what keeps old links and the user's memory working.

• Redirect inbound links to the survivor. Check every backlink.
• Delete the old page, or leave a stub only if it was linked from outside

the vault.

• Record in log.md: both names, the date, and why.

Output format

Merged: [[old]] -> [[survivor]]
Claims kept from old page: <n>
Aliases added: <list>
Inbound links redirected: <n>
Conflicts recorded: <none | description>

Calibration

If the two pages disagree about anything factual, that is a signal they may not

be duplicates. Surface the disagreement and ask before proceeding.

Never merge a page marked maintained_by: human into another without explicit

confirmation naming that page.