brain-link-campaign

Creates gbrain graph links and wikilinks to reduce orphan pages and improve brain score.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill brain-link-campaign-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brain-link-campaign
Source: https://github.com/tapway/shogun-os/tree/main/skills/gbrain/brain-link-campaign
Command: npx skills add https://github.com/tapway/shogun-os --skill brain-link-campaign-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Knowledge bases built in gbrain accumulate orphan pages and low link coverage after bulk imports, which drags down the brain score and makes content undiscoverable. This Skill provides a phased campaign to systematically reduce orphans and raise link coverage toward target metrics (orphans < 20%, coverage > 30%, score 70+). ## Core Features & Use Cases - Index Hub Pages: Bulk-create hub pages with [[wikilinks]] that give thousands of orphan pages (emails, calendar events, project sub-pages) inbound links in one pass. - Graph Link Automation: Run brain-auto-link.py to convert existing wikilinks into database-level gbrain graph edges, with dry-run support. - Orphan Prevention: Link every new page to its category index at creation time via the brain_compliance_helper, stopping new orphans before they appear. - Use Case: After importing 5,000 email pages with no inbound links, group them by prefix, generate index pages, commit to the brain repo, run gbrain sync and extract, then verify progress with mcp_gbrain_get_health. ## Quick Start Ask the agent to run a brain link campaign that finds orphan pages, creates index hub pages for them, and syncs the brain repo to improve the brain score.

Frequently Asked Questions about brain-link-campaign

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

FAQPage Schema
How do I reduce orphan pages in gbrain?

Create index hub pages containing [[slug]] wikilinks that point to groups of orphan pages, then commit to the brain repo and run gbrain sync and gbrain extract all. One index page can provide inbound links to thousands of orphans such as emails or calendar events.

What is the difference between gbrain graph links and wikilinks?

Graph links are database-level edges created via gbrain link or mcp_gbrain_add_link and affect most_connected and link_count. Wikilinks are [[slug]] syntax in markdown content and affect link_coverage, orphan_pages, and the brain score link_density_score.

How do I prevent new orphan pages from being created?

Link every new page to its category index hub at creation time using the brain_compliance_helper write_brain_page function with a category parameter, or run the helper's link command from the shell. This creates a graph link to the category index automatically.

Why is my brain score not improving after adding graph links?

Graph links alone do not affect the brain score; only wikilinks in file content influence link_coverage and link_density_score. Add [[wikilinks]] to markdown files, then run gbrain sync and gbrain extract all so the links get indexed.

When should I use index pages versus entity cross-links?

Use index pages for bulk data with no natural relationships, such as thousands of emails or calendar events. Use entity cross-links for meaningful relationships, like linking a person page to the company they work at or a deal to its customer company.