# vssa-clients

Version-controlled Hermes skill for VSSA client, system, cloud, contractor, and procurement research.

## Source of truth

- Gitea: <https://gitea.lego-cloud.eu/vssa-v1-skills-code-agent/vssa-clients>
- Branch: `main`
- Runtime name: `vssa-clients`
- Runtime path: `/opt/data/skills/research/vssa-clients`
- Maintainer worktree: `/opt/data/vssa-clients-skill`

The runtime path is a symbolic link to this checked-out repository. This prevents a local skill copy from drifting away from Gitea.

## Update workflow

1. Fetch and fast-forward `main` before editing.
2. Modify `SKILL.md` or linked files in this repository.
3. Run `python3 scripts/validate_skill.py`.
4. Review `git diff --check` and the complete diff.
5. Commit and push to `main`.
6. Verify local/remote SHA equality and authenticated Gitea readback of `SKILL.md` plus a changed linked file.
7. Verify `skill_view(name="vssa-clients")` and the VSSA cron attachment.

Do not patch a detached runtime-only copy. Client-specific research belongs in the VSSA documentation repository; only reusable investigation procedures belong here.