Improvements to site post-proc script

Author: edgararuiz

docs/_extensions/transform-links.lua

@@ -4,12 +4,31 @@
 function Link(el)
   local target = el.target
 
-  -- Only transform if it ends with .md
-  if target:match("%.md$") then
-    -- Transform any .md link to .qmd
-    el.target = target:gsub("%.md$", ".qmd")
-    return el
+  -- Transform .md to .qmd (including anchors)
+  if target:match("%.md") then
+    target = target:gsub("%.md", ".qmd")
   end
 
+  -- Handle cross-skill SKILL references: ../add-xxx/SKILL.qmd -> add-xxx.qmd
+  if target:match("%.%./[^/]+/SKILL%.qmd") then
+    target = target:gsub("%.%./([^/]+)/SKILL%.qmd", "%1.qmd")
+  end
+
+  -- Handle cross-skill reference files from references/ folder:
+  -- ../../add-xxx/references/file.qmd -> file.qmd
+  -- (Keep in same references/ folder, just get the filename)
+  if target:match("%.%./%.%./[^/]+/references/") then
+    target = target:gsub("%.%./%.%./[^/]+/references/([^/]+)", "%1")
+  end
+
+  -- Handle same-skill reference files: add-xxx/references/file.qmd -> references/file.qmd
+  if target:match("^add%-[^/]+/references/") then
+    target = target:gsub("^add%-[^/]+/references/", "references/")
+  end
+
+  -- Remove developers/ prefix
+  target = target:gsub("^developers/", "")
+
+  el.target = target
   return el
 end