# Af Linking Docs

> Set up bidirectional links between documentation files, resolve orphaned documents, or fix broken cross-references. Use when linking new docs into the documentation tree or fixing link validation errors.

- Skill: `majiayu000/af-linking-docs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/af-linking-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/af-linking-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/af-linking-docs

---


# Document Linking

## What to read

**Parent-child relationships and bidirectional linking:**
→ [documentation-system.md#parent-child-relationships](../../docs/guides/documentation-system.md#parent-child-relationships)

**Edge cases (circular references, multiple parents, orphans):**
→ [documentation-system.md#edge-cases-and-advanced-patterns](../../docs/guides/documentation-system.md#edge-cases-and-advanced-patterns)

**Cross-directory linking patterns:**
→ [documentation-system.md#cross-directory-linking](../../docs/guides/documentation-system.md#cross-directory-linking)

**Allowed root documents:**
→ [documentation-system.md#allowed-root-documents](../../docs/guides/documentation-system.md#allowed-root-documents)