add-doc-anchor-ids

name	add-doc-anchor-ids
description	Align Rspress heading anchor IDs between English and Chinese docs. Use for MDX `\{#...}` anchors, shortened hashes, redundant anchors, or dead links.

Add Doc Anchor IDs

Use this skill for Rspress docs mirrored under website/docs/en and website/docs/zh.

Rules

• Treat the English document as the source for stable anchor IDs.
• If an English heading has 4 words or fewer, use the default Rspress anchor generated from the English heading.
• If an English heading has more than 4 words, choose a shorter semantic anchor ID and add that same custom ID to both English and Chinese headings.
• Do not add custom IDs that match Rspress default output. For example, keep ### parallel, not ### parallel \{#parallel}.
• In Chinese docs, add a custom ID only when the Chinese default anchor would differ from the desired English ID.
• In Chinese docs, remove custom IDs from pure English headings when the custom ID equals the Rspress default.
• MDX custom anchor syntax must be escaped: \{#anchor-id}.
• Keep changes limited to .md/.mdx documentation files unless the user explicitly asks otherwise.
• Do not add persistent validation or update scripts as part of this skill's work.

Workflow

1. Inspect the current branch and work tree before editing:

   git branch --show-current
   git status --short
   

2. Find relevant custom anchors and hash links:

   rg -n -F '\{#' website/docs/en website/docs/zh --glob '*.mdx'
   rg -n "\]\([^)]*#[A-Za-z0-9_-]+[^)]*\)" website/docs/en website/docs/zh --glob 
   rg -n  website/docs/en website/docs/zh --glob