feat: merge Docusaurus and Gitea documentation skills

README.md

@@ -1,3 +1,28 @@
 # documentation-docusaurus
 
-VSSA-managed Docusaurus documentation skill with Gitea delivery capabilities
+VSSA-managed Hermes skill for the complete Docusaurus documentation lifecycle:
+
+- Diátaxis information architecture and writing quality;
+- Docusaurus v3 configuration, MDX, React Flow and Draw.io;
+- evidence registries, generated dossiers and source-to-derived cross-linking;
+- Gitea organization/repository setup and safe Git delivery;
+- self-hosted Gitea Actions and LEGO Cloud Pages publication;
+- build, browser, exact-SHA CI, authenticated readback and deployment verification.
+
+## Authoritative location
+
+- Gitea: <https://gitea.lego-cloud.eu/vssa-v1-skills-code-agent/documentation-docusaurus>
+- Branch: `main`
+- Maintainer worktree: `/opt/data/documentation-docusaurus-skill`
+- Runtime installation: `/opt/data/skills/productivity/documentation-docusaurus` → maintainer worktree
+
+## Validate
+
+```bash
+python3 scripts/validate_skill.py
+git diff --check
+```
+
+## Maintenance
+
+Fetch and fast-forward before editing. Commit reusable changes to this repository, push them, verify exact ref equality, read back the changed artifact through the authenticated Gitea API, require the exact-SHA Actions task to succeed, and verify runtime loading. Other project skill repositories are read-only comparison sources unless their owners explicitly request changes.