From 56234a34cb2bdb0d0deaed226ee44f068505b0b4 Mon Sep 17 00:00:00 2001 From: panchicore Date: Fri, 24 Jul 2026 14:06:38 -0500 Subject: [PATCH] Refine validmind-docs-coverage skill per issue #1435 Warn that {{< var >}} shortcodes inside headings produce unusable auto-generated ids, and generalize the branch-naming convention from codex/ to author-prefixed branches. Co-Authored-By: Claude Fable 5 --- skills/validmind-docs-coverage/SKILL.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/skills/validmind-docs-coverage/SKILL.md b/skills/validmind-docs-coverage/SKILL.md index 61c46e3e0..e368a669e 100644 --- a/skills/validmind-docs-coverage/SKILL.md +++ b/skills/validmind-docs-coverage/SKILL.md @@ -46,10 +46,11 @@ For a verification-only request, stop after reporting the classification, eviden ## 3. Implement an approved update 1. Confirm the worktree and current branch before editing. -2. Start from current `origin/main` on a `codex/sc--` branch. +2. Start from current `origin/main` on an author-prefixed branch, e.g. `/sc--`. 3. Update the smallest authoritative source. 4. Preserve Quarto variables, `.qmd` cross-references, conditional HTML/RevealJS variants, and existing terminology. -5. If editing an include, find every consumer: +5. Headings that contain `{{< var >}}` shortcodes get unusable auto-generated ids — add an explicit `{#id}` to any heading used as a link target. +6. If editing an include, find every consumer: ```bash rg -n "_source-name\\.qmd" site --glob '*.qmd'