Merge pull request 'fix: keep compatibility template outside flat skill discovery' (#3) from fix/compatibility-template-loader into main

README.md

@@ -14,7 +14,7 @@ VSSA-managed Hermes skill for the complete Docusaurus documentation lifecycle:
 - Gitea: <https://gitea.lego-cloud.eu/vssa-v1-skills-code-agent/documentation-docusaurus>
 - Branch: `main`
 - Runtime package: `documentation-docusaurus-vssa` (complete repository package).
-- Compatibility: install `compatibility/documentation-docusaurus.md` as `documentation-docusaurus/SKILL.md`; old callers still load this VSSA adoption.
+- Compatibility: install `templates/documentation-docusaurus.md` as `documentation-docusaurus/SKILL.md`; old callers still load this VSSA adoption.
 - Generic owner: `documentation-docusaurus-global`, from the distinct `home-v1-skills-code-agent/documentation-docusaurus` repository.
 - Repository URL and all VSSA-specific reference content remain independently maintained.
 

SKILL.md

@@ -29,7 +29,7 @@ compatibility: Designed for Docusaurus v3. Works with Cline, Claude Code, GitHub
 This VSSA-managed skill is maintained in Gitea at
 `https://gitea.lego-cloud.eu/vssa-v1-skills-code-agent/documentation-docusaurus`.
 Treat repository `main` as the source of truth. Install the complete published package under `documentation-docusaurus-vssa`.
-Install `compatibility/documentation-docusaurus.md` as the legacy
+Install `templates/documentation-docusaurus.md` as the legacy
 `documentation-docusaurus/SKILL.md` compatibility route; existing callers keep VSSA behavior.
 Generic guidance instead loads `documentation-docusaurus-global` from
 https://gitea.lego-cloud.eu/home-v1-skills-code-agent/documentation-docusaurus.

scripts/validate_skill.py

@@ -12,7 +12,7 @@ assert len(parts) == 2 and parts[1].strip(), "frontmatter must close and body mu
 frontmatter, body = parts
 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()
+alias = (ROOT / "templates/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