Claude-skill-registry cross-linking

Guidance for finding and adding bidirectional wikilinks when creating or updating content in the knowledge base. Use when user creates new content or wants to improve discoverability by adding links to related pages. Helps maintain the interconnected graph structure.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/cross-linking" ~/.claude/skills/majiayu000-claude-skill-registry-cross-linking && rm -rf "$T"
manifest: skills/data/cross-linking/SKILL.md
source content

Cross-Linking

Maintain bidirectional links for discoverability and graph navigation.

What to Link

Always Link

Content TypeLink ToExample
PeoplePerson profile
[[Alice Smith]]
not "Alice"
ProjectsProject README
[[AGI-Assistant]]
TasksTask file
[[Integrate-Zep-Memory]]
MeetingsMeeting note
[[2026-01-12 Weekly Sync]]
Tools/TechResearch entry
[[Zep]]
,
[[LangChain]]

On First Mention

Link concepts, tools, and references on their first appearance in a document.

Link Syntax

Basic Wikilink

[[Page Name]]

With Display Text

[[Page-Name|Display Text]]
[[Team/Alice-Smith|Alice]]

With Relative Path

[[../Team/Alice-Smith|Alice Smith]]
[[../../04-Knowledge/AI-Ecosystem/Zep|Zep]]

Finding Related Content

By Topic

Search for related pages in the same category:

  • AI tools →
    04-Knowledge/AI-Ecosystem/
  • Projects →
    03-Projects/
  • Team →
    01-Team/

By Tag

Find pages with similar tags:

#project/agi-assistant
#topic/ai
#team/member

By Existing Links

Check what the page already links to, then find related pages that should also be linked.

Linking Checklist

When creating/editing content:

  1. People mentioned? → Link to profiles in
    01-Team/
  2. Projects referenced? → Link to project READMEs
  3. Tasks discussed? → Link to task files
  4. Tools/tech mentioned? → Link to AI-Ecosystem entries
  5. Related knowledge? → Link to relevant research pages
  6. Meetings referenced? → Link to meeting notes

Bidirectional Linking

Obsidian automatically creates backlinks, but for better navigation:

  1. Link from new page to existing related content
  2. Consider updating related pages to link back (for important connections)

Common Link Targets

Team

  • Link to team member profiles in
    Database/People/

Projects

  • Link to project documentation in
    Projects/
    or
    Database/Projects/

AI Ecosystem Categories

  • [[Agent-Frameworks]]
  • [[LLM-Providers]]
  • [[Developer-Tools]]
  • [[MCP-Ecosystem]]
  • [[Vector-Databases]]

Example

Before:

Alice is working on the authentication integration for our web app project.

After:

[[Alice Smith]] is working on the [[OAuth]] integration for our [[Web App]] project.