af-linking-docs

Establish bidirectional links between documentation files and resolve broken references.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps maintain a robust and interconnected documentation system by ensuring all documents are properly linked, resolving broken references, and identifying orphaned files.

Core Features & Use Cases

  • Bidirectional Linking: Establishes two-way links between related documentation pages.
  • Orphaned Document Resolution: Identifies and helps reintegrate documents that are not linked from anywhere else.
  • Broken Reference Fixing: Corrects invalid cross-references within the documentation.
  • Use Case: When adding new feature documentation, use this Skill to ensure it's correctly linked from the main documentation tree and that all its internal references are valid.

Quick Start

Use the af-linking-docs skill to fix broken links in the documentation.

Frequently Asked Questions about af-linking-docs

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

FAQPage Schema
How do I fix broken cross-references in my documentation tree?

Fix broken cross-references by applying defined linking patterns to correct invalid connections within the documentation structure. This ensures referential integrity across parent-child relationships and maintains a robust, interconnected documentation system.

What is the best way to find and resolve orphaned documents in a knowledge base?

Resolve orphaned documents by identifying files not linked from anywhere else and reintegrating them into the main documentation tree. This maintains referential integrity by ensuring all documents are properly connected.

How does bidirectional linking work for managing complex documentation?

Bidirectional linking establishes two-way connections between related documentation pages, ensuring that references point correctly in both directions. This requires adherence to defined linking patterns and parent-child relationships within the structure.

Do I need predefined linking patterns to maintain referential integrity across files?

Yes, maintaining referential integrity requires predefined linking patterns and parent-child relationships. These rules guide how bidirectional links are established and how broken cross-references are resolved within complex documentation trees.

When should I use an automated tool to connect documentation files?

Use an automated tool to connect documentation files when adding new features to a complex tree, ensuring correct linkage from the main structure and validating internal references to prevent orphaned documents and broken links.