add shared brain vault skill

2026-06-30 05:24:13 +02:00
parent 82e39d8908
commit cd36a91440
4 changed files with 443 additions and 0 deletions
@@ -0,0 +1,69 @@
+# Agent-Hub Skill Deployment Notes
+
+Use when making the Shared Brain Vault workflow available to cross-agent tools through the AGENTS/agent-hub repository.
+
+## Target layout
+
+Copy the complete skill directory, not only `SKILL.md`:
+
+```text
+/var/lib/hermes/workspace/agent-hub/.agents/skills/shared-brain-vault/
+  SKILL.md
+  references/
+  scripts/
+```
+
+Source of the active Hermes-installed skill is usually:
+
+```text
+/var/lib/hermes/.hermes/skills/knowledge-management/shared-brain-vault/
+```
+
+## Safe deployment sequence
+
+```bash
+cd /var/lib/hermes/workspace/agent-hub
+mkdir -p .agents/skills/shared-brain-vault
+cp -a /var/lib/hermes/.hermes/skills/knowledge-management/shared-brain-vault/. \
+  .agents/skills/shared-brain-vault/
+chmod +x .agents/skills/shared-brain-vault/scripts/*.py 2>/dev/null || true
+```
+
+Then stage only the shared-brain skill files so unrelated dirty Agent-Hub work is not mixed into the commit:
+
+```bash
+git add .agents/skills/shared-brain-vault
+git diff --cached --stat
+git diff --cached --name-status
+git commit -m "add shared brain vault skill"
+```
+
+## Verification
+
+Run the vault link audit against the actual vault path:
+
+```bash
+python3 .agents/skills/shared-brain-vault/scripts/audit-wikilinks.py /var/lib/hermes/m3ta-brain
+```
+
+If Agent-Hub has its repo check script, run it too:
+
+```bash
+./scripts/check-agent-hub.sh
+```
+
+Before claiming success, confirm the committed files and current status:
+
+```bash
+git status --short
+git log -1 --oneline
+```
+
+If `git remote -v` prints nothing, do not claim a push happened; report that the local commit exists and that no remote is configured.
+
+## Pitfalls
+
+- Do not assume a skill installed in `~/.hermes/skills/` is present in Agent-Hub. Check `.agents/skills/<name>/` separately.
+- Do not copy only `SKILL.md`; supporting `references/` and `scripts/` carry reusable detail and verification helpers.
+- Do not mix pre-existing Agent-Hub changes into the skill commit. Stage the skill path explicitly.
+- Keep the active Hermes-installed copy and Agent-Hub copy in sync when patching durable workflow guidance.