fix: qualify Delivery sources and preserve compatibility

scripts/validate_skill.py

@@ -10,8 +10,12 @@ assert text.startswith("---\n"), "SKILL.md must start with YAML frontmatter"
 parts = text.split("\n---\n", 1)
 assert len(parts) == 2 and parts[1].strip(), "frontmatter must close and body must be non-empty"
 frontmatter, body = parts
-assert re.search(r"^name:\s*documentation-docusaurus\s*$", frontmatter, re.M), "wrong skill name"
+assert re.search(r"^name:\s*documentation-docusaurus-vssa\s*$", frontmatter, re.M), "wrong skill name"
 assert "description:" in frontmatter, "missing description"
+alias = (ROOT / "compatibility/documentation-docusaurus.md").read_text()
+assert "name: documentation-docusaurus\n" in alias
+assert "Load `documentation-docusaurus-vssa`" in alias
+assert "documentation-docusaurus-global" in alias
 assert len(text) <= 100_000, "SKILL.md exceeds Hermes size limit"
 assert "## Authoritative repository" in body
 assert "## Gitea delivery gate" in body
@@ -47,6 +51,6 @@ unreferenced = sorted(name for name in reference_names if name not in coverage_t
 assert not unreferenced, f"unreferenced support files: {unreferenced}"
 
 print(
-    f"OK skill=documentation-docusaurus chars={len(text)} "
+    f"OK skill=documentation-docusaurus-vssa chars={len(text)} "
     f"references={len(reference_names)} markdown_files={len(markdown_files)}"
 )