link

name	link
description	Propose verified wikilinks and MOCs as a draft for founder review. Scans wiki + recent daily logs, validates every link target, never auto-edits existing articles. Trigger when the user asks to link the wiki, add wikilinks, build MOCs, strengthen the graph, or uses "/link".
metadata	{"short-description":"Verified wikilink + MOC proposals (draft for approval)"}

link

Run a semantic linking pass over the wiki. Strengthen the knowledge graph with verified [[wikilinks]] and propose Maps of Content (MOCs) for thematic clusters — without hallucinating links.

This skill never modifies existing wiki articles directly. It writes a draft to wiki/link-pass-{YYYY-MM-DD}.md. Only after the founder approves do you apply the changes.

When to run

Suggest this when:

• Cross-links are sparse despite a growing wiki
• New articles lack bidirectional linking
• A thematic cluster needs a MOC
• /reflect surfaces orphan or weakly connected articles

If the wiki has fewer than 2 articles, decline gracefully.

Quick path (script)

uv run python scripts/link_pass.py

The script scans wiki/concepts/, wiki/connections/, wiki/qa/, recent daily/ logs, and wiki/index.md to build the verified title index. It proposes add-link, new-MOC, and backlink-fix sections. Unverified targets are skipped.

Agent path (deeper pass)

1. Read wiki/index.md, wiki/log.md, all wiki articles, recent daily/
2. Build verified title index from files + index
3. Propose links only to real articles; detect tag clusters for MOCs
4. Merge with script output into wiki/link-pass-{date}.md

For 30+ articles, use wiki_reader sub-agents with file paths only — see consolidate skill for the spawn pattern.

Draft format

# Link Pass Draft — YYYY-MM-DD

> Generated by link. Not yet applied.

## Summary
- N add-link proposals
- N new-MOC proposals
- N backlink-fix proposals

## Add-link proposals
...

## New-MOC proposals
...

## Backlink-fix proposals
...

MOC proposals use wiki/mocs/_TEMPLATE.md (frontmatter type: moc, curated [[links]] grouped by sub-theme, one-line purpose).

After writing the draft

Tell the founder where the draft lives, give a 1-line gist, and ask which proposals to apply. Do not apply until they confirm.

Applying approved changes

1. Add approved links to source articles
2. Create approved MOCs under wiki/mocs/
3. Add approved backlinks
4. Update wiki/index.md and wiki/log.md
5. Archive the draft to wiki/link-pass-archive/{date}.md

Constraints

• Never auto-apply
• Never hallucinate links — verify every target
• Don't edit daily/ or imports/
• One pass per session

Trigger examples

• "link the wiki"
• "add wikilinks"
• "build MOCs for my strategy articles"
• "strengthen the wiki graph"
• "/link"