The Quick start told Hermes users to copy the workflows as loose .md files
into ~/.hermes/skills/software-development/. Hermes indexes skills by
walking for SKILL.md, so those files were never listed and never loaded.
Reproduced with the real loader (agent.skill_utils.iter_skill_index_files)
against a scratch HERMES_HOME: the documented command indexed 0 of 5
workflows, the loop now documented indexes 5 of 5.
- README.md / README.pt-BR.md: one loop for both agents, with SKILLS_DIR
swapped for Claude Code; install verification hint (hermes skills list).
- README layout tree: five workflows (wf-readme.md was missing), the whole
vendored skills/ tree, and the actual qa/ contents.
- The snapshot provenance claim listed base-364/v2/v3/v4 as if they lived
in qa/snapshots/, but only baseline-final.json is committed; corrected,
and it is now named as the file the gates read.
- Documented that api-security-review is two unrelated skills sharing one
name (OWASP vendored vs apisec-inc external).
- docs/SKILLS.md: the Claude Code block did mkdir -p "~/.claude/..." with
the tilde inside quotes, which creates a literal "~" directory instead of
expanding; replaced with $HOME. Also corrected the claim that only Claude
Code needs a per-skill directory.
Verified: installing from both documented blocks into a scratch HOME yields
15/15 skills indexed and carries the support files along.
Evandro Fonseca Junior
936ceda102