af-link-documentation

Establishes bidirectional cross-references and navigation structures in documentation files.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/GainInsightDev/websites --skill af-link-documentation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: af-link-documentation
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-link-documentation
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-link-documentation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of disconnected or orphaned documentation by establishing robust bidirectional links and navigation structures.

Core Features & Use Cases

  • Bidirectional Linking: Automatically creates and maintains links between related documentation files, ensuring that changes in one place are reflected in others.
  • Orphaned Document Resolution: Identifies and links documentation that is not currently connected to the main knowledge base.
  • Navigation Structure Creation: Helps build intuitive navigation hierarchies for large documentation sets.
  • Use Case: When updating a feature's documentation, this skill ensures that all related guides, API references, and tutorials are correctly linked to the updated section, and vice-versa.

Quick Start

Use the af-link-documentation skill to establish bidirectional links for all markdown files within the current directory.

Frequently Asked Questions about af-link-documentation

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

FAQPage Schema
How do I create bidirectional links for documentation?

Bidirectional links for documentation connect related files automatically, ensuring that navigation updates in one markdown file reflect in its references. This establishes a connected knowledge graph across your directories.

What is the best way to fix orphaned documents in a knowledge base?

To fix orphaned documents in a knowledge base, you can identify unconnected markdown files and generate cross-references that bind them to your main structure. This resolution process ensures all content is reachable.

How do I build navigation structures across multiple documentation directories?

Building navigation structures across multiple documentation directories requires establishing cross-references that connect separate markdown files. This creates an intuitive hierarchy and enforces allowed root documents for structured navigation.

Can I enforce allowed root documents for structured documentation?

Yes, you can enforce allowed root documents to maintain a structured documentation system. This prevents fragmented files by designating specific entry points and automatically linking orphaned documents back to these roots.

Does bidirectional linking work automatically when updating markdown files?

Yes, bidirectional linking works automatically when updating markdown files. It maintains links between related documentation files, ensuring that changes in one place are instantly reflected across all connected guides and references.

Why are broken links appearing in my documentation hierarchy?

Broken links appear in a documentation hierarchy when files become orphaned or moved without updating references. You resolve this by establishing robust bidirectional links that maintain structural connections across directories automatically.